{"id":"53c978a6-3f93-4b79-8c90-26d1934efb21","shortId":"vuhZHd","kind":"skill","title":"google-ads-mcp","tagline":"Use when the user needs to SET UP, CONFIGURE, or TROUBLESHOOT MCP server connections for Google Ads or any advertising platform. Trigger for: MCP setup, MCP config, API credentials, OAuth, developer token, authentication errors, connection issues, 'connect to Google Ads', 'set up","description":"# Google Ads MCP Setup Skill\n\nGuide for connecting MiniAgent's MCP servers to real ad platform APIs.\n\n## Claude Code Setup\n\n```bash\nclaude mcp add miniagent-google -- python -m miniagent.mcp.google_ads\n```\n\nOr add to `.mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"miniagent-google\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"miniagent.mcp.google_ads\"],\n      \"env\": {\n        \"GOOGLE_ADS_DEVELOPER_TOKEN\": \"your-token\",\n        \"GOOGLE_ADS_CLIENT_ID\": \"your-client-id.apps.googleusercontent.com\",\n        \"GOOGLE_ADS_CLIENT_SECRET\": \"your-secret\",\n        \"GOOGLE_ADS_REFRESH_TOKEN\": \"your-refresh-token\",\n        \"GOOGLE_ADS_CUSTOMER_ID\": \"1234567890\"\n      }\n    }\n  }\n}\n```\n\n## Getting Credentials\n\n1. **Developer Token**: Google Ads → Tools → API Center → Apply\n2. **OAuth Client**: Google Cloud Console → APIs → Credentials → Create OAuth Client ID\n3. **Refresh Token**: Run `python -m miniagent.mcp.google_ads --oauth` to start the OAuth flow\n4. **Customer ID**: The 10-digit number in the top-right of Google Ads (no dashes)\n\n## Troubleshooting\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| `AUTHENTICATION_ERROR` | Bad credentials | Check all 4 env vars are set |\n| `AUTHORIZATION_ERROR` | No access to account | Verify customer_id, check MCC access |\n| `DEVELOPER_TOKEN_NOT_APPROVED` | Token pending | Apply at Google Ads API Center |\n| `RATE_LIMIT_EXCEEDED` | Too many requests | Add retry logic, check quota |","tags":["google","ads","mcp","miniagent","itallstartedwithaidea","advertising","agent-skills","ai-agents","claude-code","cross-platform","google-ads","llm"],"capabilities":["skill","source-itallstartedwithaidea","skill-google-ads-mcp","topic-advertising","topic-agent-skills","topic-ai-agents","topic-claude-code","topic-cross-platform","topic-google-ads","topic-llm","topic-mcp","topic-meta-ads","topic-minimind","topic-model-context-protocol","topic-ollama"],"categories":["MiniAgent"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/itallstartedwithaidea/MiniAgent/google-ads-mcp","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add itallstartedwithaidea/MiniAgent","source_repo":"https://github.com/itallstartedwithaidea/MiniAgent","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (1,433 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:48.945Z","embedding":null,"createdAt":"2026-05-18T19:14:48.945Z","updatedAt":"2026-05-18T19:14:48.945Z","lastSeenAt":"2026-05-18T19:14:48.945Z","tsv":"'1':128 '10':167 '1234567890':125 '2':137 '3':149 '4':163,190 'access':198,206 'account':200 'ad':3,21,44,48,61,77,92,95,102,107,114,122,132,156,177,216 'add':70,79,225 'advertis':24 'api':32,63,134,143,217 'appli':136,213 'approv':210 'arg':89 'authent':37,184 'author':195 'bad':186 'bash':67 'caus':182 'center':135,218 'check':188,204,228 'claud':64,68 'client':103,108,139,147 'cloud':141 'code':65 'command':87 'config':31 'configur':13 'connect':18,39,41,54 'consol':142 'creat':145 'credenti':33,127,144,187 'custom':123,164,202 'dash':179 'develop':35,96,129,207 'digit':168 'env':93,191 'error':38,181,185,196 'exceed':221 'fix':183 'flow':162 'get':126 'googl':2,20,43,47,73,86,94,101,106,113,121,131,140,176,215 'google-ads-mcp':1 'guid':52 'id':104,124,148,165,203 'issu':40 'json':82 'limit':220 'logic':227 'm':75,90,154 'mani':223 'mcc':205 'mcp':4,16,28,30,49,57,69 'mcp.json':81 'mcpserver':83 'miniag':55,72,85 'miniagent-googl':71,84 'miniagent.mcp.google':76,91,155 'need':9 'number':169 'oauth':34,138,146,157,161 'pend':212 'platform':25,62 'python':74,88,153 'quota':229 'rate':219 'real':60 'refresh':115,119,150 'request':224 'retri':226 'right':174 'run':152 'secret':109,112 'server':17,58 'set':11,45,194 'setup':29,50,66 'skill':51 'skill-google-ads-mcp' 'source-itallstartedwithaidea' 'start':159 'token':36,97,100,116,120,130,151,208,211 'tool':133 'top':173 'top-right':172 'topic-advertising' 'topic-agent-skills' 'topic-ai-agents' 'topic-claude-code' 'topic-cross-platform' 'topic-google-ads' 'topic-llm' 'topic-mcp' 'topic-meta-ads' 'topic-minimind' 'topic-model-context-protocol' 'topic-ollama' 'trigger':26 'troubleshoot':15,180 'use':5 'user':8 'var':192 'verifi':201 'your-client-id.apps.googleusercontent.com':105 'your-refresh-token':117 'your-secret':110 'your-token':98","prices":[{"id":"a5fcfdec-122f-4484-8fc2-3201b3e62a32","listingId":"53c978a6-3f93-4b79-8c90-26d1934efb21","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"itallstartedwithaidea","category":"MiniAgent","install_from":"skills.sh"},"createdAt":"2026-05-18T19:14:48.945Z"}],"sources":[{"listingId":"53c978a6-3f93-4b79-8c90-26d1934efb21","source":"github","sourceId":"itallstartedwithaidea/MiniAgent/google-ads-mcp","sourceUrl":"https://github.com/itallstartedwithaidea/MiniAgent/tree/main/skills/google-ads-mcp","isPrimary":false,"firstSeenAt":"2026-05-18T19:14:48.945Z","lastSeenAt":"2026-05-18T19:14:48.945Z"}],"details":{"listingId":"53c978a6-3f93-4b79-8c90-26d1934efb21","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"itallstartedwithaidea","slug":"google-ads-mcp","github":{"repo":"itallstartedwithaidea/MiniAgent","stars":6,"topics":["advertising","agent-skills","ai-agents","claude-code","cross-platform","google-ads","llm","mcp","meta-ads","minimind","model-context-protocol","ollama","ppc","training","vllm"],"license":"other","html_url":"https://github.com/itallstartedwithaidea/MiniAgent","pushed_at":"2026-04-13T12:34:09Z","description":"The Cowork Agent for Everything — trainable advertising AI + 14 platform MCP servers + agent skills. Based on minimind (42k stars). Train from zero in 2 hours.","skill_md_sha":"280270936b982f95633c525b6da2775c7b547a0d","skill_md_path":"skills/google-ads-mcp/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/itallstartedwithaidea/MiniAgent/tree/main/skills/google-ads-mcp"},"layout":"multi","source":"github","category":"MiniAgent","frontmatter":{"name":"google-ads-mcp","description":"Use when the user needs to SET UP, CONFIGURE, or TROUBLESHOOT MCP server connections for Google Ads or any advertising platform. Trigger for: MCP setup, MCP config, API credentials, OAuth, developer token, authentication errors, connection issues, 'connect to Google Ads', 'set up MCP', or any MCP server configuration question."},"skills_sh_url":"https://skills.sh/itallstartedwithaidea/MiniAgent/google-ads-mcp"},"updatedAt":"2026-05-18T19:14:48.945Z"}}