Search / io.github.gudlab/ads-mcp
ads-mcp
L0· runs locallyMCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.
v0.1.1 · active · repository · descriptor JSON · versions
Search / io.github.gudlab/ads-mcp
L0· runs locallyMCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.
v0.1.1 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/[email protected]"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}",
"GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}",
"GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}",
"GOOGLE_ADS_CUSTOMER_ID": "${GOOGLE_ADS_CUSTOMER_ID}",
"META_APP_ID": "${META_APP_ID}",
"META_APP_SECRET": "${META_APP_SECRET}",
"META_ACCESS_TOKEN": "${META_ACCESS_TOKEN}",
"META_AD_ACCOUNT_ID": "${META_AD_ACCOUNT_ID}"
}
}
}
}claude mcp add ads-mcp -e "GOOGLE_ADS_CLIENT_ID=${GOOGLE_ADS_CLIENT_ID}" -e "GOOGLE_ADS_CLIENT_SECRET=${GOOGLE_ADS_CLIENT_SECRET}" -e "GOOGLE_ADS_DEVELOPER_TOKEN=${GOOGLE_ADS_DEVELOPER_TOKEN}" -e "GOOGLE_ADS_REFRESH_TOKEN=${GOOGLE_ADS_REFRESH_TOKEN}" -e "GOOGLE_ADS_CUSTOMER_ID=${GOOGLE_ADS_CUSTOMER_ID}" -e "META_APP_ID=${META_APP_ID}" -e "META_APP_SECRET=${META_APP_SECRET}" -e "META_ACCESS_TOKEN=${META_ACCESS_TOKEN}" -e "META_AD_ACCOUNT_ID=${META_AD_ACCOUNT_ID}" -- npx -y @gudlab/[email protected][mcp_servers.ads-mcp]
command = "npx"
args = ["-y", "@gudlab/[email protected]"]
env = { "GOOGLE_ADS_CLIENT_ID" = "${GOOGLE_ADS_CLIENT_ID}", "GOOGLE_ADS_CLIENT_SECRET" = "${GOOGLE_ADS_CLIENT_SECRET}", "GOOGLE_ADS_DEVELOPER_TOKEN" = "${GOOGLE_ADS_DEVELOPER_TOKEN}", "GOOGLE_ADS_REFRESH_TOKEN" = "${GOOGLE_ADS_REFRESH_TOKEN}", "GOOGLE_ADS_CUSTOMER_ID" = "${GOOGLE_ADS_CUSTOMER_ID}", "META_APP_ID" = "${META_APP_ID}", "META_APP_SECRET" = "${META_APP_SECRET}", "META_ACCESS_TOKEN" = "${META_ACCESS_TOKEN}", "META_AD_ACCOUNT_ID" = "${META_AD_ACCOUNT_ID}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ads-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@gudlab/[email protected]"
],
"enabled": true,
"environment": {
"GOOGLE_ADS_CLIENT_ID": "{env:GOOGLE_ADS_CLIENT_ID}",
"GOOGLE_ADS_CLIENT_SECRET": "{env:GOOGLE_ADS_CLIENT_SECRET}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "{env:GOOGLE_ADS_DEVELOPER_TOKEN}",
"GOOGLE_ADS_REFRESH_TOKEN": "{env:GOOGLE_ADS_REFRESH_TOKEN}",
"GOOGLE_ADS_CUSTOMER_ID": "{env:GOOGLE_ADS_CUSTOMER_ID}",
"META_APP_ID": "{env:META_APP_ID}",
"META_APP_SECRET": "{env:META_APP_SECRET}",
"META_ACCESS_TOKEN": "{env:META_ACCESS_TOKEN}",
"META_AD_ACCOUNT_ID": "{env:META_AD_ACCOUNT_ID}"
}
}
}
}{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/[email protected]"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}",
"GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}",
"GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}",
"GOOGLE_ADS_CUSTOMER_ID": "${GOOGLE_ADS_CUSTOMER_ID}",
"META_APP_ID": "${META_APP_ID}",
"META_APP_SECRET": "${META_APP_SECRET}",
"META_ACCESS_TOKEN": "${META_ACCESS_TOKEN}",
"META_AD_ACCOUNT_ID": "${META_AD_ACCOUNT_ID}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ads-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBndWRsYWIvYWRzLW1jcEAwLjEuMSJdLCJlbnYiOnsiR09PR0xFX0FEU19DTElFTlRfSUQiOiIke0dPT0dMRV9BRFNfQ0xJRU5UX0lEfSIsIkdPT0dMRV9BRFNfQ0xJRU5UX1NFQ1JFVCI6IiR7R09PR0xFX0FEU19DTElFTlRfU0VDUkVUfSIsIkdPT0dMRV9BRFNfREVWRUxPUEVSX1RPS0VOIjoiJHtHT09HTEVfQURTX0RFVkVMT1BFUl9UT0tFTn0iLCJHT09HTEVfQURTX1JFRlJFU0hfVE9LRU4iOiIke0dPT0dMRV9BRFNfUkVGUkVTSF9UT0tFTn0iLCJHT09HTEVfQURTX0NVU1RPTUVSX0lEIjoiJHtHT09HTEVfQURTX0NVU1RPTUVSX0lEfSIsIk1FVEFfQVBQX0lEIjoiJHtNRVRBX0FQUF9JRH0iLCJNRVRBX0FQUF9TRUNSRVQiOiIke01FVEFfQVBQX1NFQ1JFVH0iLCJNRVRBX0FDQ0VTU19UT0tFTiI6IiR7TUVUQV9BQ0NFU1NfVE9LRU59IiwiTUVUQV9BRF9BQ0NPVU5UX0lEIjoiJHtNRVRBX0FEX0FDQ09VTlRfSUR9In19"
}{
"servers": {
"ads-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gudlab/[email protected]"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}",
"GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}",
"GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}",
"GOOGLE_ADS_CUSTOMER_ID": "${GOOGLE_ADS_CUSTOMER_ID}",
"META_APP_ID": "${META_APP_ID}",
"META_APP_SECRET": "${META_APP_SECRET}",
"META_ACCESS_TOKEN": "${META_ACCESS_TOKEN}",
"META_AD_ACCOUNT_ID": "${META_AD_ACCOUNT_ID}"
}
}
}
}{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/[email protected]"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}",
"GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}",
"GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}",
"GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}",
"GOOGLE_ADS_CUSTOMER_ID": "${GOOGLE_ADS_CUSTOMER_ID}",
"META_APP_ID": "${META_APP_ID}",
"META_APP_SECRET": "${META_APP_SECRET}",
"META_ACCESS_TOKEN": "${META_ACCESS_TOKEN}",
"META_AD_ACCOUNT_ID": "${META_AD_ACCOUNT_ID}"
}
}
}
}extensions:
"ads-mcp":
enabled: true
name: "ads-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "@gudlab/[email protected]"
envs:
"GOOGLE_ADS_CLIENT_ID": "${GOOGLE_ADS_CLIENT_ID}"
"GOOGLE_ADS_CLIENT_SECRET": "${GOOGLE_ADS_CLIENT_SECRET}"
"GOOGLE_ADS_DEVELOPER_TOKEN": "${GOOGLE_ADS_DEVELOPER_TOKEN}"
"GOOGLE_ADS_REFRESH_TOKEN": "${GOOGLE_ADS_REFRESH_TOKEN}"
"GOOGLE_ADS_CUSTOMER_ID": "${GOOGLE_ADS_CUSTOMER_ID}"
"META_APP_ID": "${META_APP_ID}"
"META_APP_SECRET": "${META_APP_SECRET}"
"META_ACCESS_TOKEN": "${META_ACCESS_TOKEN}"
"META_AD_ACCOUNT_ID": "${META_AD_ACCOUNT_ID}"
timeout: 300
Placeholders to fill from your own secret store: ${GOOGLE_ADS_CLIENT_ID}, ${GOOGLE_ADS_CLIENT_SECRET}, ${GOOGLE_ADS_DEVELOPER_TOKEN}, ${GOOGLE_ADS_REFRESH_TOKEN}, ${META_APP_SECRET}, ${META_ACCESS_TOKEN}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns3 advisories of lower severity or without a published fix: GHSA-528h-pc64-c93x in [email protected] (indirect, fixed in 3.5.0), GHSA-hqr4-qq8f-hg3x in [email protected] (indirect, fixed in 3.6.0), GHSA-mjw6-4jj6-33hc in [email protected] (indirect, fixed in 3.6.0)deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or laterdeps.resolvable@gudlab/[email protected] resolved: 209 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured +updated-28d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@gudlab/[email protected] npm208 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19
| advisory | severity | package | fixed in |
|---|---|---|---|
| GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server | high | @modelcontextprotocol/[email protected]MCP SDK, direct | fixed in 1.31.0 |
| GHSA-528h-pc64-c93xstream-json: pick/ignore/filter/replace filters are O(depth²) on nested input — small crafted JSON blocks the event loop for seconds→minutes (DoS) | moderate | [email protected]indirect | fixed in 3.5.0 |
| GHSA-hqr4-qq8f-hg3xstream-json: JSONC parser and verifier re-scan the whole accumulated comment on every input chunk | moderate | [email protected]indirect | fixed in 3.6.0 |
| GHSA-mjw6-4jj6-33hcstream-json has a prototype pollution issue: Assembler writes this.current[this.key] on plain objects | moderate | [email protected]indirect | fixed in 3.6.0 |
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@gudlab/ads-mcp | npm | 0.1.1 | – | GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_REFRESH_TOKEN, META_APP_SECRET, META_ACCESS_TOKEN |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.gudlab/ads-mcp",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.1.1",
"packages": [
{
"version": "0.1.1",
"transport": {
"type": "stdio"
},
"identifier": "@gudlab/ads-mcp",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"environmentVariables": [
{
"name": "GOOGLE_ADS_CLIENT_ID",
"isSecret": true,
"isRequired": true,
"description": "OAuth client ID from Google Cloud Console"
},
{
"name": "GOOGLE_ADS_CLIENT_SECRET",
"isSecret": true,
"isRequired": true,
"description": "OAuth client secret from Google Cloud Console"
},
{
"name": "GOOGLE_ADS_DEVELOPER_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Developer token from Google Ads API Center"
},
{
"name": "GOOGLE_ADS_REFRESH_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Refresh token minted via `pnpm google:auth`"
},
{
"name": "GOOGLE_ADS_CUSTOMER_ID",
"isRequired": true,
"description": "Default Google Ads account ID, 10 digits, no dashes"
},
{
"name": "GOOGLE_ADS_LOGIN_CUSTOMER_ID",
"description": "MCC account ID, only if the customer account is managed under one"
},
{
"name": "META_APP_ID",
"isRequired": true,
"description": "Meta App ID from developers.facebook.com"
},
{
"name": "META_APP_SECRET",
"isSecret": true,
"isRequired": true,
"description": "Meta App secret"
},
{
"name": "META_ACCESS_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Long-lived System User access token with ads_management scope"
},
{
"name": "META_AD_ACCOUNT_ID",
"isRequired": true,
"description": "Default Meta ad account ID, numeric, no act_ prefix"
}
]
}
],
"repository": {
"url": "https://github.com/gudlab/ads-mcp",
"source": "github"
},
"description": "MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns."
}