# io.github.gudlab/ads-mcp

> MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.

- name: io.github.gudlab/ads-mcp
- version: 0.1.1
- connection class: L0 (run_local_package)
- trust: 91/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.gudlab%2Fads-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.gudlab%2Fads-mcp/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp@0.1.1"
      ],
      "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}"
      }
    }
  }
}
```

Placeholders to fill: `${GOOGLE_ADS_CLIENT_ID}`, `${GOOGLE_ADS_CLIENT_SECRET}`, `${GOOGLE_ADS_DEVELOPER_TOKEN}`, `${GOOGLE_ADS_REFRESH_TOKEN}`, `${META_APP_SECRET}`, `${META_ACCESS_TOKEN}`.

## Trust

- hygiene: 100
- liveness: n/a
- freshness: 100
- provenance: 80
- drivers: +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.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: 50 (weight 15)

- warn `deps.known_vulns`: 3 advisories of lower severity or without a published fix: GHSA-528h-pc64-c93x in stream-json@1.9.1 (indirect, fixed in 3.5.0), GHSA-hqr4-qq8f-hg3x in stream-json@1.9.1 (indirect, fixed in 3.6.0), GHSA-mjw6-4jj6-33hc in stream-json@1.9.1 (indirect, fixed in 3.6.0)
- fail `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 later
- pass `deps.resolvable`: @gudlab/ads-mcp@0.1.1 resolved: 209 packages

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.gudlab/ads-mcp.svg)](https://protogrid.dev/servers/io.github.gudlab/ads-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm @gudlab/ads-mcp@0.1.1: resolved, 208 dependencies, MCP SDK @modelcontextprotocol/sdk 1.30.1
  - GHSA-6qxp-vccf-f47h (high) in `` @modelcontextprotocol/sdk@1.30.1 ``, direct, fixed in `` 1.31.0 ``, advisory summary: "MCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server" https://osv.dev/vulnerability/GHSA-6qxp-vccf-f47h
  - GHSA-528h-pc64-c93x (moderate) in `` stream-json@1.9.1 ``, indirect, fixed in `` 3.5.0 ``, advisory summary: "stream-json: pick/ignore/filter/replace filters are O(depth²) on nested input — small crafted JSON blocks the event loop for seconds→minutes (DoS)" https://osv.dev/vulnerability/GHSA-528h-pc64-c93x
  - GHSA-hqr4-qq8f-hg3x (moderate) in `` stream-json@1.9.1 ``, indirect, fixed in `` 3.6.0 ``, advisory summary: "stream-json: JSONC parser and verifier re-scan the whole accumulated comment on every input chunk" https://osv.dev/vulnerability/GHSA-hqr4-qq8f-hg3x
  - GHSA-mjw6-4jj6-33hc (moderate) in `` stream-json@1.9.1 ``, indirect, fixed in `` 3.6.0 ``, advisory summary: "stream-json has a prototype pollution issue: Assembler writes this.current\[this.key\] on plain objects" https://osv.dev/vulnerability/GHSA-mjw6-4jj6-33hc

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

_none_

## Packages

- npm @gudlab/ads-mcp@0.1.1 secrets: GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_REFRESH_TOKEN, META_APP_SECRET, META_ACCESS_TOKEN

## Tools (0)

_none observed_