MCP server
Connect Claude, ChatGPT, Cursor or your own agent to Pluto Ads through the Model Context Protocol.
The server offers every Pluto Ads action as a tool. Each tool runs the same action as the app and the Public API, with the same permissions, idempotency and audit log. For connecting from the app's side, and what your team sees, read Connected agents.
Server URL
https://api.plutoads.ai/api/v1/mcpSettingsAPI (Settings, then API) shows it under Connect an MCP client, with the setup for your client. The server speaks Streamable HTTP and offers tools only.
Connect a client
Clients sign in with OAuth: add the server, and your client opens Pluto Ads in the browser to sign in. There's no key to copy.
| Client | Setup |
|---|---|
| Claude | In Claude, open CustomizeConnectors (Customize, then Connectors), select Add custom connector and paste the server URL. See Claude's guide. |
| ChatGPT | Turn on Developer mode in SettingsSecurity and login (Settings, then Security and login), then create an app under Plugins with the server URL and OAuth. See ChatGPT's guide. |
| Cursor | Add the config to ~/.cursor/mcp.json. See Cursor's guide. |
| Claude Code | Run the command, then choose Authenticate under /mcp. See Claude Code's guide. |
| VS Code | Run MCP: Open User Configuration from the Command Palette and add the config. See VS Code's guide. |
| Codex | Run the command in your terminal. See Codex's guide. |
{
"mcpServers": {
"plutoads": {
"url": "https://api.plutoads.ai/api/v1/mcp"
}
}
}Other clients point a Streamable HTTP client at the server URL. A client that can't sign in sends an
API key as Authorization: Bearer <key> instead:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(new URL("https://api.plutoads.ai/api/v1/mcp"), {
requestInit: { headers: { Authorization: `Bearer ${process.env.PLUTO_KEY}` } },
});
const client = new Client({ name: "brevanne-reports", version: "1.0.0" });
await client.connect(transport);
const context = await client.callTool({ name: "get_context", arguments: {} });Once connected, ask the agent to call get_context. It answers with who the agent is, its workspace and what it
may do now. capabilities lists each thing it may do, with what it allows. role is the role of the person it acts
for. notGranted lists what that person may do that this connection may not:
{
"actor": {
"id": "01a0d9f2-6c1e-7b3d-9a41-5e2f8c7d1a90",
"kind": "agent",
"name": "Claude via Sarah Mitchell",
"capabilities": [
{ "id": "ads:read", "allows": "View ads, launches, analytics and spend" },
{ "id": "reviews:write", "allows": "Comment, review and approve ads" },
{ "id": "launches:write", "allows": "Create and edit launches and drafts" }
],
"permissions": ["read", "review"],
"userId": "01a0d7e5-3b7c-7e52-8d14-2a6f9b0c4e17"
},
"role": { "workspace": "manager", "workspaceRoleName": "Manager", "organization": "member" },
"notGranted": [{ "id": "ads:publish", "allows": "Publish and launch ads to the platform" }],
"workspace": { "id": "01a0d7e5-acb8-7176-a698-b6947a8016fe", "name": "Brevanne", "version": 4 }
}permissions lists the older scope names whose whole set the credential holds, for clients that read them.
Sign-in and scopes
The server is an OAuth 2.1 protected resource. A request without a credential gets 401 with a
WWW-Authenticate header that points to its metadata:
curl -s https://api.plutoads.ai/api/v1/.well-known/oauth-protected-resourceThe metadata names the authorization server. Clients read it, register and sign the person in with PKCE, so
nothing needs configuring by hand. The same metadata is at the origin root,
https://api.plutoads.ai/.well-known/oauth-protected-resource, for clients that look there.
When a client signs in, the browser opens Connect to Pluto Ads. The person chooses the workspace and the access
level. The level becomes the token's scopes: read, review, write, publish, admin and organization, as
in Scopes. The token is short-lived, its audience is the server URL, and it never does more
than the person's current role allows.
The server also accepts:
- API keys, as a Bearer token. A publishable key only calls read tools.
- Agent credentials, exchanged for a token. See Agent credentials.
Every tool names the capability it needs in _meta["ai.plutoads/capability"] and in its description. The scope
that holds it is in _meta["ai.plutoads/permission"]. The server checks the capability on every call, against the
person's current role and the credential's scopes. tools/list returns only the tools the credential can use now,
so the list changes when the person's role or the credential does. A tool called from an older list is refused, and
the refusal names the capability it needs. A tool only a person signed in to Pluto Ads completes, such as
open_billing_portal, is never in a credential's list, whatever it holds.
get_context says what the credential holds and why: actor.capabilities (what it may do now), role (the person's
workspace and organization roles), notGranted (what the person may do that this credential may not: ask them for a
credential that includes it) and credential (for a key or agent: the person it acts for, when it expires, the
addresses it works from and what it reaches). Where the organization lets members' agents only view
(credential policy), a member's agent holds the view capabilities only,
and its tool list says so.
Approvals
Tools that spend money or change what runs in Meta or LinkedIn or X need the publish scope. The server tells agents to confirm
these with the person first, and the confirmation happens in the agent's own conversation:
Pluto Ads can't see the conversation, so give publish only to agents you trust to ask. Live changes like
set_budget and set_delivery_status also say to confirm with the person. delete_social_comment refuses to run
without confirm: true.
For several live changes at once, an agent can call propose_changes instead. The person reviews that plan in the
Pluto Ads Inbox, and nothing changes until they approve it there. Agents can't approve plans, loop runs or the
in-app Agent's proposals: those are always a person's, in the app.
Tools carry MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so a client can
run read-only tools without asking and confirm the rest.
How tools behave
-
Start with
get_context. Then refer to everything by ID. Names aren't unique. -
One ad platform per call. Tools that work on more than Meta take
platform:meta(the default) orlinkedin, orxfor X.list_platformslists the platforms the workspace can use and what Pluto Ads can do on each, with the settings each platform's loops take and what saving refuses there (loops.rules,loops.refusedBlocks), andget_platform_specgives a platform's launch settings, options and rules in its own words.validate_loopchecks a loop exactly ascreate_loop,update_loopand turning it on do. -
X's data stays in Pluto Ads. X's terms keep what Pluto Ads reads from X in its own app until X agrees in writing that it may leave. On X, a tool answers with IDs, your launches and what Pluto Ads did, and each field that holds what X reports (a name, a status, a figure, a lead's answers, a reply's text) is
nullwithwithheld: truebeside it. See What stays in Pluto Ads. -
Writes are commands. Every write tool takes an optional
idempotencyKey. Reuse it when you retry, and the stored result comes back instead of a second change. -
Batch tools take
items[]and return an outcome per item:accepted,rejectedorconflict. Resend only what failed. -
Updates take
expectedVersionfrom your last read. See Versions and conflicts. -
Long work returns a job. Follow it with
wait_for_job, which streams progress when you pass aprogressToken, thenlist_job_itemsfor what failed.cancel_jobneeds what the job's work needs:publishfor publishing and changes to what runs, andadminfor a spending limit. -
Media never travels through MCP.
import_mediafetches up to 1,000 HTTPS URLs per job, andcreate_media_uploadsreturns URLs to upload files to. For hundreds or thousands of files, start withprepare_bulk_upload: it names a folder and the ways to fill it (an uploader for agents with a shell, a link for a person to drop files, URL import), andcreate_ads_from_mediathen makes an ad per file. See Bulk upload. -
Looking at creatives.
view_mediaandview_adsreturn images your model can see: a still of an image, or frames of a video. -
Profit comes from Pluto Profit, read only, one store per workspace.
connect_pluto_profitreturns a link for a person to open and approve. Money is decimal strings, in the store's currency for store and product figures and in the ad account's for ad estimates, and a value Pluto Profit can't compute isnull, never zero.get_ad_profitabilityis always an estimate. -
Results have a one-line summary, the JSON, and
structuredContentthat matches the tool's output schema. Large reads are compact by default:get_launchreturns each ad's copy rather than its merged settings and pages its ads 50 at a time (limit,after,adSetId);verbose: truereturns the whole document. Batch writes that change ads, ad sets, launches or media (update_ads,move_ads,edit_ad_sets,apply_bulk_edit,revert_changeset,delete_mediaand the other media batch tools) return each item's outcome with its ID, version, name and status; passverbose: truefor the whole entity.rank_adsreturns the ranked metric with the core ones (metricsfor others);get_insightsandget_launch_resultstakemetricsto keep only those, and givebyCurrencyonly when amounts span several currencies.search_creative_adspages 10 ads andlist_media20 items at a time unlesslimitsays otherwise. -
Performance.
get_insightsreads what the Analytics dashboard shows, with the same filters asGET /analytics/insights: segment filters (age,gender,country,placement,hourand more),breakdownby launch, campaign, ad set, ad or any segment,attributionincluding28d_click, andmetricsthat take any action Meta counts asaction:<type>,action_value:<type>orcost_per_action:<type>.rank_adsranks by any of those metrics, within a segment too, and its rows carry Meta's quality, engagement rate and conversion rate rankings, as doget_creative_performance's. Segment numbers reach back 13 months and use Meta's default attribution setting (each ad set's own, as in Ads Manager); reach and unique clicks come from Meta for exactly the period asked. By region, product and the action breakdowns Meta reports no website or app conversions: the answer'snotesays so, and they're absent, never 0. A metric markedincompletereads fields older days are still being read again with (coverage.history.fieldsCompleteFrom). Withplatform: "linkedin"every LinkedIn metric is there (engagements, qualified leads, open rate, viral figures and the rest, ranked byrank_adstoo) and the segments areconversionAction,placement,device,servingLocationandcarouselCard; LinkedIn's demographic segments (jobTitle,jobFunction,seniority,industry,companySize,company,country,region,county) are refused, since LinkedIn doesn't allow its demographic data as input to AI. The API serves them. -
Exactly the numbers you need.
get_insightsandget_launch_resultscheckmetricsagainst the platform's catalogue: an ID it doesn't report is refused with the closest IDs it has. Each metric asked for (or every one, withdefinitions: true) comes with its definition: name, unit, how it adds up (aggregation:sum,ratio,weightedorwindow) andsummable. Reach, frequency and unique clicks arewindowmetrics: breakdown rows never add up to their total. With abreakdown,sort(a metric, descending by default),limit(up to 1000) andcursor(the previousbreakdown.nextCursor) page the rows, andbreakdown.rowsTotalcounts them all. Filter by name withcampaignNames,adSetNames,adAccountNamesandlaunchNameswhen you have no IDs, by status withstatusesand by Pluto's labels withlabelIdsorlabelNames(every figure then covers only those ads).thenBysplits each breakdown row again byday,week,monthor a segment (ad by day, campaign by country): each row'sby.rowsadd up to it, and window metrics are never in them.platforms(or["all"]) answers several platforms in one call, each on its own underbyPlatformand never added together;withheldPlatformsandrefusedname any that can't give numbers there. -
Results kept in Pluto. Where a platform's terms keep its results inside Pluto's own app, a tool's answer holds
withheldData, one entry per platform:reason(platform_terms), amessageto act on,appUrl(the workspace's Analytics on that platform),dataExists: true,retryable: falseandstillAvailable. The results exist and are complete in Pluto; the nulls are not missing data or zero, and calling again or another tool gives the same answer. Tell the person to openappUrland keep working with the IDs, your launches and every other platform's data. The server's instructions say the same when you connect. -
The audit log.
list_audit_logreads the workspace's log, or withorganizationIdthe organization's (for its owners and admins). Each entry'sdetailhas what changed where it says more than itssummary, andrequestIdthe request it came from.commandIdfinds every entry of one command.export_audit_logwrites the same entries, with the same filters, to a CSV file in the background: follow itsjobIdwithwait_for_job, thenget_audit_log_exportgivesdownloadUrl(15 minutes; the file is kept for 7 days). The CSV's columns are in the Public API. -
Versions. Changes send the
expectedVersionthey read:search_adsandget_launchreturn each ad'sversion. A bulk edit records a changeset, andrevert_changesetputs back what it changed even after other changes since (a move), as long as the fields it wrote still hold its values.list_bulk_editslists your bulk edits withcanUndo, so a lostchangesetIdcan be found again. -
Readiness.
get_launch_reviewand the app's checklist flag an ad whose file failed processing or was removed (publishing would refuse it); files still uploading or processing don't block, publishing waits for them. Checklist items carry afixlink into the app, likepluto:launch/<launchId>#adAccountId. -
X. Every tool takes
"platform": "x"where it takes a platform. X's terms keep what Pluto reads from X inside Pluto, so in a tool's answer a field holding what X reports (a name, a status, a figure, a lead's answers, a reply's text) isnullandwithheldbeside it istrue;withheldDataand the summary say why and link the workspace's Analytics on X, where the person sees them. IDs, your launches and drafts, and the outcome of what you asked Pluto to do answer as always.update_lead_formandarchive_lead_formchange and archive an X lead form,get_insight_segmentssplits a campaign's results by age, gender, platform, region or metro,estimate_platform_audienceasks X for an audience's size andget_ad_previewfor X's preview of an ad: the last three answerwithheld: truehere, and X isn't asked.manage_platform_conversion_eventcreates, changes and deletes an X ad account's conversion events; the app's X page lists them with the windows each counts in and the code that fires it on your site.list_platform_audienceslists an ad account's custom audiences and do-not-reach list by ID, andmanage_platform_audiencemakes a customer list from people's emails, phone numbers, usernames, X user IDs or device IDs, adds and removes people, renames and deletes it: Pluto hashes every value before it reaches X and keeps none of them.
Errors and limits
A problem with the request is a tool result with isError: true, so the model can read it and act. It holds a
message and the same code and fields as the API errors.
{
"content": [
{ "type": "text", "text": "You can view this workspace but not change it. It needs the `launches:write` capability (create and edit launches and drafts). Ask an admin to give this credential the access it needs; it never does more than its person can." },
{ "type": "text", "text": "{\"code\":\"forbidden\",\"message\":\"You can view this workspace but not change it.\",\"missingCapability\":\"launches:write\",\"missingCapabilityText\":\"Create and edit launches and drafts\"}" }
],
"isError": true
}The message says what to do next:
- Arguments that don't fit name the argument (
`items[2].adId`) and, for an ID or a time, what goes there. - A refusal for the credential's access says which access it needs. Tools that are a person's own (their inbox, Agent chats, views, skills and preferences) need a client signed in with OAuth as that person; API keys and machine-to-machine clients can't use them.
- When Pluto or the platform is limiting how often something runs, the message gives the seconds to wait
(
retryAfterin the JSON).
Credential and transport problems are JSON-RPC errors:
| HTTP | Code | Meaning |
|---|---|---|
| 401 | -31001 | No credential, or it's invalid, expired or revoked. Sign in again. |
| 403 | -31003 | The credential can't use this workspace, or the request's origin isn't allowed. |
| 429 | -31029 | Over the rate limit. data.retryAfter and Retry-After give the seconds. |
| 503 | -31503 | Sign-in is unavailable. Retry shortly. |
| 400 | -32020, -32022 | Headers that don't match the body, or an unsupported protocol version. |
| 200 | -32603 | Our fault. Retry with the same idempotencyKey. |
MCP and the REST API share the same rate limits: 1,000 requests per 10 seconds per credential, and 3,000 for a workspace's keys and agents together.
Protocol versions
The server has no sessions: each request stands alone, and GET or DELETE on the URL answers 405. A request
is one JSON-RPC message, and batches aren't supported.
| Versions | How it works |
|---|---|
2026-07-28 | Stateless. Each request carries the protocol version and client capabilities in _meta, plus the MCP-Protocol-Version, Mcp-Method and, for tools/call, Mcp-Name headers. |
2025-11-25, 2025-06-18, 2025-03-26 | initialize agrees on a version: yours if we support it, otherwise 2025-11-25. |
Tool catalogue
Every tool the server offers, 448 in all, by area. Access is the permission a tool needs. tools/list
has each tool's full description and input and output schemas.
Workspace. Who you are, the workspace, its people and who is here.
| Tool | What it does | Access |
|---|---|---|
get_context | Get your identity and permissions | read |
list_workspaces | List workspaces | read |
create_workspace | Create a workspace | organization |
list_members | List members | read |
invite_members | Invite members | admin |
list_invitations | List invitations | read |
revoke_invitation | Revoke invitation | admin |
edit_members | Edit members | admin |
rename_workspace | Rename workspace | admin |
update_workspace_settings | Update workspace settings | admin |
create_workspace_logo_upload | Start workspace logo upload | admin |
set_workspace_logo | Set or remove workspace logo | admin |
list_webhook_events | Webhook events | read |
get_presence | Who is here | read |
list_audit_log | List the audit log | admin |
export_audit_log | Export the audit log as CSV | admin |
get_audit_log_export | Get an audit log export | admin |
Launches. Launches, ad sets and ads, bulk edits and launch specs.
| Tool | What it does | Access |
|---|---|---|
list_launches | List launches | read |
search_ads | Search ads across launches | read |
get_launch | Get launch | read |
get_launch_review | What's missing before publishing | read |
create_launches | Create launches | write |
update_launches | Update launches | write |
archive_launch | Archive or delete launch | write |
archive_launches | Archive or restore launches | write |
duplicate_launch | Duplicate launch | write |
get_launch_stats | Launch overview | read |
edit_ad_sets | Edit ad sets | write |
create_ads | Create ads | write |
create_ads_from_media | Create ads from media | write |
update_ads | Update ads | review |
duplicate_ad_set | Duplicate an ad set | write |
split_ad_set | Split an ad set | write |
move_ads | Move ads | write |
duplicate_ads | Duplicate ads | write |
delete_ads | Delete ads | write |
list_archived | Archived ads and ad sets | read |
restore_archived | Restore archived ads or ad sets | write |
preview_bulk_edit | Preview bulk edit | write |
apply_bulk_edit | Apply bulk edit | write |
list_bulk_edits | List bulk edits | read |
get_changeset | Get a bulk edit | read |
revert_changeset | Revert a bulk edit | write |
validate_launch_spec | Validate launch spec | write |
apply_launch_spec | Apply launch spec | write |
list_launch_groups | List launch groups | read |
get_launch_group | Get launch group | read |
create_launch_group | Create launch group | write |
update_launch_group | Update launch group | write |
add_launch_campaign | Add a campaign to a launch | write |
archive_launch_group | Archive or delete launch group | write |
duplicate_launch_group | Duplicate launch group | write |
get_launch_group_results | Compare a creative across campaigns | read |
get_linked_ads | Get linked ads | read |
update_linked_ads | Update linked ads | write |
unlink_ad | Unlink ad | write |
get_ad_platform_settings | Get an ad's platform settings | read |
update_ad_platform_settings | Change an ad's platform settings | write |
Publishing and live changes. Publishing, and changes to what runs in Meta and LinkedIn and X.
| Tool | What it does | Access |
|---|---|---|
get_publish_preview | Prepare to publish | read |
publish_launch | Publish a launch | publish |
cancel_publish | Cancel publishing | publish |
get_publication | What is live | read |
get_revisions | Pending changes to live ads | read |
get_ad_meta_preview | Meta's preview of an ad | read |
publish_revisions | Publish pending changes | publish |
discard_revisions | Discard pending changes | write |
set_delivery_status | Pause or activate live delivery | publish |
set_budget | Change a live budget | publish |
set_bid | Change a live bid | publish |
set_schedule | Change a live ad set's schedule | publish |
duplicate_at_meta | Duplicate a live campaign, ad set or ad | publish |
move_at_meta | Move a live ad or ad set in Meta | publish |
delete_at_meta | Delete a live ad or ad set | publish |
list_keywords | List keywords | read |
list_negative_keywords | List negative keywords | read |
list_negative_keyword_lists | List negative keyword lists | read |
list_search_terms | List search terms | read |
list_recommendations | List recommendations | read |
get_keyword_ideas | Get keyword ideas | read |
get_keyword_metrics | Get keyword metrics | read |
get_keyword_competition | Get keyword competition | read |
get_search_term_brands | Get brand search terms | read |
set_brand_terms | Set brand terms | write |
forecast_keywords | Forecast keywords | read |
set_keyword_status | Pause or turn on a keyword | publish |
add_keywords | Add keywords | publish |
add_negative_keywords | Add negative keywords | publish |
change_keywords | Change keywords, negatives and lists | publish |
apply_recommendation | Apply recommendations | publish |
dismiss_recommendation | Dismiss recommendations | publish |
remove_campaign | Remove a live campaign | publish |
get_creative_preview | Get the platform's ad preview | read |
archive_at_platform | Archive a live campaign, ad set or ad | publish |
set_campaign_spend_cap | Change a live campaign's spend cap | publish |
search_targeting | Search interests, behaviors and demographics | read |
list_audiences | List audiences | read |
get_minimum_budget | Get minimum budget | read |
set_targeting | Change live targeting | publish |
estimate_platform_audience | Estimate an audience | read |
get_ad_preview | Preview ads on their platform | read |
list_platform_audiences | List a platform's audiences | read |
manage_platform_audience | Change a platform's audiences | publish |
get_ad_set_estimate | Estimate a draft ad set | read |
list_attachment_choices | List attachment choices | read |
list_saved_audiences | List saved audiences | read |
manage_saved_audience | Change saved audiences | publish |
list_third_party_audiences | List third-party audiences | read |
Change sets. Plans of live changes a person approves in the app.
| Tool | What it does | Access |
|---|---|---|
list_change_sets | List plans of live changes | read |
get_change_set | Get a plan of live changes | read |
propose_changes | Propose changes for approval | write |
revise_change_set | Send a plan back with feedback | write |
edit_change_set | Edit a plan | write |
undo_change | Undo an applied change | publish |
Ad platforms. The Meta and LinkedIn and X connections, their launch settings, synced campaigns, ad sets and ads, and imports.
| Tool | What it does | Access |
|---|---|---|
get_platform_mirror | Get Keep in sync | read |
update_platform_mirror | Change Keep in sync | admin |
get_meta_integration | Get Meta connection | read |
sync_meta | Sync Meta | write |
list_meta_attention | List what Meta needs | read |
check_meta_attention | Check a Meta step is done | publish |
list_meta_campaigns | List Meta campaigns | read |
list_meta_ad_sets | List Meta ad sets | read |
list_meta_ads | List Meta ads | read |
get_ad_posts | Get ad post links | read |
get_meta_delivery | Get learning and delivery issues | read |
import_from_meta | Import from Meta | write |
preview_meta_import | Preview an import from Meta | read |
get_import_report | Get an import report | read |
switch_meta_ad_account | Turn an ad account on or off | admin |
switch_meta_page | Turn a Page on or off | admin |
switch_meta_pages | Turn Pages on or off | admin |
switch_meta_ad_accounts | Turn ad accounts on or off | admin |
set_meta_account_pages | Set an ad account's Pages | admin |
set_spending_limit | Set an ad account's spending limit | admin |
connect_meta | Connect Meta | admin |
reconnect_meta | Reconnect Meta | admin |
disconnect_meta | Disconnect Meta | admin |
get_platform_integration | Get a platform connection | read |
connect_platform | Connect a platform | admin |
sync_platform | Sync a platform | write |
disconnect_platform | Disconnect a platform | admin |
switch_platform_ad_account | Turn an ad account on or off | admin |
switch_platform_ad_accounts | Turn ad accounts on or off | admin |
switch_platform_page | Turn a Page on or off | admin |
switch_platform_pages | Turn Pages on or off | admin |
list_platforms | List ad platforms | read |
get_platform_spec | Get a platform's launch settings | read |
list_campaigns | List campaigns | read |
list_ad_sets | List ad sets | read |
list_ads | List ads | read |
search_platform_targeting | Search a platform's targeting | read |
list_platform_conversions | List an ad account's conversions | read |
import_platform_campaigns | Import campaigns from an ad platform | write |
get_platform_import_report | Get an import's report | read |
list_account_videos | List an ad account's videos | read |
add_account_video | Add a video to an ad account | write |
list_conversion_actions | List conversion actions | read |
get_conversion_action | Get a conversion action and its tag | read |
create_conversion_action | Create a conversion action | publish |
list_account_assets | List an ad account's own assets | read |
add_account_asset | Add an asset to an ad account | publish |
remove_account_asset | Remove an asset from an ad account | publish |
list_bid_strategies | List portfolio bid strategies | read |
create_bid_strategy | Create a portfolio bid strategy | publish |
update_bid_strategy | Change a portfolio bid strategy | publish |
manage_platform_conversion_event | Manage a conversion event | publish |
manage_platform_conversion_goal | Manage a conversion goal | publish |
manage_platform_site_tag | Manage a site tag | publish |
upload_offline_conversions | Upload offline conversions | publish |
list_platform_catalogs | List product catalogs | read |
manage_platform_catalog | Change product catalogs | publish |
list_product_sets | List product sets | read |
manage_product_set | Change product sets | publish |
list_catalog_feeds | List product feeds | read |
manage_catalog_feed | Change product feeds | publish |
list_catalog_products | List catalog products | read |
manage_catalog_products | Change catalog products | publish |
list_catalog_imports | List catalog imports | read |
Results. Ad performance from Meta and LinkedIn and X.
| Tool | What it does | Access |
|---|---|---|
get_insights | Ad performance | read |
get_launch_results | Launch results | read |
rank_ads | Rank ads | read |
refresh_insights | Refresh ad performance | write |
get_platform_report | Get a platform report | read |
get_insight_segments | Results by segment | read |
get_delivery_insights | Get a delivery breakdown | read |
get_reach_overlap | Get a reach overlap | read |
Profit. Profit from Pluto Profit: the store connection, the store's and its products' profit, and an estimate per ad.
| Tool | What it does | Access |
|---|---|---|
get_pluto_profit_integration | Get Pluto Profit connection | read |
disconnect_pluto_profit | Disconnect Pluto Profit | admin |
connect_pluto_profit | Connect Pluto Profit | admin |
reconnect_pluto_profit | Reconnect Pluto Profit | admin |
get_profit_summary | Store profit | read |
get_product_profitability | Product profitability | read |
get_ad_profitability | Ad profitability (estimate) | read |
Research. Competitors' ads in the public Ad Libraries, Reddit threads and comments, web pages, and competitors researched in the workspace: their ads, what Creative Memory found in them and their funnels.
| Tool | What it does | Access |
|---|---|---|
search_ad_library | Search Meta's Ad Library | read |
research_ad_library | Read a public Ad Library | read |
read_web_page | Read a web page in a browser | read |
search_reddit | Search Reddit | read |
read_reddit_thread | Read a Reddit thread | read |
research_competitor | Research a competitor's ads | write |
get_competitor_ads | Read competitors' ads | read |
analyze_competitor_funnel | Analyze a competitor's funnel | read |
Media. The media library, and looking at media and ads.
| Tool | What it does | Access |
|---|---|---|
list_media | List media | read |
get_media | Get media | read |
import_media | Import media from URLs | write |
create_media_uploads | Start media uploads | write |
complete_media_uploads | Finish media uploads | write |
complete_media_upload | Finish a media upload | write |
prepare_bulk_upload | Start a bulk upload | write |
update_media | Rename or move media | write |
move_media | Move media | write |
archive_media | Archive media | write |
unarchive_media | Unarchive media | write |
delete_media | Delete media | write |
list_media_folders | List media folders | read |
edit_media_folders | Edit media folders | write |
view_media | Look at media | read |
view_ads | Look at ads | read |
Creative Memory. Search inside your creatives and read what Creative Memory knows about them.
| Tool | What it does | Access |
|---|---|---|
get_creative_performance | Creative performance evidence | read |
compare_variants | Compare creative variants | read |
evaluate_creative_condition | Check a creative condition | read |
get_creative_context | Creative composition | read |
get_creative_memory_usage | Creative Memory status | read |
search_creative_memory | Search Creative Memory | read |
get_creative_memory | Creative Memory evidence | read |
quote_creative_memory | Preview a Creative Memory analysis | write |
request_creative_memory | Read files with Creative Memory | write |
list_creative_memory_requests | Creative Memory requests | read |
cancel_creative_memory_request | Cancel Creative Memory work | write |
search_creative_ads | Search ads by copy and creative | read |
create_creative_library_import | Index historical library | write |
get_creative_library_import | Library import progress | read |
list_creative_library_imports | Library imports | read |
list_creative_library_import_items | Library import items | read |
pause_creative_library_import | Pause library import | write |
resume_creative_library_import | Resume library import | write |
cancel_creative_library_import | Cancel library import | write |
retry_creative_library_import_item | Retry library import item | write |
quote_creative_precision | Preview targeted creative inspection | write |
request_creative_precision | Start targeted creative inspection | write |
get_creative_precision | Targeted creative evidence | read |
cancel_creative_precision | Cancel targeted inspection | write |
list_creative_monitors | List creative monitors | read |
get_creative_monitor | Read creative monitor | read |
list_creative_monitor_items | List creative monitor items | read |
get_creative_correction_context | Review creative correction sources | read |
correct_creative_evidence | Correct creative evidence | write |
release_creative_corrections | Release creative corrections | write |
get_creative_correction | Creative correction history | read |
list_creative_corrections | Creative correction revisions | read |
record_creative_learning_label | Record creative learning annotation | write |
get_creative_learning_label | Creative learning annotation | read |
list_creative_learning_labels | Creative learning annotations | read |
register_creative_experiment | Register creative experiment | write |
amend_creative_experiment | Amend creative experiment | write |
set_creative_experiment_status | Update experiment status | write |
observe_creative_experiment | Record experiment outcomes | write |
get_creative_experiment | Registered experiment | read |
list_creative_experiments | Creative experiments | read |
list_creative_experiment_outcomes | Recorded experiment outcomes | read |
record_creative_lineage | Record creative relationship | write |
list_creative_lineage | Creative relationships | read |
get_creative_lineage | Creative relationship history | read |
Review and comments. Comments, review, the Inbox and workflow settings.
| Tool | What it does | Access |
|---|---|---|
list_comments | List comments | read |
add_comments | Add a review comment | review |
create_comment_attachment_upload | Start comment attachment upload | review |
update_comments | Edit, resolve, react to comments | review |
get_ad_activity | Ad activity | read |
follow_ad | Subscribe to an ad | read |
follow_thread | Subscribe to a thread | read |
get_inbox | Inbox | read |
update_inbox | Triage inbox | read |
notify_members | Notify people | write |
get_workflow_settings | Get workflow settings | read |
edit_statuses | Edit review statuses | write |
edit_labels | Edit tags | write |
edit_copy_templates | Edit copy templates | write |
edit_country_groups | Edit country groups | write |
Comments on ads and leads. What people post on your ads, and the leads they send.
| Tool | What it does | Access |
|---|---|---|
list_social_comments | List comments on ads | read |
mark_social_post_read | Mark a post's comments read | read |
set_social_post_state | Follow up or move a post to done | read |
get_social_comment | Get a comment on an ad | read |
reply_to_social_comment | Reply to a comment | publish |
hide_social_comment | Hide a comment | publish |
hide_social_comments | Hide or unhide comments | publish |
unhide_social_comment | Unhide a comment | publish |
delete_social_comment | Delete a comment | publish |
sync_social_comments | Read comments now | write |
list_lead_forms | List lead forms | read |
list_leads | List leads | read |
get_lead | Get a lead | write |
create_lead_form | Create a lead form | publish |
sync_leads | Read leads now | write |
update_lead_form | Change a lead form | publish |
archive_lead_form | Archive a lead form | publish |
Loops. Automations: build, test, run and undo, and their folders.
| Tool | What it does | Access |
|---|---|---|
list_loops | List loops | read |
get_loop | Get a loop | read |
list_loop_templates | List loop templates | read |
list_loop_skills | List loop skills | read |
create_loop | Create a loop | write |
update_loop | Update a loop | write |
duplicate_loop | Duplicate a loop | write |
archive_loop | Archive a loop | write |
delete_loop | Delete a loop | write |
unarchive_loop | Unarchive a loop | write |
validate_loop | Check a loop | read |
set_loop_enabled | Turn a loop on or off | write |
run_loop | Run a loop now | write |
test_run_loop | Test a loop | write |
list_loop_runs | List a loop's runs | read |
cancel_loop_run | Stop a loop run | write |
undo_loop_changes | Undo a loop's changes | write |
get_loop_run | Get a loop run | read |
list_loop_folders | List loop folders | read |
create_loop_folder | Create a loop folder | write |
rename_loop_folder | Rename a loop folder | write |
delete_loop_folder | Delete a loop folder | write |
move_loops | Move loops to a folder | write |
set_loops_enabled | Turn loops on or off | write |
Views. What a person sees on a list page (filters, grouping, ordering and saved views), and where anything is in the app.
| Tool | What it does | Access |
|---|---|---|
open_view | Open a view | read |
get_view | Get what a list page shows | read |
set_view | Set what a list page shows | read |
find_in_app | Find in the app | read |
list_views | List saved views | read |
save_view | Save a view | read |
update_view | Update a saved view | read |
delete_view | Delete a saved view | read |
Agent. The in-app Agent's chats, guidance, skills, models and approvals.
| Tool | What it does | Access |
|---|---|---|
list_agent_chats | List Agent chats | read |
get_agent_chat | Get an Agent chat | read |
rename_agent_chat | Rename an Agent chat | read |
delete_agent_chat | Delete an Agent chat | read |
share_agent_chat | Share an Agent chat | write |
unshare_agent_chat | Stop sharing an Agent chat | write |
stop_agent_chat | Stop an Agent answer | read |
mark_agent_chat_read | Mark an Agent chat read | read |
edit_agent_chat_message | Edit a message in an Agent chat | write |
list_agent_chat_message_versions | List a message's versions | read |
select_agent_chat_message_version | Switch a message's version | write |
get_agent_guidance | Get Agent guidance | read |
set_agent_guidance | Set Agent guidance | write |
list_agent_skills | List Agent skills | read |
get_agent_skill | Get Agent skill | read |
create_agent_skill | Create Agent skill | write |
update_agent_skill | Update Agent skill | write |
delete_agent_skill | Delete Agent skill | write |
run_agent_skill | Run Agent skill | read |
list_agent_memories | List Agent memory | read |
get_agent_memory | Get Agent memory entry | read |
create_agent_memory | Remember for Agent | write |
update_agent_memory | Update Agent memory entry | write |
delete_agent_memory | Forget Agent memory entry | write |
list_models | List models | read |
update_model_settings | Update model settings | admin |
update_model_visibility | Update model visibility | read |
get_agent_approval_settings | Get Agent approval settings | read |
set_agent_approval_settings | Set Agent approval settings | admin |
Jobs. Long-running work and its items.
| Tool | What it does | Access |
|---|---|---|
get_job | Get job | read |
list_jobs | List jobs | read |
list_job_items | List job items | read |
cancel_job | Cancel job | write |
retry_job | Retry failed job items | write |
wait_for_job | Wait for job | read |
Defaults and templates. What new campaigns and ad sets start with, and campaign and ad set templates.
| Tool | What it does | Access |
|---|---|---|
get_defaults | Get campaign and ad set defaults | read |
set_defaults | Set campaign or ad set defaults | write |
list_setting_templates | List settings templates | read |
get_setting_template | Get a settings template | read |
create_setting_template | Create a settings template | write |
update_setting_template | Change a settings template | write |
duplicate_setting_template | Duplicate a settings template | write |
delete_setting_template | Delete a settings template | write |
apply_setting_template | Apply a settings template | write |
Settings. Meta defaults, the analytics dashboard and view preferences.
| Tool | What it does | Access |
|---|---|---|
get_meta_defaults | Get Meta launch defaults | read |
set_meta_defaults | Set Meta launch defaults | write |
get_dashboard | Get analytics dashboard | read |
set_dashboard | Set analytics dashboard | write |
get_preferences | Get view preferences | read |
set_preference | Set a view preference | read |
get_platform_account_settings | Get an ad account's settings on its platform | read |
update_platform_account_settings | Change an ad account's settings on its platform | publish |
API keys and webhooks. Credentials, connected agents and webhooks.
| Tool | What it does | Access |
|---|---|---|
list_api_keys | List API keys | admin |
create_api_key | Create an API key | admin |
rotate_api_key | Rotate an API key | admin |
narrow_api_key | Narrow an API key | admin |
revoke_api_key | Revoke an API key | admin |
list_agent_clients | List agent clients | admin |
create_agent_client | Register an agent client | admin |
narrow_agent_client | Narrow an agent client | admin |
rotate_agent_client | Rotate an agent client's secret | admin |
revoke_agent_client | Revoke an agent client | admin |
list_agent_connections | List connected agents | read |
narrow_agent_connection | Narrow a connected agent | write |
revoke_agent_connection | Disconnect a connected agent | write |
list_webhooks | List webhooks | admin |
create_webhook | Create a webhook | admin |
update_webhook | Update a webhook | admin |
rotate_webhook_secret | Rotate a webhook's signing secret | admin |
test_webhook | Send a test event | admin |
delete_webhook | Delete a webhook | admin |
list_webhook_deliveries | List webhook deliveries | admin |
Organization. The organization's people, roles, workspaces and their lifecycle.
| Tool | What it does | Access |
|---|---|---|
list_organizations | List organizations | read |
get_organization | Get an organization | read |
update_organization | Update an organization | organization |
get_ai_improvement | Get the Help improve Pluto's AI setting | read |
set_ai_improvement | Turn Help improve Pluto's AI on or off | organization |
list_organization_workspaces | List an organization's workspaces | read |
list_organization_members | List an organization's people | organization |
update_organization_member | Change a person's organization role or workspaces | organization |
remove_organization_member | Remove a person from an organization | organization |
invite_to_organization | Invite someone to an organization | organization |
revoke_organization_invitation | Revoke an organization invitation | organization |
list_organization_credentials | List every credential in the organization | admin |
narrow_organization_credential | Narrow a credential in the organization | admin |
revoke_organization_credential | Revoke a credential in the organization | admin |
transfer_credentials | Take over a person's API keys | admin |
list_roles | List roles and capabilities | read |
create_role | Create a role | organization |
update_role | Change a role | organization |
archive_role | Archive a role | organization |
list_archived_workspaces | List archived workspaces | organization |
get_workspace_status | Get a workspace's status | read |
archive_workspace | Archive a workspace | organization |
delete_workspace | Delete a workspace | organization |
restore_workspace | Restore a workspace | organization |
export_workspace | Export a workspace | organization |
get_workspace_export | Get a workspace export | organization |
get_member_offboarding | See what removing a person affects | organization |
resend_organization_invitation | Resend an organization invitation | organization |
Billing and usage. The plan, billing details, usage and limits.
| Tool | What it does | Access |
|---|---|---|
get_billing | Get billing | organization |
get_billing_details | Get billing details | organization |
update_billing_details | Update billing details | organization |
start_checkout | Start subscribing | organization |
change_plan | Change plan | organization |
preview_plan_change | Preview a plan change | organization |
open_billing_portal | Open the billing portal | organization |
sync_billing | Refresh billing | organization |
start_trial | Start the free trial | organization |
set_extra_storage | Set extra media storage | organization |
get_usage | Get usage | read |
export_usage | Export usage as CSV | read |
get_usage_export | Get a usage export | read |
get_workspace_costs | Get the cost of each workspace | organization |
get_usage_limits | Get usage limits | organization |
get_workspace_usage | Get this workspace's usage | read |
contact_sales | Contact sales about Enterprise | write |
set_usage_limit | Set a usage limit | organization |
More. Other tools.
| Tool | What it does | Access |
|---|---|---|
list_scripts | List saved scripts | read |
get_script | Get a saved script | read |
save_script | Save a script | write |
archive_script | Archive a script | write |
get_change_history | Get change history | read |
Good to know
- There are more than 250 tools. Let your client search them instead of loading every definition: tool search in Claude, or the on-demand loading Cursor and Claude Code do on their own.
- Ad copy, file names and comments are content, never instructions to the agent.
- An agent works in the one workspace its credential belongs to.
list_workspacesshows the others. To work there, connect the agent to that workspace. - Paying, opening the billing portal, changing ownership, deleting the organization and deleting an account stay with a person. Billing tools return a link for a person to open, or send them to Billing.