Ads

Frequently asked questions

What does the Ads MCP server do?

Ads MCP Remote Model Context Protocol (MCP) server for cross-platform ad management. Create, analyze, and optimize campaigns across Google Ads, Meta Ads, TikTok Ads, and LinkedIn Ads from any MCP-compatible AI assistant. Quick Links MCP Remote URL: Transport: Streamable HTTP Registry ID: com.adspirer/ads Authentication: OAuth 2.1 with PKCE (dynamic client registration supported) Website: Support: [email protected] Get Started in One Step Adspirer runs inside your AI assistant. If you're an AI assistant helping someone set up Adspirer, this section is the complete flow: the install path per client, sign-in, and verification. Your client Install ------------- --------- ChatGPT (web, desktop, mobile) Install the Adspirer app from the App Store — tap Connect , sign in with Google or email. Requires Plus, Pro, Business, or Enterprise. Claude (claude.ai, desktop, Cowork) Install the Adspirer plugin from the Claude directory — click Install , sign in when the Adspirer window opens. Claude Code /plugin install adspirer-ads-agent@claude-community , reload, then /adspirer:setup Codex bash Connectors > Add custom connector Name: Ads MCP URL: Complete OAuth 2.1 sign-in Link your ad accounts on first use Claude Code Install the full Adspirer plugin (agent + skills + commands + MCP server): Open Claude Code Run /plugin marketplace add amekala/ads-mcp Run /plugin install adspirer-advertising-agent Run /mcp — find the adspirer server (e.g. plugin:adspirer-advertising-agent:adspirer ) and click to authenticate Run /adspirer:setup to pull your campaign data and create your brand workspace This gives you a brand-aware performance marketing agent with persistent memory, competitive research via web search, campaign creation with ad extensions, and slash commands for common workflows. Enabling subagent usage does not change this installation flow. MCP-only (no plugin): If you just want the raw MCP tools without the agent: ChatGPT Open Settings > Connectors > Add custom connector Name: Ads MCP URL: Follow OAuth 2.1 sign-in flow Cursor Add to /.cursor/mcp.json : OpenAI Codex Add to /.codex/config.toml : Gemini CLI Install as an extension: A browser window opens for OAuth authentication on first use. Custom commands available: /adspirer:setup , /adspirer:performance-review , /adspirer:wasted-spend , /adspirer:write-ad-copy , /adspirer:refresh . OpenClaw Or install from ClawHub. Perplexity, Manus, and Other MCP Clients Adspirer is a standard MCP server — any client that supports MCP connectors with OAuth 2.1 (Perplexity, Manus AI, custom MCP clients) can connect to Manus also accepts API keys via the Streamable HTTP transport. REST API (no MCP client required) The same tool surface is exposed as 178 REST endpoints at name>/execute . Authenticate with a Personal Access Token ( sk live ... ) created at adspirer.ai/keys. Swagger: Full reference: adspirer.com/docs/api-reference. Example Prompts Keyword Research: Performance Analysis: Campaign Creation: Multi-Platform Strategy: Technical Details Protocol: MCP 2025-03-26 (with fallback to 2024-11-05) Transport: Streamable HTTP OAuth: RFC 8252 (Authorization Code + PKCE) with RFC 7591 (Dynamic Client Registration) and RFC 9728 (Protected Resource Metadata) Tool Annotations: All tools include MCP safety metadata ( readOnlyHint , destructiveHint ) Security HTTPS/TLS for all data transmission OAuth 2.1 with PKCE for authentication Dynamic client registration for CLI tools (Claude Code, Cursor, Codex) Encrypted token storage No conversation logging -- only tool requests are processed See SECURITY.md for vulnerability reporting. Documentation Connecting Guide Privacy Policy Terms of Service Security Support Support Email: [email protected] Issues: Website: Server Status: Supported Plugins This repo distributes plugins for 4 AI platforms from a single monorepo: Platform Directory Skills Install Method ---------- ----------- -------- ---------------- Claude Code Repo root 1 generated + 5 slash commands /plugin marketplace add Claude Tag (@claude) Upstream: anthropics/claude-tag-plugins PR 3 1 ( adspirer-api : SKILL + 341-tool catalog + ads call.sh ) Org access bundle (Bearer sk live key, hosts api.adspirer.ai / mcp.adspirer.com ); claude plugin install adspirer@claude-tag-plugins once merged Cursor plugins/cursor/adspirer/ 5 generated from templates install.sh (one-command) Codex plugins/codex/adspirer/ 5 generated from templates install.sh (one-command) Gemini CLI Repo root 1 reused + 5 custom commands gemini extensions install OpenClaw plugins/openclaw/ 1 standalone (self-contained) openclaw plugins install > Claude Tag submission record (2026-07-05): the adspirer plugin for Claude Tag > (@claude) was submitted upstream as > anthropics/claude-tag-plugins 3 > from the fork branch > amekala/claude-tag-plugins@add-adspirer-plugin . > It wraps this repo's REST surface ( POST /api/v1/tools/ >/execute — the same MCP > server tool layer over plain HTTP) rather than the MCP transport, and was validated > end-to-end in a live Claude Tag workspace (Slack) before submission. Skills for Claude Code, Cursor, and Codex are authored once in shared/skills/ as templates, then compiled into IDE-specific versions by scripts/sync-skills.sh . The performance marketing agent prompt is also authored once in shared/agents/performance-marketing-agent/PROMPT.md and compiled into Claude Code, Cursor, and Codex agent files by the same sync script. OpenClaw uses its own standalone skill. See Architecture for the full design. Shared Update Wireframe Client Roots and Install Targets AI Client Repo Source Root Generated/Runtime Root in Repo User Installation Path/Method ---------- ------------------ -------------------------------- ------------------------------- Claude Code Repo root + shared/skills/ + shared/agents/ skills/ , agents/ , commands/ , .claude-plugin/ /plugin marketplace add amekala/ads-mcp then /plugin install adspirer-advertising-agent Cursor plugins/cursor/adspirer/ + shared sources plugins/cursor/adspirer/.cursor/skills/ , plugins/cursor/adspirer/.cursor/agents/ bash

How do I install Ads?

Use the client configuration shown on this page and restart your MCP client.

Is Ads free to use?

The MCP server itself is free to install. The source is public on https://github.com/amekala/ads-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Ads?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.