by amekala
Adspirer — streamline campaign planning, research, and cross-platform ad creation with powerful tools and Google Ads Key
★ 15
GitHub stars
Connects AI assistants to Google Ads, Meta Ads, TikTok Ads, and LinkedIn Ads for campaign creation, keyword research, and performance analysis across platforms.
Adspirer is an official MCP server published by amekala that provides AI assistants with tools and capabilities via the Model Context Protocol. Adspirer — streamline campaign planning, research, and cross-platform ad creation with powerful tools and Google Ads Key It is categorized under developer tools, productivity.
You can install Adspirer in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server supports remote connections over HTTP, so no local installation is required.
MIT
Adspirer is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Add new capabilities to Claude beyond text generation
Example
Access external data sources, execute code, interact with tools and services
Transform Claude from chatbot to action-taking agent
Provide Claude with access to relevant context and data
Example
Load project documentation, access knowledge bases, query databases
Get more accurate, context-aware responses
Automate multi-step workflows combining AI and external tools
Example
Research → Summarize → Create document → Send notification
Complete complex tasks end-to-end without manual steps
Share your MCP server with the developer community
Adspirer is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
Adspirer has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
According to our notes, Adspirer benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
I recommend Adspirer for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
Adspirer reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
Adspirer is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Adspirer reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
Useful MCP listing: Adspirer is the kind of server we cite when onboarding engineers to host + tool permissions.
I recommend Adspirer for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
Strong directory entry: Adspirer surfaces stars and publisher context so we could sanity-check maintenance before adopting.
showing 1-10 of 46
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.
https://mcp.adspirer.com/mcpcom.adspirer/adsSTRATEGY.md and guide all future campaign creation, keyword research, and ad copy across sessions and subagents| Platform | Tools | Capabilities |
|---|---|---|
| Google Ads | 39 | Search campaigns, Performance Max, keyword research, performance analysis, asset management, ad extensions |
| LinkedIn Ads | 28 | Sponsored content, lead gen forms, audience targeting, campaign analytics |
| Meta Ads | 20 | Image campaigns, carousel campaigns, audience targeting, performance tracking |
| TikTok Ads | 4 | In-feed video/image campaigns, asset validation |
| Total | 100+ | Plus 2 resources and 6 prompts |
See CONNECTING.md for detailed setup instructions for each platform.
https://mcp.adspirer.com/mcpInstall the full Adspirer plugin (agent + skills + commands + MCP server):
/plugin marketplace add amekala/ads-mcp/plugin install adspirer/mcp — find plugin:adspirer:adspirer and click to authenticate/adspirer:setup to pull your campaign data and create your brand workspaceThis 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:
claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp
https://mcp.adspirer.com/mcpAdd to ~/.cursor/mcp.json:
{
"mcpServers": {
"adspirer": {
"url": "https://mcp.adspirer.com/mcp"
}
}
}
Add to ~/.codex/config.toml:
[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"
openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect
Or install from ClawHub.
Keyword Research:
Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.
Performance Analysis:
Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?
Campaign Creation:
Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.
Multi-Platform Strategy:
I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.
readOnlyHint, destructiveHint)See SECURITY.md for vulnerability reporting.
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 |
| Cursor | plugins/cursor/adspirer/ | 5 generated from templates | install.sh (one-command) |
| Codex | plugins/codex/adspirer/ | 5 generated from templates | install.sh (one-command) |
| OpenClaw | plugins/openclaw/ | 1 standalone (self-contained) | openclaw plugins install |
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.
Edit once (source of truth)
├─ shared/skills/adspirer-*/SKILL.md
└─ shared/agents/performance-marketing-agent/PROMPT.md
|
v
./scripts/sync-skills.sh
|
+--> Claude Code outputs
| ├─ skills/ad-campaign-management/SKILL.md
| └─ agents/performance-marketing-agent.md
|
+--> Cursor outputs
| ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
| └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
|
+--> Codex outputs
| ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
| └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
|
└--> OpenClaw (standalone, not generated)
└─ plugins/openclaw/SKILL.md
| 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 |
| Cursor | plugins/cursor/adspirer/ + shared sources | plugins/cursor/adspirer/.cursor/skills/, plugins/cursor/adspirer/.cursor/agents/ | bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh) |
| Codex | plugins/codex/adspirer/ + shared sources | plugins/codex/adspirer/skills/, plugins/codex/adspirer/agents/ | bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh) |
| OpenClaw | plugins/openclaw/ | plugins/openclaw/ (standalone, no sync generation) | openclaw plugins install openclaw-adspirer |
If you're contributing to this repo or adding new ad platforms/IDE support:
./scripts/sync-skills.sh # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check # Verify generated files match committed (CI mode)
./scripts/validate.sh # Run all 48 offline validation checks
./scripts/validate.sh --live # Also test MCP endpoint connectivity
Never edit files in plugins/*/skills/, skills/, agents/, or plugins/*/agents/ directly — they will be overwritten by the sync script. Edit templates in shared/skills/ and shared prompts in shared/agents/ instead.
Proprietary -- See Terms of Service for usage terms.
Prerequisites
Time Estimate
15-60 minutes depending on server complexity
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
Model Context Protocol standardizes how AI hosts (Claude, Cursor) communicate with external tools and data sources through server implementations.
Protocols
Compatibility
✓ Use when
Use when you need Claude to access external data, execute actions, or integrate with tools. Best for extending AI capabilities beyond conversation.
✗ Avoid when
Avoid when native integrations exist (use official APIs directly), for real-time critical systems, or when security/compliance requires zero external dependencies.