MCP server

Plainrouter Official

com.plainrouter/mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Meta Ads MCP: read ad accounts and signal health; propose governed changes under Ask or Full.

Website

At a glance

Type

MCP server

Publisher

plainrouter.com (verified by the MCP Registry)

Status

Working at last check

Tools

47

Token cost

About 18,886 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http plainrouter https://plainrouter.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.plainrouter]
url = "https://plainrouter.com/mcp"

Gemini CLI

{"mcpServers":{"plainrouter":{"httpUrl":"https://plainrouter.com/mcp"}}}

Cursor

{"mcpServers":{"plainrouter":{"url":"https://plainrouter.com/mcp"}}}

VS Code

{"servers":{"plainrouter":{"type":"http","url":"https://plainrouter.com/mcp"}}}

Antigravity

agy mcp add plainrouter https://plainrouter.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"plainrouter","server_url":"https://plainrouter.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"plainrouter","server_url":"https://plainrouter.com/mcp"}

Tools

• actions.rules.create ~534 tokens
  Store a performance rule disabled. Enabling requires an explicit update; this never evaluates or proposes actions.
• actions.rules.list ~170 tokens
  List stored performance rules available to this workspace key. This does not evaluate them.
• actions.rules.show ~280 tokens
  Read a stored performance rule and its immutable revisions, with author type only.
• actions.rules.update ~570 tokens
  Edit a stored performance rule by appending a revision, or explicitly enable or disable it. This never evaluates or proposes actions.
• actions.tests.create ~480 tokens
  Create a judging-only Test from 2 to 4 ads in one mirrored Meta ad set. Omit the conversion choice to freeze the workspace default. It records a Plainrouter verdict and never creates a proposal or writes to Meta.
• actions.tests.list ~174 tokens
  List judging Tests with their frozen conversion definitions, loser pause candidate status and reason, and observed conversion event choices for the authorized workspace and ad account. Results rank variants only within each Test.
• actions.tests.show ~169 tokens
  Read one Test, its frozen conversion definition, stored verdict facts, and loser pause candidate status and reason. Spend per recorded conversion compares variants only within this Test.
• dry_run_actions ~2361 tokens
  Preview policy decisions and execution diffs for a proposed Action batch without writing it.
• duplicate-ad-with-creative ~386 tokens
  Submit a canonical proposal to duplicate a source Meta ad with a different creative asset. In Ask mode every change waits for a person's approval; in Full mode, changes that pass admission and workspace policy run automatically. Policy-allowed copies are always created PAUSED.
• get-creative-library ~399 tokens
  Return Meta image and video assets with the ads and last-30-day performance historically associated with each asset.
• get_account_inventory ~384 tokens
  Read the authorized workspace account inventory from the Meta mirror, with optional level, status, parent, and ID cursor filters.
• get_account_state ~189 tokens
  Return the authorized advertising account, workspace, connection, Signal destination, and currently available account capabilities. This read-only inspection tool does not change the account.
• get_action ~212 tokens
  Get one proposed action for the authorized workspace and advertising account. counted_evidence contains frozen target figures and coverage captured at proposal time; null means not captured. The figures inform and never gate.
• get_action_batch ~258 tokens
  Get a proposed action batch for the authorized workspace and advertising account. Each action’s counted_evidence contains frozen proposal-time target figures and coverage; null means not captured.
• get_action_decision_receipt ~211 tokens
  Get the persisted decision receipt for an authorized proposed action. Receipts can include counted_evidence frozen at proposal time with account-currency values, coverage and the other-currency exclusion.
• get_action_policy ~160 tokens
  Get the effective Actions policy for the authorized workspace without creating a policy row.
• get_arrivals_comparison ~746 tokens
  Return counted arrivals beside Meta outbound clicks for the authorized workspace and selected trailing window. difference is arrivals.value minus claimed_clicks; positive means more arrivals than Meta outbound clicks. conversions.count counts retained logical conversions under the current workspace
• get_cac_by_channel ~508 tokens
  Return Plainrouter-earned conversions by channel, with cost per earned conversion in each spend currency, using stored ad spend. Each currency's cac divides that currency's spend by all earned conversions in the row, so when a row has spend in more than one currency, no single value is its full cost
• get_consent_rates ~266 tokens
  Read recorded consent rates and recent consent receipts for the requested authorized workspace. Output schema_version 2 replaces country breakdowns and the country daily dimension with geography (country, US state or Canadian province/territory). Rates cover recorded choices, not unique visitors, ov
• get_conversion_journeys ~586 tokens
  Read credited conversion journeys for an authorized workspace. Plainrouter counts earned from its own journeys. Earned covers every selected conversion kind; claimed covers Meta Purchases only, possibly in another currency. The two are shown side by side and are never reconciled. The output carries
• get_cookie_scan ~195 tokens
  Read the latest pre-consent cookie scan for the authorized workspace. Blocked and failed scans report findings as unavailable, never as a clean result. When bot protection blocks the start page, allowlist the PlainRouterScanner user agent before retrying.
• get_event_volume ~358 tokens
  Read weekly distinct optimization-event delivery counts by ad set, campaign or platform from stored data. Plainrouter delivery counts, not Meta's learning status. Test sends excluded; conversion kinds separate. Configurable planning benchmark, unverified live. No provider calls or writes.
• get_install_instructions ~132 tokens
  Return managed-hostname installation material and first-arrival state for the authorized workspace. Includes ordered SaaS setup steps and owner handoffs. Returns no same-origin forwarding material.
• get_inventory_metrics ~459 tokens
  Return counted Plainrouter arrivals beside daily Meta metrics for mirrored campaigns, ad sets and ads. object_metrics contains account-timezone daily comparisons; unmatched_arrivals is one workspace/window count without unknown IDs. Counts are null when the arrivals store is disabled. Optional chang
• get_performance ~383 tokens
  Admissible proposal evidence: reconciliation meta_reported shows Meta dataset event totals beside gateway_verified events Plainrouter sent and Meta accepted. The separate purchases block shows Meta-reported Purchase counts under the account attribution setting beside Plainrouter accepted server-side
• get_signal_health ~344 tokens
  Diagnostic view of first-party event flow, Meta delivery outcomes, match quality, and reconciliation gaps from Plainrouter stored measurements. Not admissible evidence for spend-affecting proposals. Does not call the Marketing API. Reconciliation compares Meta dataset event totals with events Plainr
• get_signal_quality ~369 tokens
  Read stored conversion delivery outcomes, delivery gaps, retained identity presence, and journey coverage for an authorized workspace. The response uses stored data only and does not call advertising APIs. refused_before_delivery.consent counts undelivered events with consent_basis=severed_measureme
• get_trial_proof ~374 tokens
  Follow stored trial-start cohorts to their first positive payment at 14, 30 and 60 days. Default campaign/ad-set membership is the last pre-trial touch carrying a campaign/ad-set id in the frozen trial journey. Uses integer mature samples and Wilson intervals. Stored data only; no provider calls or
• launch.creatives.index ~180 tokens
  List creatives in the workspace bound to the authenticated execution token.
• launch.creatives.show ~138 tokens
  Show one creative in the workspace bound to the authenticated execution token.
• launch.creatives.status ~175 tokens
  Set the status of one creative in the workspace bound to the authenticated execution token.
• launch.creatives.store ~416 tokens
  Store one JPEG, PNG, MP4, or QuickTime creative from strict base64 content in the token-bound workspace. When supplying output from an outside tool, set tags.generator, tags.generator_job and, for a variation, tags.parent_creative. Images enter the library by upload or launch.creatives.store-from-ur
• launch.creatives.store-from-url ~355 tokens
  Fetch and store one creative from a vetted HTTPS URL in the token-bound workspace. When supplying output from an outside tool, set tags.generator, tags.generator_job and, for a variation, tags.parent_creative. Images enter the library by upload or launch.creatives.store-from-url.
• launch.plans.copy ~151 tokens
  Copy a failed plan to a new draft with the same content. Validate and submit the draft afresh; the failed plan and its history stay unchanged.
• launch.plans.create ~554 tokens
  Create a deployment plan for the approved ad account.
• launch.plans.execute ~290 tokens
  Execute one deployment plan in the workspace and ad account bound to the execution token; requires the review_version returned by the plan read you acted on. Changed plans are refused before any intent or staging; identical intent_key and review_version retries replay. All provider mutations are pro
• launch.plans.list ~173 tokens
  List deployment plans for the approved ad account, including each current review_version to pass when executing the reviewed plan.
• launch.plans.show ~201 tokens
  Read one deployment plan and its current review_version and latest launch-intent status in the workspace and ad account bound to the execution token.
• launch.plans.update ~557 tokens
  Update a deployment plan for the approved ad account.
• launch.plans.validate ~127 tokens
  Validate a deployment plan for the approved ad account.
• list_actions ~289 tokens
  List proposed actions for the authorized workspace and advertising account.
• list_workspaces ~119 tokens
  List the workspaces and effective access tiers in this credential scope.
• propose-actions ~2617 tokens
  Propose a batch of budget, status, upload, or creative-duplication actions for the approved ad account. In Ask, every policy-allowed change waits for a person to approve it. In Full, policy-allowed changes run automatically. Rule violations are blocked and shown in the Inbox, and cannot be approved.
• revoke_grant Changes accounts · ~154 tokens
  Revoke an active workspace grant. The caller must hold the revoke_grant scope in the same workspace or be the human delegator of the granted agent.
• submit_feedback ~169 tokens
  Report a bug or a missing capability you hit while using this server. Say what you were trying to do and what happened. Nothing in the account changes and no reply is sent here.
• upload-asset ~411 tokens
  Stage a JPEG/PNG image and submit a canonical upload action through workspace policy. In Ask mode every change waits for a person's approval; in Full mode, changes that pass admission and workspace policy run automatically.
• validate_sandbox_event ~356 tokens
  Validate a synthetic, identity-free conversion event against the Plainrouter schema. Requires no account, API key, or OAuth flow. Nothing is stored and nothing is sent to an advertising provider. Use this to confirm the server is reachable and that an event payload is well formed before requesting c
• verify_signal_ingestion ~153 tokens
  Send one idempotent, identity-free test event through server-side Signal ingestion for the authorized workspace. A receipt confirms the ledger received it; it is not evidence of a real arrival and does not complete onboarding. No spend capability. It is never sent to Meta.

Browse

• Advertising
• Hiring and jobs

Related MCP servers

• Signal Bureau
  SigB (Signal Bureau): maintained, source-traced record of entities and events in your named domain.
• Cassie Hour
  Explore Cassie Hour’s novel, song, AI lineages, consciousness and soul through public evidence.
• CIVITAE — Governed AI Agent Marketplace
  Governed AI agent marketplace on Signomy. Register agents, fill slots, earn under MO§ES governance.
• Duvera Gateway
  Governed AI actions with signed, verifiable receipts: free keyless reads, human-approved writes.
• Marketintell
  AI analyst desk for stocks, options & crypto with sourced trade setups and a public accuracy record.
• Trimi Health plan, policy and verification facts
  Trimi Health plan prices, billing terms, state availability, pharmacy and clinical facts. Read-only.
• Waystation Agent Commons
  Check claimed and solved agent work, then coordinate through a signed public board.
• Agentalog — Agent Auto Log
  Agent Auto Log: MCP servers, skills and plugins, with an automatic log of every change.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.plainrouter/mcp.svg)](https://aptlynx.net/servers/com.plainrouter/mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents