Unlisted tools: agents, brand, and approvals

Generated from the server’s own tool registry, as released on 2026-11-05. These tools 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, and fetch the live schema with help_describe first.

Tool	What it does	Changes things
`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
`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`	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
`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
`insights_get`	Fetch Jaina-generated insights for an account, posts, or campaign with cache-first reads.	No
`brand_context_get`	Read the active brand’s voice, mission/vision, negative keywords, primary URLs, and taxonomy tags.	No
`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`	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
`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
`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
`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
`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

`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.

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: repeating the call gives the same result.

Inputs:

Input	Type	Required	About
`jobId`	string	Yes	A job ID an earlier call returned.

Examples (IDs are illustrative; use the ones earlier calls return): Cancel a running agent job:

{
  "name": "agent_cancel",
  "arguments": {
    "jobId": "job_8f2c41d7"
  }
}

Errors and statuses:

Code	When
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: agent_ask, jobs_status. Full schema: help_describe {"tool":"agent_cancel"}. As JSON: /mcp/schemas/agent_cancel.json.

`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 …

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns a `job_id`. Read the result with `jobs_status`.
Retry	Not idempotent. Check the current state before retrying.
Rate limit	60 calls per 1 hour per brand. See Limits.

Inputs:

Input	Type	Required	About
`query`	string	Yes	What to look for, in plain words.
`sessionId`	string	No	An earlier agent conversation’s `sessionId`, to continue it instead of starting over.
`context`	object	No	—

Examples (IDs are illustrative; use the ones earlier calls return): Ask Jaina directly:

{
  "name": "jaina_ask",
  "arguments": {
    "query": "Which ad sets spent the most last week without a purchase?"
  }
}

Errors and statuses:

Code	When
`CTX_MISSING_MODE_A_FIELDS`	The call is missing session context. Reconnect the assistant and retry.
`JOB_ENQUEUE_FAILED`	The job couldn’t start. Retry once, then contact support.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.
`RATE_LIMITED`	Wait `details.retry_after_seconds`, then retry.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: agent_ask, jobs_status, organic_ask. Full schema: help_describe {"tool":"jaina_ask"}. As JSON: /mcp/schemas/jaina_ask.json.

`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).

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand. Connection: Meta (Facebook).
Confirmation	None. The call runs when made.
Completion	Returns a `job_id`. Read the result with `jobs_status`.
Retry	Not idempotent. Check the current state before retrying.
Rate limit	5 calls per 1 hour per brand. See Limits.

Inputs:

Input	Type	Required	About
`reportSpec`	object	Yes	—

Examples (IDs are illustrative; use the ones earlier calls return): A monthly campaign report:

{
  "name": "jaina_pro_run",
  "arguments": {
    "reportSpec": {
      "period": {
        "start": "2026-10-01",
        "end": "2026-10-31"
      },
      "scopes": [
        "campaign"
      ],
      "kpis": [
        "spend",
        "roas",
        "cpa"
      ],
      "format": "mixed"
    }
  }
}

Errors and statuses:

Code	When
`CTX_MISSING_MODE_A_FIELDS`	The call is missing session context. Reconnect the assistant and retry.
`JOB_ENQUEUE_FAILED`	The job couldn’t start. Retry once, then contact support.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.
`needs_integration`	The brand has no facebook connection. Call `integrations_connect`.
`RATE_LIMITED`	Wait `details.retry_after_seconds`, then retry.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: jobs_status. Full schema: help_describe {"tool":"jaina_pro_run"}. As JSON: /mcp/schemas/jaina_pro_run.json.

`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…

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns a `job_id`. Read the result with `jobs_status`.
Retry	Not idempotent. Check the current state before retrying.

Inputs:

Input	Type	Required	About
`query`	string	Yes	What to look for, in plain words.
`sessionId`	string	No	An earlier agent conversation’s `sessionId`, to continue it instead of starting over.

Examples (IDs are illustrative; use the ones earlier calls return): Ask the Organic agent directly:

{
  "name": "organic_ask",
  "arguments": {
    "query": "Which hooks worked best on our Reels this month?"
  }
}

Errors and statuses:

Code	When
`CTX_MISSING_MODE_A_FIELDS`	The call is missing session context. Reconnect the assistant and retry.
`JOB_ENQUEUE_FAILED`	The job couldn’t start. Retry once, then contact support.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: agent_ask, jaina_ask, jobs_status. Full schema: help_describe {"tool":"organic_ask"}. As JSON: /mcp/schemas/organic_ask.json.

`insights_get`

Fetch Jaina-generated insights for an account, posts, or campaign with cache-first reads.

Contract	Behavior
Changes things	No
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Any brand member
Needs	An active brand. Connection: Instagram.
Confirmation	None. The call runs when made.
Completion	Returns right away. Longer work continues as a job; read the id in the result.
Retry	Safe to retry: it only reads.

Actions (scope):

scope	Required inputs
`account`	`account_id`, `scope`
`posts`	`account_id`, `scope`, `target_ids`
`campaign`	`account_id`, `scope`, `target_ids`

Other inputs, shared by every action (the live schema says which each action reads): account_id, target_ids, period, insight_types, refresh. Examples (IDs are illustrative; use the ones earlier calls return): Insights for one campaign:

{
  "name": "insights_get",
  "arguments": {
    "account_id": "5c8e1a3b-7d2f-4e6a-9b4c-0f1e3d5a7c92",
    "scope": "campaign",
    "target_ids": [
      "120200000000000000"
    ]
  }
}

Errors and statuses:

Code	When
`UPSTREAM_ERROR`	Jaina returned a non-2xx response or empty payload.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_integration`	The brand has no instagram connection. Call `integrations_connect`.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: post_audit. Full schema: help_describe {"tool":"insights_get","action":"account"}. help_describe’s action takes a scope value. As JSON: /mcp/schemas/insights_get.json.

`brand_context_get`

Read the active brand’s voice, mission/vision, negative keywords, primary URLs, and taxonomy tags.

Contract	Behavior
Changes things	No
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Viewer or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: it only reads.

Inputs: none. Examples (IDs are illustrative; use the ones earlier calls return): Read brand voice + tags:

{
  "name": "brand_context_get",
  "arguments": {}
}

Errors and statuses:

Code	When
`BRAND_NOT_READY`	Brand profile row missing.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`INTERNAL`	Something went wrong on our side. Retry once, then contact support.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: brand_profile_get. Full schema: help_describe {"tool":"brand_context_get"}. As JSON: /mcp/schemas/brand_context_get.json.

`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. …

Contract	Behavior
Changes things	No
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Viewer or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: it only reads.

Inputs:

Input	Type	Required	About
`section`	string	No	Which section to read. See the allowed values. One of `voice`, `pmf`, `audience`, `persona`, `all`.

Examples (IDs are illustrative; use the ones earlier calls return): Read the brand voice section:

{
  "name": "brand_profile_get",
  "arguments": {
    "section": "voice"
  }
}

Errors and statuses:

Code	When
`INTERNAL`	Something went wrong on our side. Retry once, then contact support.
`NOT_FOUND`	The item doesn’t exist, or this brand can’t see it.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: brand_knowledge, brand_context_get. Full schema: help_describe {"tool":"brand_profile_get"}. As JSON: /mcp/schemas/brand_profile_get.json.

`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…

Contract	Behavior
Changes things	No
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Viewer or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: it only reads.

Actions (platform):

platform	Required inputs
`instagram`	`copy`, `platform`
`facebook`	`copy`, `platform`
`linkedin`	`copy`, `platform`
`tiktok`	`copy`, `platform`
`youtube`	`copy`, `platform`
`x`	`copy`, `platform`

Other inputs, shared by every action (the live schema says which each action reads): copy. Examples (IDs are illustrative; use the ones earlier calls return): Check an Instagram caption:

{
  "name": "brand_voice_validate",
  "arguments": {
    "copy": "Autumn is here. Our new single-origin roast is out now, in a limited batch.",
    "platform": "instagram"
  }
}

Errors and statuses:

Code	When
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: brand_knowledge, content_create. Full schema: help_describe {"tool":"brand_voice_validate","action":"instagram"}. help_describe’s action takes a platform value. As JSON: /mcp/schemas/brand_voice_validate.json.

`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…

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: repeating the call gives the same result.

Inputs:

Input	Type	Required	About
`platform`	string	No	The network to act on. See the allowed values. One of `meta`, `google`, `all`.
`delimiter`	string	Yes	Separator between name segments, e.g. ’\|’.
`fields`	array	Yes	Ordered field labels, e.g. [‘funnel’, ‘format’, ‘audience’].

Examples (IDs are illustrative; use the ones earlier calls return): Set a Meta naming convention:

{
  "name": "paid_naming_schema_set",
  "arguments": {
    "platform": "meta",
    "delimiter": "|",
    "fields": [
      "funnel",
      "format",
      "audience"
    ]
  }
}

Errors and statuses:

Code	When
`INTERNAL`	Something went wrong on our side. Retry once, then contact support.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.

Related: paid_naming_schema_get, paid_manage. Full schema: help_describe {"tool":"paid_naming_schema_set"}. As JSON: /mcp/schemas/paid_naming_schema_set.json.

`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…

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Operator or higher
Needs	An active brand.
Confirmation	Writes preview first and return a `confirm_token` with `expires_at`. Confirm with that token after the person says yes.
Completion	Returns the result in the same call.
Retry	Each `confirm_token` works once. Preview again to retry.

Inputs:

Input	Type	Required	About
`segment`	object	Yes	—
`targets`	object	Yes	The items to act on, each with its own fields.
`mode`	string	No	Default ‘preview’. ‘confirm’ needs the preview’s `confirm_token`. One of `preview`, `confirm`.
`ad_account_id`	string	No	Meta ad account (new audience).
`audience_id`	string	No	Append to this Meta audience instead.
`members`	array	No	People to add. Hashed server-side; uploaded in batches of 10,000.
`default_country_code`	string	No	—
`customer_file_source`	string	No	Where the list came from (Meta-required). Default `USER_PROVIDED_ONLY`. One of `USER_PROVIDED_ONLY`, `PARTNER_PROVIDED_ONLY`, `BOTH_USER_AND_PARTNER_PROVIDED`.
`idempotency_key`	string	No	A key you choose. Reuse it only to retry the same request without doing it twice.
`confirm_token`	string	No	The token a preview returned. Send it back to confirm that exact change.

Examples (IDs are illustrative; use the ones earlier calls return): Push HVL audience:

{
  "name": "intel_audience_push",
  "arguments": {
    "segment": {
      "name": "HVL",
      "source": "high_ltv"
    },
    "targets": {
      "meta_custom_audiences": true
    }
  }
}

Errors and statuses:

Code	When
`VALIDATION_ERROR`	Pass members[] (emails/phones); segments built from brand data are not available.
`NOT_IMPLEMENTED`	This path isn’t available yet. Don’t retry; use the listed tool for the job.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Operator or higher. Ask an Admin or Owner.
`CONFIRMATION_REQUIRED`	This write needs a preview first. Preview, get a yes, then confirm with the returned token.

Related: paid_manage, analytics_cross_platform_spend. Full schema: help_describe {"tool":"intel_audience_push"}. As JSON: /mcp/schemas/intel_audience_push.json.

`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.

Contract	Behavior
Changes things	No
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Admin or Owner
Needs	An active brand.
Confirmation	None. The call runs when made.
Completion	Returns the result in the same call.
Retry	Safe to retry: it only reads.

Inputs: none. Examples (IDs are illustrative; use the ones earlier calls return): Changes waiting for an Admin or Owner:

{
  "name": "mcp_approvals_list",
  "arguments": {}
}

Errors and statuses:

Code	When
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Admin or Owner. Ask an Admin or Owner.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.

Related: mcp_approval_grant. Full schema: help_describe {"tool":"mcp_approvals_list"}. As JSON: /mcp/schemas/mcp_approvals_list.json.

`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 …

Contract	Behavior
Changes things	Yes
Listed in your assistant	Not in `tools/list`. Call it by name; `help_describe` has its schema.
Role	Admin or Owner
Needs	An active brand.
Confirmation	Writes preview first: a confirmation dialog in clients that support it, otherwise a `confirm_token` to send back after a yes.
Completion	Returns the result in the same call.
Retry	Each `confirm_token` works once. Preview again to retry.

Inputs:

Input	Type	Required	About
`token`	string	Yes	—

Examples (IDs are illustrative; use the ones earlier calls return): An Admin or Owner grants a pending change:

{
  "name": "mcp_approval_grant",
  "arguments": {
    "token": "tok_9b1e5c2f4a7d3e60"
  }
}

Errors and statuses:

Code	When
`NOT_FOUND`	The item doesn’t exist, or this brand can’t see it.
`VALIDATION_ERROR`	An input is missing or wrong, or it changed since the preview. `details` names the field.
`BRAND_NOT_SELECTED`	No brand is active. Call `brands_select`.
`needs_role`	The person’s role is too low for this call. Needs: Admin or Owner. Ask an Admin or Owner.
`CONFIRMATION_REQUIRED`	This write needs a preview first. Preview, get a yes, then confirm with the returned token.

Related: mcp_approvals_list, paid_manage. Full schema: help_describe {"tool":"mcp_approval_grant"}. As JSON: /mcp/schemas/mcp_approval_grant.json.

What’s next

All tools

Every tool on one page, and the machine-readable index.

Unlisted tools: posts, inbox, and accounts

Tools the server accepts by name but does not list, for Instagram posts, audits, the inbox, connected accounts, and week planning.

Get started

AI assistant (MCP)

For developers and agents

Creative+

Organic+

Performance+

Brand and account

Resources

Unlisted tools: agents, brand, and approvals

`agent_cancel`

`jaina_ask`

`jaina_pro_run`

`organic_ask`

`insights_get`

`brand_context_get`

`brand_profile_get`

`brand_voice_validate`

`paid_naming_schema_set`

`intel_audience_push`

`mcp_approvals_list`

`mcp_approval_grant`

What’s next

All tools

Unlisted tools: posts, inbox, and accounts