Sienna Hosted MCP

Sienna connects a supported AI host to advertising and creative data that the signed-in user has already linked to Sienna. The public MCP endpoint is https://mcp.sienna.work/mcp and uses OAuth for account authorization.

Before connecting

Create or sign in to a Sienna account.
Connect at least one supported advertising or analytics source.
Confirm that you are authorized to access the selected accounts and data.

Available tools

Tool	What it does	Important behavior
`ads_accounts`	Lists linked ad accounts and Adjust apps, or answers an account question.	Omit platforms for all; specify platforms to filter.
`ads_metrics`	Runs a strict provider-native query or a natural-language metrics question.	Structured queries use one platform; questions may use several.
`ads_creatives`	Lists, shows, or searches analyzed creatives.	Results are bounded to creatives accessible to the signed-in user.
`research`	Researches public markets, brands, and competitors.	Accepts optional repeated scopes and quick or standard depth.
`job_list`	Lists Jobs created through Sienna UI, CLI, or MCP.	Can list active records or the 30-day trash.
`job_status`	Returns general progress, target outcomes, input choices, and terminal results.	Poll only after `poll_after_ms` when present.
`job_answer`	Answers a Job in `needs_input`.	Starts the next execution generation.
`job_cancel`	Cancels active or input-waiting work.	Preview first, obtain explicit confirmation, then execute.
`job_delete`	Moves one terminal Job to trash.	Active work must be cancelled first.
`job_restore`	Restores one Job before its purge date.	Preview first.
`job_purge`	Permanently deletes one trashed Job.	Preview and explicit confirmation are required.

Action guide

Use the dedicated action that matches the request. Every action requires a UUID idempotency_key; reuse it only when retrying the same request:

Use operation=list|ask for accounts and operation=query|ask for metrics.
A structured metrics query requires one platform and matching provider-native arguments.
An accounts or metrics Ask requires prompt; a metrics Ask may filter several platforms.
Research requires prompt, has no operation field, and may repeat market, brand, and competitor scopes.
Creative reads use operation=list|show|search with the matching strict arguments.

Sienna uses credentials linked by the signed-in user. Never place credentials, another user identity, a full upstream URL, or an HTTP method in a tool call.

Connect and use

In a host that supports custom remote MCP connections, add the endpoint above.
Sign in to Sienna and review the exact scopes requested on the consent page. Identity scopes may share the verified Sienna account email with the host for workspace access rules.
Ask a bounded question that names an account, time range, and desired comparison.
If a Job is still running, use the returned job_id to check status.
Disconnect the connection in the host or in Sienna when it is no longer needed.

Results and recovery

Tool results include a success indicator and either structured data or a safe error with a recovery action. Actions return a job_id acknowledgement and status. If authorization is missing or expired, reconnect and approve only the required scopes. If a limit or temporary failure is returned, follow the retry guidance in that result. Preserve the safe error kind when contacting support, but never post passwords, tokens, or connected-service credentials.