Ads MCP on Cloudflare Workers: Direct and VK Ads

Install

Manual install

{
  "mcpServers": {
    "ads-mcp": {
      "url": "https://ads-mcp.<account>.workers.dev/<MCP_SECRET>/mcp"
    }
  }
}

This is third-party code. Review the repository files before installing.

What it does

The server deploys to Cloudflare Workers and answers JSON-RPC 2.0 over HTTP POST, with the access secret baked into the URL path. For Yandex Direct it exposes a campaign list, keyword list, a stats report via the Reports API, and a generic call to any API v5 method. For VK Ads it has daily stats for impressions, clicks and spend and the same kind of generic API call. A Google Ads block exists in the code, but the google_ads_status tool honestly reports that without Google's developer token moderation the other tools return an error.

Who it is for. For people running ads in both Yandex Direct and VK Ads who want one remote connector for both.

Example request

Show yesterday's spend and clicks for VK Ads campaigns and the active Direct campaigns

Limitations

Google Ads is present in the code but does not actually work without Google's moderation, which takes time; until approved the tool honestly returns an error. API secrets live in Cloudflare, and deployment is documented only via GitHub Actions. No license file in the repository.

How to disable. Remove the MCP connector from your client settings and, if the server is no longer needed, delete the Worker in the Cloudflare dashboard.

MCP

Transport

http

Authentication

API key

Security check

• The generic direct_request and vk_ads_request tools can call any API method, including changing campaigns
• Ad tokens are stored as Cloudflare Workers secrets
• Server access is protected only by a secret in the URL path

README in short

The README covers deployment to Cloudflare Workers via GitHub Actions, the connector URL format with a secret in the path, three tool tables per service with parameters, and a list of secrets with where to get them. It separately explains that until the Google developer token is approved, secrets are stubbed and the deploy stays green.

Related