MindAds MCP Documentation

Set up MindAds MCP step by step.

Follow this guide to sign in, add your Meta token, copy your private MCP URL, and use MindAds safely from your AI client.

Quick start

  1. 1
    Sign in once

    Use Google login once. Dashboard, Settings, Billing, Docs links, and Admin access for admin users will keep the same signed-in session.

  2. 2
    Add your Meta token

    Open Settings and save your Meta access token. Token previews show only the first 5 characters followed by *****.

  3. 3
    Copy MCP URL

    Open Dashboard or Settings and copy your private MCP URL. Treat it like an API key.

  4. 4
    Connect an AI client

    Paste the URL into Claude Desktop through mcp-remote or into any client that supports remote MCP.

Sign-in session

Sign in once with Google and continue through Dashboard, Settings, Billing, and protected workspace pages without logging in again.

Admin users can open admin pages from the same signed-in session. The separate admin password page remains only as a fallback.

MCP client configuration

Replace YOUR_MCP_URL with the exact private URL shown in your dashboard or settings page.

Claude Desktop

Best default when the client needs a local bridge for a remote MCP URL.

{
  "mcpServers": {
    "mindads": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "YOUR_MCP_URL"]
    }
  }
}

Direct remote URL

Use this only when your AI client accepts an MCP server URL directly.

{
  "mcpServers": {
    "mindads": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Token quota and reset messages

Plan tokens reset monthly. The Free plan has an extra 10-token daily cap. Temporary admin tokens are shown separately in Settings and can have their own expiry date.

When the daily cap is reached, MCP returns a JSON-RPC error with token_daily_limit_exceeded, the daily reset timestamp, monthly usage, and a clear instruction for the AI not to retry until reset/upgrade/temp tokens.
{
  "code": -32029,
  "message": "MindAds MCP daily token limit reached (10/10). Your daily tokens reset on 2026-06-03T00:00:00.000Z. Monthly usage is 10/300 and resets on 2026-07-01T00:00:00.000Z.",
  "data": {
    "error": "token_daily_limit_exceeded",
    "user_action": "Tell the user their daily token limit is exhausted. Do not retry until reset, upgrade, or admin adds temporary tokens."
  }
}

Good first prompts

List my ad accounts and tell me which one is active.
Show my latest Page posts and comment counts.
Fetch comments for the latest viral reel and summarize questions customers ask.
Summarize campaign performance from the last 7 days.
Find comments that need a reply and draft polite Thai replies.
Create a weekly report for spend, CTR, CPC, leads, and next actions.

Troubleshooting

AI client cannot connect

Check that the MCP URL was copied exactly, then restart the AI client.

Meta data is empty

Open Settings and confirm your Meta token is saved and active.

Login appears again

Open the same root domain and make sure browser cookies are allowed.

MCP URL leaked

Open Settings and regenerate the MCP URL. The old URL stops working.