> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycontinuum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool reference

> All 52 tools the Continuum connector lists, and the 20 more it accepts by name: what each does, whether it changes anything, and where its full contract lives.

You don't need to know tool names to use Continuum. Your assistant picks them for you. This page is for admins reviewing what a connector can do and for anyone building with an agent.

The server registers **72 tools**. Your assistant's tool list (`tools/list`) shows up to **52** of them: the ones your [role](https://docs.trycontinuum.ai/settings/roles.md) and connected platforms allow. The other **20** are writes and helpers reached through the listed tools; they stay callable by name. `help_describe` with no arguments returns all 72.

> [!NOTE]
>
> Tools marked **Changes things** can modify your brand. The ones that publish, change your ads, produce final Forge versions, or delete something show a preview and wait for your yes. See [You stay in control](https://docs.trycontinuum.ai/mcp/control.md).

## For agents

* **Index:** [`/mcp/tools.json`](https://docs.trycontinuum.ai/mcp/tools.json) lists every registered tool with its role, connection, confirmation, completion, retry behavior, actions with required and optional inputs, an example call, and its errors. Generated from the server's own tool registry, as released on 2026-11-05.
* **Live schema:** call `help_describe {"tool": "<name>", "action": "<action>"}` before the first call to a tool. If it disagrees with these pages, follow the server.
* **Forge:** the [operation index](https://docs.trycontinuum.ai/forge/agent-manifest.json) and [function reference](https://docs.trycontinuum.ai/forge/functions.md) carry per-action contracts for `forge_query` and `forge_manage`.
* **How to behave:** read the [agent brief](https://docs.trycontinuum.ai/mcp/agent-brief.md) and the [server reference](https://docs.trycontinuum.ai/mcp/reference.md) for sign-in, brand scope, confirmations, statuses, and limits.

## Account, brand, and jobs

Full contracts: [Account and brand tools](https://docs.trycontinuum.ai/mcp/tools/account.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`brands_list`](https://docs.trycontinuum.ai/mcp/tools/account#brands_list) | Lists the brands you can access. | No |
| [`brands_select`](https://docs.trycontinuum.ai/mcp/tools/account#brands_select) | Sets the brand the conversation works on, tries to save it as your default for future sessions, and lists its published pipelines. Pass `null` to clear this session only. | Yes |
| [`brands_create`](https://docs.trycontinuum.ai/mcp/tools/account#brands_create) | Starts a new brand. You finish setting it up in the Continuum app. | Yes |
| [`account_map`](https://docs.trycontinuum.ai/mcp/tools/account#account_map) | Shows connected platforms and accounts, ad accounts, and your role. | No |
| [`accounts_list`](https://docs.trycontinuum.ai/mcp/tools/account#accounts_list) | Lists the accounts assigned to the brand. | No |
| [`integrations_list`](https://docs.trycontinuum.ai/mcp/tools/account#integrations_list) | Lists the brand's connections. | No |
| [`integrations_connect`](https://docs.trycontinuum.ai/mcp/tools/account#integrations_connect) | Returns a one-time link to connect a platform. Links work for 10 minutes. | No |
| [`integration_health_check`](https://docs.trycontinuum.ai/mcp/tools/account#integration_health_check) | Checks whether a connection is healthy, expired, or disconnected. | No |
| [`brand_knowledge`](https://docs.trycontinuum.ai/mcp/tools/account#brand_knowledge) | Reads and searches your brand book and knowledge base, checks copy against your voice, and adds, updates, or archives source material. | Yes |
| [`agent_ask`](https://docs.trycontinuum.ai/mcp/tools/account#agent_ask) | Asks [Jaina](https://docs.trycontinuum.ai/performance/jaina.md) or the [Organic agent](https://docs.trycontinuum.ai/organic/agent.md) a question. Runs as a job. | Yes |
| [`jobs_status`](https://docs.trycontinuum.ai/mcp/tools/account#jobs_status) | Checks on a long-running job. | No |
| [`help_describe`](https://docs.trycontinuum.ai/mcp/tools/account#help_describe) | Describes any registered tool and its actions: the full input schema, examples, and common errors. | No |

## Analytics, trends, and competitors

Full contracts: [Analytics and intel tools](https://docs.trycontinuum.ai/mcp/tools/insights.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`analytics_query`](https://docs.trycontinuum.ai/mcp/tools/insights#analytics_query) | Organic, paid, and website results by platform: accounts, top posts, campaigns, ad sets, and ads. | No |
| [`analytics_creative_insights`](https://docs.trycontinuum.ai/mcp/tools/insights#analytics_creative_insights) | Ranks your Meta ad creatives by video retention: hook rate and hold rate. | No |
| [`analytics_cross_platform_spend`](https://docs.trycontinuum.ai/mcp/tools/insights#analytics_cross_platform_spend) | Spend, conversions, cost per acquisition, and return on ad spend across your connected ad platforms. | No |
| [`analytics_pacing_diagnostic`](https://docs.trycontinuum.ai/mcp/tools/insights#analytics_pacing_diagnostic) | Which Meta campaigns are pacing ahead of or behind budget, with a 0–100 health score. | No |
| [`audience_query`](https://docs.trycontinuum.ai/mcp/tools/insights#audience_query) | Your Meta audiences, ad set targeting, and demographic and placement breakdowns. | No |
| [`creative_strategy`](https://docs.trycontinuum.ai/mcp/tools/insights#creative_strategy) | What works for you: opening-line (hook) scoring, win rates, and competitive gaps. | No |
| [`trends_manage`](https://docs.trycontinuum.ai/mcp/tools/insights#trends_manage) | Your brand's trends report. | No |
| [`intel_trend_discovery`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_trend_discovery) | The hashtags people post under on Instagram or TikTok, with post counts and growth, plus trending search keywords on TikTok. | No |
| [`intel_competitor_moves`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_competitor_moves) | A digest of what your tracked competitors run in paid ads and post organically, by angle, hook, call to action, and format. | No |
| [`intel_competitor_ads`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_competitor_ads) | Ads from competitors you track, including how long each has run. | No |
| [`intel_competitor_organic`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_competitor_organic) | Organic posts from competitors you track. | No |
| [`intel_competitor_ad_library`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_competitor_ad_library) | Looks up any advertiser in the Meta Ad Library. | No |
| [`intel_competitor_scan`](https://docs.trycontinuum.ai/mcp/tools/insights#intel_competitor_scan) | Runs a fresh competitor scan, the same as the app's **Scan** button. | Yes |

## Organic+ planning and publishing

Full contracts: [Organic+ tools](https://docs.trycontinuum.ai/mcp/tools/organic.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`planner_manage`](https://docs.trycontinuum.ai/mcp/tools/organic#planner_manage) | Reads and proposes a week of posts, approves it, reschedules and copies posts, and attaches media. | Yes |
| [`content_create`](https://docs.trycontinuum.ai/mcp/tools/organic#content_create) | Drafts, approves, and publishes posts, and deletes drafts. | Yes |
| [`organic_draft_list`](https://docs.trycontinuum.ai/mcp/tools/organic#organic_draft_list) | Lists drafts on the calendar. | No |
| [`organic_draft_get`](https://docs.trycontinuum.ai/mcp/tools/organic#organic_draft_get) | Reads one draft. | No |
| [`content_reference`](https://docs.trycontinuum.ai/mcp/tools/organic#content_reference) | Remakes a public Instagram post or reel as your brand's own: its structure, never its words. | Yes |
| [`headless_content`](https://docs.trycontinuum.ai/mcp/tools/organic#headless_content) | Makes vertical reels, stills, and carousels from your brand guide without opening the canvas. | Yes |

## Performance+ ads and optimization

Full contracts: [Performance+ tools](https://docs.trycontinuum.ai/mcp/tools/paid.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`paid_manage`](https://docs.trycontinuum.ai/mcp/tools/paid#paid_manage) | Reads your campaign structure; creates paused campaigns, ad sets, and ads; updates or pauses them; builds audiences and lookalikes; and keeps an audit log of every write. | Yes |
| [`paid_naming_schema_get`](https://docs.trycontinuum.ai/mcp/tools/paid#paid_naming_schema_get) | Your brand's campaign naming convention. | No |
| [`optimizer_query`](https://docs.trycontinuum.ai/mcp/tools/paid#optimizer_query) | Portfolios, pending recommendations, performance, and the optimization log. | No |
| [`optimizer_manage`](https://docs.trycontinuum.ai/mcp/tools/paid#optimizer_manage) | Approves or rejects recommendations and manages portfolios. | Yes |

## Creative+ canvas, pipelines, and delivery

Full contracts: [Creative+ canvas tools](https://docs.trycontinuum.ai/mcp/tools/creative.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`studio_workflow`](https://docs.trycontinuum.ai/mcp/tools/creative#studio_workflow) | Builds, edits, runs, saves, and lists canvas workflows. | Yes |
| [`studio_deliver`](https://docs.trycontinuum.ai/mcp/tools/creative#studio_deliver) | Previews and sends finished creative to a planned post, an organic publish, or a live ad, and restores a swapped ad. | Yes |
| [`pipeline_search`](https://docs.trycontinuum.ai/mcp/tools/creative#pipeline_search) | Finds your team's saved pipelines. | No |
| [`pipeline_describe`](https://docs.trycontinuum.ai/mcp/tools/creative#pipeline_describe) | Shows what a pipeline needs. | No |
| [`pipeline_invoke`](https://docs.trycontinuum.ai/mcp/tools/creative#pipeline_invoke) | Runs a pipeline, up to 10 versions per request. | Yes |
| [`pipeline_run_status`](https://docs.trycontinuum.ai/mcp/tools/creative#pipeline_run_status) | Checks a pipeline run. | No |
| [`list_elements`](https://docs.trycontinuum.ai/mcp/tools/creative#list_elements) | Lists your saved Elements. | No |

## Library, media, and video

Full contracts: [Library and video tools](https://docs.trycontinuum.ai/mcp/tools/library.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`library_manage`](https://docs.trycontinuum.ai/mcp/tools/library#library_manage) | Browses the Library, shows where a creative has run, adds comments, sets review status, and uploads media. | Yes |
| [`media_search`](https://docs.trycontinuum.ai/mcp/tools/library#media_search) | Finds media by describing it. | No |
| [`media_upload_and_clip`](https://docs.trycontinuum.ai/mcp/tools/library#media_upload_and_clip) | Uploads a video to clip. Clipping finishes in the Continuum app. | Yes |
| [`media_capture_url`](https://docs.trycontinuum.ai/mcp/tools/library#media_capture_url) | Turns a public web page into a screenshot or a scroll-through video in your Library. | Yes |
| [`unsplash_search`](https://docs.trycontinuum.ai/mcp/tools/library#unsplash_search) | Searches Unsplash stock photos to use as references. | No |
| [`video_editor`](https://docs.trycontinuum.ai/mcp/tools/library#video_editor) | Edits video in Video Studio: cut silences, cut to the beat, captions, text, music, formats, export, and undo. | Yes |

## Forge templates and CAD files

Full contracts: [Forge and CAD tools](https://docs.trycontinuum.ai/mcp/tools/forge.md).

| Tool | What it does | Changes things |
| - | - | - |
| [`forge_query`](https://docs.trycontinuum.ai/mcp/tools/forge#forge_query) | Lists Forge templates, sets, and render jobs. Full contracts: [Forge functions](https://docs.trycontinuum.ai/forge/functions.md). | No |
| [`forge_manage`](https://docs.trycontinuum.ai/mcp/tools/forge#forge_manage) | Writes versions into a template, previews them, and produces final renders. Full contracts: [Forge functions](https://docs.trycontinuum.ai/forge/functions.md). | Yes |
| [`cad_query`](https://docs.trycontinuum.ai/mcp/tools/forge#cad_query) | Reads CAD mesh capabilities, files, revisions, and jobs. | No |
| [`cad_manage`](https://docs.trycontinuum.ai/mcp/tools/forge#cad_manage) | Uploads STL, DXF, or 3MF files, then transforms, renders, validates, or exports them. | Yes |

## Not in the tool list

These are registered and callable by name, but `tools/list` doesn't advertise them: most are writes and helpers the listed tools reach for you. Use the listed tool unless a result or a tool description names one of these. Their full schemas come from `help_describe`.

| Tool | What the server says it does | Changes things |
| - | - | - |
| [`agent_cancel`](https://docs.trycontinuum.ai/mcp/tools/unlisted#agent_cancel) | Cancel a running Mode A job by jobId. Aborts the in-process AbortController and, for organic jobs, sends a best-effort HTTP cancel to the agent. | Yes |
| [`brand_context_get`](https://docs.trycontinuum.ai/mcp/tools/unlisted#brand_context_get) | Read the active brand's voice, mission/vision, negative keywords, primary URLs, and taxonomy tags. | No |
| [`brand_profile_get`](https://docs.trycontinuum.ai/mcp/tools/unlisted#brand_profile_get) | Read the active brand's structured profile sections: voice, pmf (product-market fit), audience, and persona. Use section='all' to retrieve everything or specify a single section. … | No |
| [`brand_voice_validate`](https://docs.trycontinuum.ai/mcp/tools/unlisted#brand_voice_validate) | Brand voice rule checker. Validates copy against the brand's banned words (the brand DNA's one list, including brand.md edits), any configured `voice_rules` (required disclosures, e… | No |
| [`insights_get`](https://docs.trycontinuum.ai/mcp/tools/unlisted#insights_get) | Fetch Jaina-generated insights for an account, posts, or campaign with cache-first reads. | No |
| [`intel_audience_push`](https://docs.trycontinuum.ai/mcp/tools/unlisted#intel_audience_push) | Push a list of people (emails/phones/names, hashed server-side) to a Meta customer-list Custom Audience — new or appended. Two-phase: mode='preview' (default) → `confirm_token`; mod… | Yes |
| [`jaina_ask`](https://docs.trycontinuum.ai/mcp/tools/unlisted#jaina_ask) | Ask Jaina (regular analyst) a performance/paid-analytics question — ROAS, spend, campaign or ad set/ad performance, pacing, attribution, reporting. Use when the question is about … | Yes |
| [`jaina_pro_run`](https://docs.trycontinuum.ai/mcp/tools/unlisted#jaina_pro_run) | Run a Jaina Pro long-form report. Returns immediately with `{ job_id, poll_with }` — poll `jobs_status` for the report (or consume progress frames). | Yes |
| [`mcp_approval_grant`](https://docs.trycontinuum.ai/mcp/tools/unlisted#mcp_approval_grant) | Grant admin approval for a pending confirm token. The token must have requires.role = 'admin'. After granting, the token's approvals array is updated and the originating tool can … | Yes |
| [`mcp_approvals_list`](https://docs.trycontinuum.ai/mcp/tools/unlisted#mcp_approvals_list) | List all pending confirm tokens for the current brand that require admin approval. Returns only tokens where requires.role = 'admin'. Admin-only. | No |
| [`organic_ask`](https://docs.trycontinuum.ai/mcp/tools/unlisted#organic_ask) | Ask the organic social agent a free-form question about social strategy, captions, hashtags, content ideas, or organic post/account performance. Use when the question is about wha… | Yes |
| [`organic_inbox_list`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#organic_inbox_list) | List unified inbox items (DMs, comments, mentions) for a connected Instagram account (cache-first, 30s TTL). **Not available yet:** it returns `NOT_IMPLEMENTED`. | No |
| [`organic_inbox_reply`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#organic_inbox_reply) | Reply to an inbox item (DM, comment, or mention) on Instagram. **Not available yet:** it returns `NOT_IMPLEMENTED`. | Yes |
| [`organic_media_list`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#organic_media_list) | List recent organic media for a connected account (cache-first, 5-minute TTL). | No |
| [`organic_profile_get`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#organic_profile_get) | Fetch the public profile (handle, follower count, picture, bio) for a connected organic account. | No |
| [`organic_workflow_run`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#organic_workflow_run) | Plan and schedule a week of organic content end-to-end in one call. mode='`plan_week`' starts a run; mode='resume' continues past an approval gate (pass the `next_step.arguments` the … | Yes |
| [`paid_naming_schema_set`](https://docs.trycontinuum.ai/mcp/tools/unlisted#paid_naming_schema_set) | Configure the active brand's ad-naming convention for a platform: a delimiter (e.g. '\|') plus an ordered list of field labels (e.g. \['funnel', 'format', 'audience']). Once set, ad… | Yes |
| [`post_audit`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#post_audit) | Audit a draft or published post for brand voice, hashtags, accessibility, and platform fit. | No |
| [`post_create_instagram`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#post_create_instagram) | Publish an Instagram image, carousel, or reel. Call with mode='preview' first to validate and get a `confirm_token`, then mode='publish' with the token to execute. | Yes |
| [`post_manage`](https://docs.trycontinuum.ai/mcp/tools/unlisted-posts#post_manage) | Manage an existing post: unschedule, reschedule, edit caption, or delete. Use `preview_delete` first for published posts to get a `confirm_token` before deleting. | Yes |

## Ready-made prompts

The connector also offers three prompts your assistant may list in its menu:

| Prompt | What it does |
| - | - |
| `analytics-weekly-review` | A weekly review across social and ads. |
| `analytics-top-and-bottom-posts` | Your best and worst organic posts, and why. |
| `analytics-top-and-bottom-ads` | Your best and worst ads, and why. |

## What's next

* [Agent brief](https://docs.trycontinuum.ai/mcp/agent-brief.md): How an assistant should use these tools.
* [Server reference](https://docs.trycontinuum.ai/mcp/reference.md): Endpoints, sign-in, confirmations, result codes, and limits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.