Ads Uploader
NPM · @ADSUPLOADER/MCP · 2 COMPONENTS
Meta Ads MCP: analyze, edit and bulk launch Meta ads, with an Agent Inbox for approvals.
Available components
Last scanned (17 hours ago)
Scores higher than 56% of npm servers
Category Marketing and SEO
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 30 of 92 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (UNLICENSED) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 4 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability54
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 15485 tokens (~262/item across 59 items; 59 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage89
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 67% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 60 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 0
- Stability: 0.97 → pass security
- 20 Nov 26 0
- Stability: pass → 0.97 functional
- 17 Nov 26 +10
- Known CVEs: unverified → pass ▲ security
- Dependency health: unverified → 0.85 ▲ functional
- 16 Nov 26 −10
- Stability: pass → unverified ▼ security
- Known CVEs: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Dependency health: 0.85 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: 0.4.2 → 0.4.3 functional
- 15 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 14 Nov 26 −14
- Malware scan: pass → unverified ▼ security
- Stability: 0.97 → pass security
- Schema quality: 368 → 256 ▲ functional
- Package version: 0.4.1 → 0.4.2 functional
- 12 Nov 26 −1
- Stability: pass → 0.93 functional
- 9 Nov 26 0
- Package version: 0.4.0 → 0.4.1 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/@adsuploader/mcp@0.4.3
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 92 packages
| Packages resolved | 92 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ads_campaign_health Campaign Health ~198
Answer “how is campaign X doing”: campaign performance, native optimization results, status, budgets, issues and bounded ad set learning counts. Use ads_query_insights for custom analysis. Result indicators and attribution windows stay separate. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| campaignId | string | – | – |
| datePreset | string | – | Named Meta date preset. Mutually exclusive with timeRange. Defaults to last_30d when neither date option is supplied. |
| fresh | boolean | – | Bypass the read cache. |
| limit | integer | – | – |
| timeRange | object | – | Explicit current date range, mutually exclusive with datePreset. Use compare for a previous period, previous year or custom range. |
No output schema declared.
No examples provided.
ads_cancel_job Cancel Job ~42
Cancel a running ad creation job or media ingest job.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | yes | Ad creation job ID or media ingest job ID (ingest_...). |
No output schema declared.
No examples provided.
ads_create Create Meta Ads ~1,444
Create Meta ads in an ad account from a v1 AdSpec request body or a saved build (buildId). Media comes from an upload batch (uploadId), saved-build mediaItems, copyFromAd or a preset. Existing destinations take campaign.id and adSet.id; campaign.name and adSet.name create new ones. Ad text goes in texts.common or texts.perAd, keyed by file name, as headlines arrays plus bodies and descriptions; CTA fields use Meta enum values such as SHOP_NOW. Supports standard, carousel, flexible and Multi Media ads, partnership ads on uploaded media, Instagram existing-post partnership ads and Product Showcase. ads_preview returns the plan, launch.mode and warnings for the same request, including LAUNCH_GOES_LIVE when create would go straight to Meta. When the account's Launch permission is Allowed, create sends the objects to Meta with the requested status; the local tool watches the job for up to 30 minutes, and a "still_running" result carries a jobId that ads_get_job reads until complete is true. When Launch is Approval, nothing is created: it returns status "approval_required" with a url and buildId, and the launch waits in the Agent Inbox, where runTitle, reviewId and reason place it in an Agent Inbox run. They only take effect when Launch is Approval; with Allowed they are ignored and listed in an IGNORED_FIELD warning. A repeat with the exact same arguments within 10 minutes returns the existing job instead of creating duplicates (the same idempotencyKey extends this to 24 hours); options.allowRepeatLaunch creates the same ads again, and ads_list_history shows what was launched. New campaigns and ad sets with a lifetime budget need an end time at least 24 hours after the start (LIFETIME_BUDGET_END_* otherwise). adSet.advertiser sets EU names (eu) and verified IDs (verified.fromAdSetId or advertiserId) on new ad sets; Singapore/Taiwan needs a verified advertiser; preview reports newAdSets[].advertiser and VERIFIED_ADVERTISER_MISSING.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Ad account ID, e.g. act_123. |
| adNamePattern | string | – | – |
| adNames | object | – | Exact ad names keyed by mediaName. Overrides mediaItems[].customName and adNamePattern. Blank values clear an override; all other whitespace and tokens are literal. |
| adPresetId | string | – | Saved API preset settings and destination. Mutually exclusive with copyFromAd. Omitting a destination reuses the saved campaign/ad set and returns a PRESET_DESTINATION_USED warning. Override with cam… |
| adSet | object | – | – |
| aiDisclosure | boolean | – | – |
| buildId | string | – | Saved build ID. When provided, the build's portable spec is used as the create body. |
| campaign | object | – | – |
| carousel | array | – | Carousel creatives using media names from uploadId or captured mediaItems. A carousel takes one headline and one description; set per-card text with cards[].cardText or cardTexts. Several primary tex… |
| copyFromAd | string | – | Existing Meta ad ID to copy settings from. |
| creativeEnhancements | object | – | – |
| cta | object | – | – |
| flexible | array | – | Flexible-format creatives using media names from uploadId or captured mediaItems. |
| idempotencyKey | string | – | Optional launch key scoped to this user and account for 24 hours, for any client. Reuse it on retries to return the existing job. Without a key, only MCP requests deduplicate identical bodies, for 10… |
| launchBlockers | array | – | Saved-build metadata. Ignored when creating ads. |
| launchable | boolean | – | Saved-build metadata. Ignored when creating ads. |
| mediaItems | array | – | Portable saved-build media metadata. For videos, mediaItems[].mediaId MUST be the numeric Facebook video id from the upload response videoId, not its internal id. videoId is accepted as an alias. lin… |
| multimedia | array | – | Multi Media creatives with optional per-asset public text fields. |
| options | object | – | – |
| productShowcase | object | – | Product Showcase shows products from a catalog under a single image or video ad. Full catalog (dynamic) ads are not supported yet. Omit to inherit the source creative. |
| profile | object | – | – |
| reason | string | – | Launch set to Approval only: one short note for the user explaining why (shown with the launch in their Agent Inbox). Ignored when Launch is Allowed. |
| resetAdNameIndexPerAdSet | boolean | – | Restart the {index} token for ad names in each ad set. |
| reviewId | string | – | Launch set to Approval only: put the held launch in this existing run from ads_edit_preview or ads_duplicate, so the user reviews the launch beside those changes (the changes and the launch run separ… |
| runTitle | string | – | Launch set to Approval only: short name for this run. If the user names the run, use their exact words. Use the same runTitle (or reviewId) as your related ads_edit_preview or ads_duplicate calls so… |
| targeting | object | – | AdSpec-shaped audience override for NEW ad sets: locations, optional age/gender, and one flat OR group of mixed detailed-targeting selections. Omitted fields inherit from the source ad set. Set detai… |
| textPresetId | string | – | Saved text preset ID. Mutually exclusive with texts. |
| texts | object | – | – |
| uploadId | string | – | Upload batch ID returned by ads_upload or ads_get_upload. |
| urlTags | string | – | – |
No output schema declared.
No examples provided.
ads_delete_build Delete Saved Build ~35
Delete one saved build by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| buildId | string | yes | Saved build ID, e.g. build_abc123... |
No output schema declared.
No examples provided.
ads_discard_launch Discard a Waiting Launch ~93
Discard a launch waiting in the Agent Inbox, like its Discard button. Nothing is created in Meta. The saved build stays (ads_delete_build removes it). Launches that already started cannot be discarded. ads_edit_cancel handles edit suggestions.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| buildId | string | yes | Saved build ID of the waiting launch, e.g. build_abc123... |
No output schema declared.
No examples provided.
ads_duplicate Duplicate Campaigns, Ad Sets or Ads ~753
Copy campaigns, ad sets or ads in Ads Uploader, with previews, destination settings and account approvals. Copies stay within one ad account. A deep copy includes children; deepCopy: false copies only the root. Ad sets default to their source campaign and ads to their source ad set. rename supports {name}, {date} (UTC) and {index}; only roots are renamed unless renameChildren is true. Copy roots are PAUSED by default and children keep their source status unless childStatus:PAUSED. overrides change targeting, schedule, budget, bid and ad set settings on the copies. EU-targeted ad set copies need dsa_beneficiary and dsa_payor on the source ad set: Meta checks them at copy time, before overrides apply, and preview warns DSA_PAYOR_REQUIRED when they are missing. ads_duplicate_preview returns the full tree, skipped objects, warnings, executionPlan call counts and a resolvedRequest with a sourceFingerprint; ads_duplicate takes that resolvedRequest. Copies run serially, object by object, so Meta deep-copy child limits (3 synchronous / 51 async) do not apply. Copies follow the account's Agent Launch setting on the Account Permissions page, like launches; Agent Edit does not apply. Allowed starts a job (the hosted tool watches it for about 40 seconds, then returns still_running with a nextStep for ads_get_duplication), Approval returns status "pending_approval" with a reviewUrl and nothing is copied until it is approved in the Agent Inbox, and Off returns AGENT_LAUNCH_DISABLED. acknowledgeWarnings records review of that preview's warnings; ACTIVE copies need confirmSpend:true unless the account approval rule is none. SOURCE_CHANGED means the source, destination or copy intent changed since the preview; SOURCE_GONE and DESTINATION_GONE mean one is missing, deleted or archived. Running ads_duplicate again with the same request creates a second copy. Partial means some objects were created before a later step failed; each failure has stage, error and retry information. reason…
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| acknowledgeWarnings | boolean | – | Records that the warnings listed in the preview of this copy were reviewed. Needed when that preview returned warnings. |
| childStatus | string | – | Child objects inherit their source status by default, even under a PAUSED root. Use PAUSED to pause every copied child. |
| confirmSpend | boolean | – | Confirms that ACTIVE copies may start spending. Needed for ACTIVE copies unless the account approval rule is none. |
| deepCopy | boolean | – | – |
| destination | object | – | – |
| expanded | object | – | Expanded source IDs returned by preview. The server re-reads children at apply. |
| ids | array | yes | – |
| level | string | yes | – |
| options | object | – | – |
| overrides | object | – | – |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). |
| rename | string | – | – |
| renameChildren | boolean | – | – |
| reviewId | string | – | Add this copy to an existing review from ads_edit_preview or an earlier duplicate, so one run is approved together. |
| runTitle | string | – | Short name for this run. If the user names the run, use their exact words. Reuse it with the same reviewId. A run the user renamed keeps their name. |
| sourceFingerprint | string | – | Submit exactly the fingerprint returned by preview; required to apply. |
| status | string | – | – |
No output schema declared.
No examples provided.
ads_duplicate_by_post Duplicate Ads by Post ~775
Duplicate ads while keeping their social proof (likes, comments, shares) by reusing the same Page post; for regular duplication use ads_duplicate. Copies go into an existing ad set (adSetId) or into new ad sets: newAdSet and newAdSetPerAd copy the ad set given in adSetId, which must already be in the destination campaign and may be empty (it needs no ads). For a brand-new empty campaign, first put one ad set in it with no ads (for example ads_duplicate of an ad set with deepCopy:false) and pass that adSetId with newAdSet or newAdSetPerAd, so the ads and their new ad sets are created in the by-post step; the template ad set itself receives no ads. Select ads by Page post ID. Use postIds for discovery or adIds for exact selection, never both. The preview returns sourceCandidates and a pinned resolvedRequest; a post that matches several ads needs adIds, and warned runs need acknowledgeWarnings: true or useCreativeId: true. Copies follow the account's Agent Launch setting on the Account Permissions page, like launches; Agent Edit does not apply. Allowed starts the job, Approval returns status "pending_approval" with a reviewUrl and nothing is copied until it is approved in the Agent Inbox, and Off returns AGENT_LAUNCH_DISABLED. Post-ID copies never require confirmSpend (it is accepted and ignored). reason and runTitle label the copy in the Agent Inbox and reviewId adds it to an existing review. Running it again creates the copies again. The local tool watches the job for up to 30 minutes, and a "still_running" result carries a jobId that ads_get_duplication reads until complete is true.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Meta ad account ID, e.g. act_123. |
| acknowledgeWarnings | boolean | – | Continues past the creative warnings the preview listed. Needed for warned live runs unless useCreativeId is true. |
| adIds | array | – | Ordered exact source ad IDs. Use preview.resolvedRequest to retain the reviewed selection; exclusive with postIds. |
| adNamePattern | string | – | New ad name pattern. Supports {AdName} and {Index}. |
| adSetId | string | – | Required for an existing destination ad set. Optional with newAdSet/newAdSetPerAd: omit to copy the source ad set, or provide a template in campaignId and the selected account. A source without its o… |
| campaignId | string | – | Existing destination campaign ID. |
| confirmSpend | boolean | – | Accepted for older clients and ignored: post-ID copies never require it. |
| newAdSet | object | – | One shared new ad set. Cannot be combined with newAdSetPerAd. |
| newAdSetPerAd | object | – | One new ad set per source ad. Cannot be combined with newAdSet; one source produces one shared clone. |
| paused | boolean | – | Create duplicated ads paused. |
| postIds | array | – | Discover source ads by Page post ID. Multiple matches require an explicit adIds selection; exclusive with adIds. |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). |
| reviewId | string | – | Add this copy to an existing review from ads_edit_preview or an earlier duplicate, so one run is approved together. |
| runTitle | string | – | Short name for this run. If the user names the run, use their exact words. Reuse it with the same reviewId. A run the user renamed keeps their name. |
| useCreativeId | boolean | – | Reuse original creative IDs instead of creating post-reference creatives. |
No output schema declared.
No examples provided.
ads_duplicate_by_post_preview Preview Duplication by Post ~506
Duplicate ads while keeping their social proof (likes, comments, shares) by reusing the same Page post; for regular duplication use ads_duplicate. Previews the copy without creating anything: returns sourceCandidates, a pinned resolvedRequest and a cleaned source-to-destination plan. Select ads by Page post ID. Use postIds for discovery or adIds for exact selection, never both; a post that matches several ads needs adIds.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Meta ad account ID, e.g. act_123. |
| acknowledgeWarnings | boolean | – | Continues past the creative warnings the preview listed. Needed for warned live runs unless useCreativeId is true. |
| adIds | array | – | Ordered exact source ad IDs. Use preview.resolvedRequest to retain the reviewed selection; exclusive with postIds. |
| adNamePattern | string | – | New ad name pattern. Supports {AdName} and {Index}. |
| adSetId | string | – | Required for an existing destination ad set. Optional with newAdSet/newAdSetPerAd: omit to copy the source ad set, or provide a template in campaignId and the selected account. A source without its o… |
| campaignId | string | – | Existing destination campaign ID. |
| confirmSpend | boolean | – | Accepted for older clients and ignored: post-ID copies never require it. |
| newAdSet | object | – | One shared new ad set. Cannot be combined with newAdSetPerAd. |
| newAdSetPerAd | object | – | One new ad set per source ad. Cannot be combined with newAdSet; one source produces one shared clone. |
| paused | boolean | – | Create duplicated ads paused. |
| postIds | array | – | Discover source ads by Page post ID. Multiple matches require an explicit adIds selection; exclusive with adIds. |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). |
| reviewId | string | – | Add this copy to an existing review from ads_edit_preview or an earlier duplicate, so one run is approved together. |
| runTitle | string | – | Short name for this run. If the user names the run, use their exact words. Reuse it with the same reviewId. A run the user renamed keeps their name. |
| useCreativeId | boolean | – | Reuse original creative IDs instead of creating post-reference creatives. |
No output schema declared.
No examples provided.
ads_duplicate_preview Preview Duplication ~754
Copy campaigns, ad sets or ads in Ads Uploader, with previews, destination settings and account approvals. Copies stay within one ad account. A deep copy includes children; deepCopy: false copies only the root. Ad sets default to their source campaign and ads to their source ad set. rename supports {name}, {date} (UTC) and {index}; only roots are renamed unless renameChildren is true. Copy roots are PAUSED by default and children keep their source status unless childStatus:PAUSED. overrides change targeting, schedule, budget, bid and ad set settings on the copies. EU-targeted ad set copies need dsa_beneficiary and dsa_payor on the source ad set: Meta checks them at copy time, before overrides apply, and preview warns DSA_PAYOR_REQUIRED when they are missing. ads_duplicate_preview returns the full tree, skipped objects, warnings, executionPlan call counts and a resolvedRequest with a sourceFingerprint; ads_duplicate takes that resolvedRequest. Copies run serially, object by object, so Meta deep-copy child limits (3 synchronous / 51 async) do not apply. Copies follow the account's Agent Launch setting on the Account Permissions page, like launches; Agent Edit does not apply. Allowed starts a job (the hosted tool watches it for about 40 seconds, then returns still_running with a nextStep for ads_get_duplication), Approval returns status "pending_approval" with a reviewUrl and nothing is copied until it is approved in the Agent Inbox, and Off returns AGENT_LAUNCH_DISABLED. acknowledgeWarnings records review of that preview's warnings; ACTIVE copies need confirmSpend:true unless the account approval rule is none. SOURCE_CHANGED means the source, destination or copy intent changed since the preview; SOURCE_GONE and DESTINATION_GONE mean one is missing, deleted or archived. Running ads_duplicate again with the same request creates a second copy. Partial means some objects were created before a later step failed; each failure has stage, error and retry information. reason…
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| acknowledgeWarnings | boolean | – | Records that the warnings listed in the preview of this copy were reviewed. Needed when that preview returned warnings. |
| childStatus | string | – | Child objects inherit their source status by default, even under a PAUSED root. Use PAUSED to pause every copied child. |
| confirmSpend | boolean | – | Confirms that ACTIVE copies may start spending. Needed for ACTIVE copies unless the account approval rule is none. |
| deepCopy | boolean | – | – |
| destination | object | – | – |
| expanded | object | – | Expanded source IDs returned by preview. The server re-reads children at apply. |
| ids | array | yes | – |
| level | string | yes | – |
| options | object | – | – |
| overrides | object | – | – |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). |
| rename | string | – | – |
| renameChildren | boolean | – | – |
| reviewId | string | – | Add this copy to an existing review from ads_edit_preview or an earlier duplicate, so one run is approved together. |
| runTitle | string | – | Short name for this run. If the user names the run, use their exact words. Reuse it with the same reviewId. A run the user renamed keeps their name. |
| sourceFingerprint | string | – | Submit exactly the fingerprint returned by preview; required to apply. |
| status | string | – | – |
No output schema declared.
No examples provided.
ads_edit_apply Apply Meta Edits ~252
Apply a preview plan to existing Meta objects. Takes the planId from ads_edit_preview (valid for 15 minutes) and the confirm flags named in that preview's requiredConfirmations. Returns a result per change: applied, failed, skipped or pending. Pending means not sent yet and still waiting in its review. Applying the same planId again returns the first result and changes nothing more. Archive and delete cannot be undone. Accounts in review mode return EDITS_REVIEW_REQUIRED with a reviewUrl; those changes are approved in the Agent Inbox.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| allowLargeChange | boolean | – | Confirms a large budget change. Needed when the preview's requiredConfirmations lists large_change. |
| confirmIrreversible | boolean | – | Confirms an archive or delete, which cannot be undone. Needed when the preview's requiredConfirmations lists irreversible. |
| confirmLiveChange | boolean | – | Confirms a change to an object that is live. Needed when the preview's requiredConfirmations lists live_change. |
| confirmSpend | boolean | – | Confirms a change that starts or raises spend. Needed when the preview's requiredConfirmations lists spend. |
| planId | string | yes | – |
No output schema declared.
No examples provided.
ads_edit_cancel Cancel Edit Proposals ~88
Cancel pending edit suggestions so they leave the Agent Inbox. Nothing changes in Meta. Pending suggestions only; returns a result per suggestion. With the older reviewId and duplicatesOnly: true it removes a suggestion that is pending in two reviews.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| duplicatesOnly | boolean | – | – |
| proposalIds | array | – | – |
| reviewId | string | yes | – |
No output schema declared.
No examples provided.
ads_edit_preview Preview Meta Edits ~598
Preview edits to existing Meta campaigns, ad sets and ads without changing Meta: status, archive, delete, name, budget, bid (including minimum ROAS), schedule, spend limit, targeting, ad set settings and set_creative (ad text, links and call to action). At most 10 creative edits per plan. Targeting is patched; ads_search_targeting finds IDs and detail: full returns the full resulting audience. set_creative covers standard, placement-customised, multi-media and carousel creatives, with per-card headline, description and link through cards[{card, headline, description, link}]; per-card links are refused on placement-customised carousels. Flexible, catalog, partnership, language and segment customisations are refused with a reason. To change an image or video, create a new ad in the Uploader. Returns the planned changes, warnings (for example ENGAGEMENT_RESET when likes, comments and shares stay with the old post, or NO_CHANGE when a value already matches Meta), requiredConfirmations and settings: the account's edit mode and approval rule, with settings.launch as the separate permission for new-ad launches. In Apply Directly mode it returns a planId that ads_edit_apply takes for 15 minutes. In review mode it queues the changes in the Agent Inbox and returns reviewId and reviewUrl with no plan; the changes are applied when approved there, and nothingQueued: true means every change already matched. reason and runTitle label the suggestions in the Agent Inbox, and a per-operation reason overrides the top-level reason; reviewId adds them to an existing review, moving identical pending suggestions into it, and without reviewId identical pending suggestions are reused instead of queued twice. idempotencyKey makes a repeated request return the same preview (PREVIEW_IN_PROGRESS while the first is still running). Reviews stay readable for seven days after their last update; ads_list_inbox_history keeps 90 days.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| detail | string | – | Summary by default; full returns changes with details, per-item warnings and any validation performed. |
| idempotencyKey | string | – | Use a unique key for a preview and reuse it after a timeout. Same body replays for 24 hours; a preview still building returns PREVIEW_IN_PROGRESS. |
| operations | array | yes | At most 100 object changes. Money inputs are in account-currency major units. |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). |
| reviewId | string | – | Reuse the reviewId from an earlier preview to group related proposals. Pass it to ads_duplicate or a held ads_create launch to approve them in the same run. |
| runTitle | string | – | Short name for this run. If the user names the run, use their exact words. Reuse it with the same reviewId. A run the user renamed keeps their name. |
No output schema declared.
No examples provided.
ads_edit_undo Preview an Undo ~188
Create a new preview that restores the applied, reversible changes of one edit. It does not apply the undo; the result works like any ads_edit_preview result. Archive and delete return not_reversible. In review mode the undo keeps the original run title and note with an "Undo:" prefix unless runTitle or reason is passed; reviewId adds it to an existing review.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| editId | string | yes | – |
| reason | string | – | One short note for the user explaining why (shown in their Agent Inbox). Defaults to the original note with one "Undo: " prefix. |
| reviewId | string | – | Add the undo to this existing review instead of starting a new one. |
| runTitle | string | – | Optional one-line title for this undo. Defaults to "Undo: " plus the original run title, keeping an existing prefix. |
No output schema declared.
No examples provided.
ads_estimate_delivery Estimate Audience and Delivery ~147
Answer “how big is this audience”: read Meta reach and delivery estimates for AdSpec targeting and an optimization goal. Does not create ads. Estimates are predictions, not guaranteed delivery. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| fresh | boolean | – | Bypass the read cache. |
| optimizationGoal | string | yes | – |
| promotedObject | object | – | – |
| targeting | object | yes | AdSpec targeting shape, converted by the ad-creation builder. Include at least one location. No inherited source targeting is available for estimates. |
No output schema declared.
No examples provided.
ads_fork_build Fork Saved Build ~89
Fork a saved build into a new autosaved draft: a variant with its own build ID, preserving the original build. The fork copies the uploader configuration and media references and can be edited independently. Returns the source build ID and the new build with its url. Each call creates another fork.
| Name | Type | Req | Description |
|---|---|---|---|
| buildId | string | yes | Saved build ID to duplicate, e.g. build_abc123... |
No output schema declared.
No examples provided.
ads_get_account Read Account Details ~134
Read an owned Meta ad account’s status, currency, timezone, spend and funding display. Money includes major amounts and raw minor-unit strings. Includes the read-only metaEdits enabled setting and approval rule, plus permissions (visible, read, launch and edit as off, approval or allowed, approvalRule) from the Account Permissions page; CLI/MCP cannot change them. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| fresh | boolean | – | Bypass the read cache. |
No output schema declared.
No examples provided.
ads_get_ad Get Ad Details ~111
Get one ad with its creative details. For a DISAPPROVED or WITH_ISSUES ad it also returns reviewFeedback (Meta's rejection reasons: global and placementSpecific lists of policy and reason) and issues (errorCode, errorSummary, errorMessage, level), which explain why it is not delivering; null means Meta's reasons could not be read.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| adId | string | yes | Meta ad ID. |
No output schema declared.
No examples provided.
ads_get_build Get Saved Build ~98
Get one saved build by ID with its full spec. The opaque web uploader snapshot webState is included by default; include: ["-webState"] omits it. Other metadata is trimmed for display.
| Name | Type | Req | Description |
|---|---|---|---|
| buildId | string | yes | Saved build ID, e.g. build_abc123... |
| include | array | – | The web uploader session snapshot is included by default. Use -webState to omit it; webState remains accepted. |
No output schema declared.
No examples provided.
ads_get_duplication Get Duplication Status ~99
Get a regular duplicate or duplicate-by-post job by jobId. Returns complete plus the created, failed and skipped objects. A partial job has created objects: created carries newId and the current name, failed carries stage and error.message, and retryable marks a step that can be retried from the Agent Inbox. Pending approvals have no job until they are approved in the Agent Inbox.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | yes | Duplication job ID. |
No output schema declared.
No examples provided.
ads_get_edit Read Edit Results ~52
Read an owned edit and its applied, failed, skipped and pending changes. Pending means not sent yet and still waiting in its review.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| editId | string | yes | – |
No output schema declared.
No examples provided.
ads_get_edit_review Read an Edit Review ~243
Read one owned review with compact proposal rows, statuses and edit IDs. A suggestion shows applying while an approved change is being sent to Meta, then applied or failed. Each row has userEdited {value, note}; when the user changed a suggestion before approving it, suggestedAfter and suggestedReason hold the original suggestion and after and reason hold what the user chose. revisions[] lists each change with who made it, before and after, and restored_to_agent when the original was put back. Duplications include copies[].status (pending, approved, made, partial, failed, rejected), group for split post requests, and summary.copies totals. A partial copy already exists in Meta; its row carries id, currentName, failedStep, a plain error and retry (available, how). Returns 50 proposals by default; paging.after continues and detail: full returns full proposal data.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| after | string | – | Proposal index returned by paging.after. |
| detail | string | – | Compact rows by default. Full includes operations, changes and editable fields. |
| limit | integer | – | – |
| reviewId | string | yes | – |
No output schema declared.
No examples provided.
ads_get_insights_job Get Insights Report Job ~197
Read an Insights report job started by ads_query_insights, by job.id and the same accountId. A running result includes progress and pollAfterSeconds. A completed result is one bounded page; paging.after with this tool returns more rows. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID from the original query. |
| after | string | – | Opaque paging.after cursor from this job's previous page. |
| format | string | – | table returns row arrays in column order, including actionRows. objects returns keyed rows. |
| jobId | string | yes | job.id returned by ads_query_insights. |
| limit | integer | – | Maximum rows; defaults to the original query limit. |
| waitSeconds | number | – | Long-poll duration. Follow pollAfterSeconds while the job is running. |
No output schema declared.
No examples provided.
ads_get_job Get Job Status ~146
Get an ad creation job by jobId. Returns the full result and stage progress by default; compact: true returns an ads summary with created, failed and total counts and progress measured in ads. Includes the last 20 progress.operations (operations: "full" returns all retained ones). A job that is still running has complete: false, and compact running jobs include a nextStep hint.
| Name | Type | Req | Description |
|---|---|---|---|
| compact | boolean | – | Opt in to a compact ads summary. Default false preserves the full result and original stage progress. |
| jobId | string | yes | Ad creation job ID. |
| operations | string | – | Use recent for the last 20 operations or full for the complete operation log. |
No output schema declared.
No examples provided.
ads_get_launch Read Launch Details ~118
Read one Ads Uploader launch: one row per ad with its ID, name, status, ad set, campaign, result and error, plus totals and failures. Use a launchId from ads_list_history rows. detail: 'full' adds targeting, budgets, schedule, creative settings and media.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| detail | string | – | One row per ad by default. Full adds targeting, budgets, schedule, creative settings and media. |
| launchId | string | yes | Launch ID from ads_list_history rows |
No output schema declared.
No examples provided.
ads_get_preset Get Preset ~48
Get one saved preset by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| presetId | string | yes | Ads Uploader preset ID. |
No output schema declared.
No examples provided.
ads_get_product_showcase_recommendation Get Product Showcase Recommendation ~91
Read Meta’s Product Showcase recommendation for a Sales campaign destination: products from a catalog shown under a single image or video ad. MUST_PICK requires an explicit productSetId; MANUAL requires catalog and set selection.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID |
| adUrl | string | yes | – |
| pageId | string | – | – |
| pixelId | string | – | – |
No output schema declared.
No examples provided.
ads_get_upload Get Upload Status ~217
Get a completed upload batch by batchId (or its alias uploadId), or poll a background media-ingest job by jobId until complete is true. Job polls return the full result, progress and file list by default; pass compact:true for counts and failed files only.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Optional ad account ID, e.g. act_123. |
| batchId | string | – | Completed upload batch ID. |
| compact | boolean | – | Opt in to counts and failed files for jobId polls. Default false returns the full result, progress and files. |
| jobId | string | – | Background ingest job ID. Poll until complete is true; the final batch summary is returned in result. |
| uploadId | string | – | Alias for batchId. ads_upload returns batchId; ads_create calls that same batch ID uploadId. The per-file multipart uploads[].uploadId in a presigned ads_upload response is a storage upload ID used b… |
No output schema declared.
No examples provided.
ads_list_accounts List Ad Accounts ~57
List Meta ad accounts available to the authenticated Ads Uploader user. Use refresh to re-check Meta for reinstated/changed accounts (rate limited).
| Name | Type | Req | Description |
|---|---|---|---|
| refresh | boolean | – | Re-check Meta for reinstated/changed accounts (rate limited). |
No output schema declared.
No examples provided.
ads_list_ads List Ads ~498
List ads in an ad set, or across the whole ad account when adSetId is omitted. To find ads by name without knowing their ad set, omit adSetId and pass search (name contains); each row then includes adsetId, adsetName, campaignId and campaignName. status defaults to 'active', so pass 'all' to include paused ads. To see why ads were rejected or have delivery issues, add reviewFeedback and/or issues to fields (Meta's policy reasons and issues_info); they are read only when named in fields. Returns one bounded page; follow paging.after for more. Use fields to return only the columns you need; large pages are trimmed to fit the output budget.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| adSetId | string | – | Meta ad set ID. Omit to list ads across the whole ad account, e.g. to find ads by name with search when the ad set is unknown; each row then includes adsetName, campaignId and campaignName. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fields | array | – | Return only these output columns. id is always returned. status is the configured state; effectiveStatus is the effective delivery state. Either is null when Meta does not provide it. adsetName, camp… |
| fresh | boolean | – | Accepted for compatibility; this list always reads fresh data. |
| limit | integer | – | – |
| offset | integer | – | Offset within the fetched results. Requests fetch up to 500 rows. After budget trimming, use pagination.nextOffset with the same input after; consume remaining rows before following paging.after. |
| search | string | – | Optional ad name search text (name contains). Works with or without adSetId. |
| status | string | – | Exact 'active' filters active/in-process delivery states (default); other values mean no status filter on existing campaign and parent-scoped lists. Without a parent ID, account-wide lists also suppo… |
No output schema declared.
No examples provided.
ads_list_adsets List Ad Sets ~532
List ad sets in a campaign, or across the whole ad account when campaignId is omitted. To find ad sets by name without knowing their campaign, omit campaignId and pass search (name contains); each row then includes campaignId and campaignName. Request regionalRegulationIdentities, regionalRegulatedCategories, dsaBeneficiary or dsaPayor in fields for advertiser details. Identities also return regionalRegulationIdentityNames with Meta names or null. status defaults to 'active', so pass 'all' to include paused ad sets. Returns one bounded page; follow paging.after for more. Use fields to return only the columns you need; large pages are trimmed to fit the output budget.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| campaignId | string | – | Meta campaign ID. Omit to list ad sets across the whole ad account, e.g. to find ad sets by name with search when the campaign is unknown; each row then includes campaignId and campaignName. |
| fields | array | – | Return only these output columns. id is always returned; money fields also keep their Minor twin and currency. status is the configured state; effectiveStatus is the effective delivery state. Either… |
| fresh | boolean | – | Accepted for compatibility; this list always reads fresh data. |
| limit | integer | – | – |
| offset | integer | – | Offset within the fetched results. Requests fetch up to 500 rows. After budget trimming, use pagination.nextOffset with the same input after; consume remaining rows before following paging.after. |
| search | string | – | Optional ad set name search text (name contains). Works with or without campaignId. |
| status | string | – | Exact 'active' filters active/in-process delivery states (default); other values mean no status filter on existing campaign and parent-scoped lists. Without a parent ID, account-wide lists also suppo… |
No output schema declared.
No examples provided.
ads_list_audiences List Audiences ~123
List Meta custom, lookalike and saved audiences, size bounds and safe targeting summaries. One cursor page across sources. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fresh | boolean | – | Bypass the read cache. |
| limit | integer | – | – |
| search | string | – | – |
| type | string | – | – |
No output schema declared.
No examples provided.
ads_list_builds List Saved Builds ~89
List saved uploader build summaries for the authenticated user, optionally filtered by ad account. Returns metadata, warning codes, totalAdSets/totalAds/complete from display, and mediaCount. Use ads_get_build for full detail.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Optional ad account ID filter, e.g. act_123. |
| limit | integer | – | – |
| offset | integer | – | – |
No output schema declared.
No examples provided.
ads_list_campaigns List Campaigns ~284
List campaigns in an ad account, optionally filtered by name search and status. Search matches campaign names only; to find ad sets or ads by name, call ads_list_adsets or ads_list_ads without a parent ID. Use fields to return only the columns you need; large pages are trimmed to fit the output budget.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fields | array | – | Return only these output columns. id is always returned; money fields also keep their Minor twin and currency. status is the configured state; effectiveStatus is the effective delivery state. Either… |
| fresh | boolean | – | Accepted for compatibility; this list always reads fresh data. |
| limit | integer | – | – |
| offset | integer | – | Offset within the fetched results. Requests fetch up to 500 rows. After budget trimming, use pagination.nextOffset with the same input after; consume remaining rows before following paging.after. |
| search | string | – | Optional campaign name search text. |
| status | string | – | Exact 'active' filters active/in-process delivery states (default); other values mean no status filter on existing campaign and parent-scoped lists. |
No output schema declared.
No examples provided.
ads_list_catalogs List Catalogs ~56
List catalogs this ad account can advertise for Product Showcase: products from a catalog shown under a single image or video ad. Full catalog (dynamic) ads are not supported yet.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID |
No output schema declared.
No examples provided.
ads_list_change_history Read Meta Change History ~203
Meta ad account activity log, including edits made in Ads Manager and other tools. Use ads_list_history for launches and changes made through Ads Uploader. Defaults to the last 7 days; maximum span 90 days. Rows carry objectType AD/AD_SET/CAMPAIGN/AUDIENCE/ACCOUNT plus adSetId/campaignId/audienceId; metaObjectType and extra_data keep Meta’s legacy names (extra_data.campaign_id on an ad is its ad set). A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fresh | boolean | – | Bypass the read cache. |
| limit | integer | – | – |
| objectId | string | – | – |
| since | string | – | – |
| until | string | – | – |
No output schema declared.
No examples provided.
ads_list_conversions List Conversion Definitions ~115
Read pixels, custom conversion definitions and standard event names. This describes available events, not measured conversion totals. Pixels and custom conversions share one bounded cursor page. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fresh | boolean | – | Bypass the read cache. |
| limit | integer | – | – |
No output schema declared.
No examples provided.
ads_list_edit_reviews List Edit Reviews ~79
Read compact account-scoped Edit Review counts, including reviews still being built. Proposals are omitted unless include: proposals.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| after | string | – | – |
| include | string | – | By default returns compact review counts without proposals. Request proposals for the full proposal list. |
| limit | integer | – | – |
No output schema declared.
No examples provided.
ads_list_edits List Edit History ~56
Deprecated: use ads_list_history with type changes. Reads one account-scoped cursor page of Ads Uploader edit history.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | – |
| after | string | – | – |
| limit | integer | – | – |
No output schema declared.
No examples provided.
ads_list_history Read Ads Uploader History ~138
Ads Uploader History: launches and changes made through Ads Uploader (web Uploader, Duplicator, AI Edits, CLI, MCP, API) on one ad account, newest first: the same list as the History page. Duplicator copies read type Duplicate, with duplicate: copy or post. Not Meta's activity log.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID |
| before | string | – | – |
| days | integer | – | – |
| limit | integer | – | – |
| member | string | – | – |
| q | string | – | – |
| source | string | – | – |
| type | string | – | – |
No output schema declared.
No examples provided.
ads_list_inbox_history Read Agent Inbox History ~379
Read retained Agent Inbox suggestions and direct edit outcomes over the last 90 days, newest first. Includes reason, reasonEdited, runTitle, clientName, before/after, outcome and a plain error, plus userEdited {value, note} with the agent’s own suggestedAfter and suggestedReason when the user changed them (for example, you suggested 6000 and the user changed it to 6100), and revisions[]: every later change, oldest first, with at, by (user or agent, plus source and clientName), kind (value or note), action (edited, or restored_to_agent when your original was put back), field, before and after; revisedAt is the latest. Partial duplicates also include failedStep. Filter by accountId, campaignId, since/until, reviewId (run), status, kind or action; use paging.cursor with the same filters for more. Time is resolution time when present, otherwise suggestion creation time. waiting includes applying; failed includes partial outcomes. Direct edit campaign filters match campaign IDs recorded with those edits. Read permission is required and hidden accounts are excluded. Does not call Meta or change anything.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Ad account ID; omit to use the selected account or, if none is selected, all permitted accounts. |
| action | string | – | – |
| campaignId | string | – | – |
| cursor | string | – | Use paging.cursor from the previous page with the same filters. |
| kind | string | – | – |
| limit | integer | – | – |
| reviewId | string | – | Filter to one agent run. |
| since | string | – | Inclusive ISO date or timestamp, within the retained 90-day window. |
| status | string | – | – |
| until | string | – | Inclusive ISO date or timestamp. A date includes that whole UTC day. |
No output schema declared.
No examples provided.
ads_list_insight_fields List Insight Fields ~248
Discover Ads Insights fields by search, group or ids. Without filters, returns a compact group index and recommended fields. accountId adds the custom conversions of that account. Breakdown IDs belong in ads_query_insights.breakdowns, not fields. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Optional account for custom conversion definitions. Omit for static discovery without account access. |
| group | string | – | Optional exact catalog group such as delivery, conversions, video, identity, breakdown, or date. |
| ids | array | – | Exact field IDs whose full entries to return. |
| kind | string | – | Optional catalog kind. Use breakdown to discover values for query.breakdowns, not query.fields. |
| limit | integer | – | Maximum catalog entries to return in this offset-based page. |
| offset | integer | – | Zero-based catalog offset for the next field-catalog page. |
| recommended | boolean | – | When true, return only catalog entries recommended for common reporting queries. |
| search | string | – | Optional text matched against supported field IDs, labels, kinds, and groups. |
No output schema declared.
No examples provided.
ads_list_library_media List Meta Library Media ~114
Read images or videos in the Meta ad account library, separate from Ads Uploader uploads. Returns one cursor page. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fresh | boolean | – | Bypass the read cache. |
| limit | integer | – | – |
| type | string | yes | – |
No output schema declared.
No examples provided.
ads_list_pages List Facebook Pages ~60
List Facebook Pages (with their connected Instagram accounts) available for profile overrides in an ad account.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| limit | integer | – | – |
| offset | integer | – | – |
No output schema declared.
No examples provided.
ads_list_posts List Promotable Posts ~135
Read accessible Facebook Page promotable posts or media for a connected Instagram professional account. Supply exactly one of pageId or igUserId. Messages are limited to 500 characters. A 429 carries Retry-After. ROW_QUOTA_EXCEEDED carries the time the quota resets (meta.quota.resetsAt).
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID. |
| after | string | – | Opaque paging.after cursor. Keep filters unchanged. |
| fresh | boolean | – | Bypass the read cache. |
| igUserId | string | – | – |
| limit | integer | – | – |
| pageId | string | – | – |
No output schema declared.
No examples provided.
ads_list_presets List Presets ~61
List saved API or ad text presets for an ad account.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| limit | integer | – | – |
| offset | integer | – | – |
| type | string | – | – |
No output schema declared.
No examples provided.
ads_list_product_sets List Product Sets ~68
List product sets and sample products for Product Showcase: products from a catalog shown under a single image or video ad. Optionally select one product set.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID |
| catalogId | string | yes | – |
| productSetId | string | – | – |
No output schema declared.
No examples provided.
ads_list_uploads List Upload Batches ~52
List recent media upload batches for an ad account.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | yes | Ad account ID, e.g. act_123. |
| limit | integer | – | – |
| offset | integer | – | – |
No output schema declared.
No examples provided.
ads_preview Preview Ad Creation ~1,142
Preview what ads_create would do for a v1 AdSpec request or saved build, without creating ads. Takes the same inputs as ads_create: existing destinations take campaign.id and adSet.id, and ad text takes headlines arrays. Returns the planned campaigns, ad sets and ads, newAdSets with the exact settings each new ad set would get (targeting, placements, attribution, optimization, pixel and event, bid, budget), warnings (blocking: true marks the ones create rejects), lifetimeBudget when it applies, a resolvedSpec and launch.mode. launch.mode allowed means create sends objects straight to Meta, and the preview then carries a LAUNCH_GOES_LIVE warning; approval means create is held in the Agent Inbox. On ads_create, reviewId, runTitle and reason only take effect when Launch is Approval. For partnership ads it resolves posts and checks Meta permissions with read and validate-only calls and returns per-ad creators, sponsors and authorization status; ad codes are not stored, so create takes them again. Preset-only requests reuse the preset's campaign and ad set and carry a PRESET_DESTINATION_USED warning. productShowcase previews return the selected catalog and product set. adSet.advertiser sets EU names (eu) and verified IDs (verified.fromAdSetId or advertiserId) on new ad sets; Singapore/Taiwan needs a verified advertiser; preview reports newAdSets[].advertiser and VERIFIED_ADVERTISER_MISSING.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Ad account ID, e.g. act_123. |
| adNamePattern | string | – | – |
| adNames | object | – | Exact ad names keyed by mediaName. Overrides mediaItems[].customName and adNamePattern. Blank values clear an override; all other whitespace and tokens are literal. |
| adPresetId | string | – | Saved API preset settings and destination. Mutually exclusive with copyFromAd. Omitting a destination reuses the saved campaign/ad set and returns a PRESET_DESTINATION_USED warning. Override with cam… |
| adSet | object | – | – |
| aiDisclosure | boolean | – | – |
| buildId | string | – | Saved build ID. When provided, the build's portable spec is used as the create body. |
| campaign | object | – | – |
| carousel | array | – | Carousel creatives using media names from uploadId or captured mediaItems. A carousel takes one headline and one description; set per-card text with cards[].cardText or cardTexts. Several primary tex… |
| copyFromAd | string | – | Existing Meta ad ID to copy settings from. |
| creativeEnhancements | object | – | – |
| cta | object | – | – |
| flexible | array | – | Flexible-format creatives using media names from uploadId or captured mediaItems. |
| idempotencyKey | string | – | Optional launch key scoped to this user and account for 24 hours, for any client. Reuse it on retries to return the existing job. Without a key, only MCP requests deduplicate identical bodies, for 10… |
| launchBlockers | array | – | Saved-build metadata. Ignored when creating ads. |
| launchable | boolean | – | Saved-build metadata. Ignored when creating ads. |
| mediaItems | array | – | Portable saved-build media metadata. For videos, mediaItems[].mediaId MUST be the numeric Facebook video id from the upload response videoId, not its internal id. videoId is accepted as an alias. lin… |
| multimedia | array | – | Multi Media creatives with optional per-asset public text fields. |
| options | object | – | – |
| productShowcase | object | – | Product Showcase shows products from a catalog under a single image or video ad. Full catalog (dynamic) ads are not supported yet. Omit to inherit the source creative. |
| profile | object | – | – |
| resetAdNameIndexPerAdSet | boolean | – | Restart the {index} token for ad names in each ad set. |
| targeting | object | – | AdSpec-shaped audience override for NEW ad sets: locations, optional age/gender, and one flat OR group of mixed detailed-targeting selections. Omitted fields inherit from the source ad set. Set detai… |
| textPresetId | string | – | Saved text preset ID. Mutually exclusive with texts. |
| texts | object | – | – |
| uploadId | string | – | Upload batch ID returned by ads_upload or ads_get_upload. |
| urlTags | string | – | – |
No output schema declared.
No examples provided.
How do I install the Ads Uploader MCP server?
Ads Uploader runs locally as an npm package, launched with npx -y @adsuploader/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @adsuploader/mcp
claude mcp add com-adsuploader-mcp -- npx -y @adsuploader/mcp
What is the Ads Uploader MCP server?
Ads Uploader is an MCP server listed in the public MCP registry as com.adsuploader/mcp. Meta Ads MCP: analyze, edit and bulk launch Meta ads, with an Agent Inbox for approvals. This page covers its npm package (@adsuploader/mcp).
Is the Ads Uploader MCP server safe to use?
Ads Uploader scores 77 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Ads Uploader MCP server expose?
Ads Uploader exposes 59 tools: ads_report_issue, ads_request_feature, ads_list_catalogs, ads_list_product_sets, ads_get_product_showcase_recommendation, and 54 more. Their descriptions and schemas cost roughly 15,232 tokens of context every time the server is loaded.
Is the Ads Uploader MCP server still maintained?
Ads Uploader is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Ads Uploader MCP server under?
Ads Uploader declares the UNLICENSED licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.
What did VerifyMCP test on the Ads Uploader MCP server?
VerifyMCP ran 16 checks on Ads Uploader, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.