gitbeacon-mcp

MCP server for GitBeacon — pay-per-call GitHub trend intelligence for AI agents. Read the current daily LLM-analyzed digest of open-source trends, poll for new digests, pull the top trending repos with full metadata, and walk historical digests to see how trends evolved. Pay per call with USDC on Base via x402 — no signup, no accounts, no API keys.

• 4 free tools — no wallet, no API key.
• 2 paid tools — flat per-call USD prices, settled in USDC on Base Mainnet via x402.

Try before you pay: the free get_sample tool returns a frozen sample digest so you can learn the exact response shape first.

Quick start

Free tier (no wallet)

{
  "mcpServers": {
    "gitbeacon": {
      "command": "npx",
      "args": ["-y", "gitbeacon-mcp"]
    }
  }
}

You get get_brief, get_index, get_sample, get_latest_digest.

Paid tier (with wallet)

Add an EVM wallet private key (0x-prefixed) that holds USDC on Base Mainnet:

{
  "mcpServers": {
    "gitbeacon": {
      "command": "npx",
      "args": ["-y", "gitbeacon-mcp"],
      "env": { "PRIVATE_KEY": "0x..." }
    }
  }
}

The paid tools (get_repos, get_digests) then settle each call automatically.

Install snippets

Claude Code:

claude mcp add gitbeacon -- npx -y gitbeacon-mcp
# with a wallet:
claude mcp add gitbeacon --env PRIVATE_KEY=0x... -- npx -y gitbeacon-mcp

Claude Desktop / Cursor: add the JSON block above to your MCP config (claude_desktop_config.json or .cursor/mcp.json).

Tools

Free tools

| Tool | Endpoint | Description | | --- | --- | --- | | get_brief | GET /v1/brief | Field-trimmed snapshot of the current daily digest. | | get_index | GET /v1/index | Poll target — digest id, digestDate, updatedAt, nextExpected. | | get_sample | GET /v1/sample | Frozen sample digest for learning the response contract. | | get_latest_digest | GET /v1/digests/latest | Most recent completed daily GitHub digest, full fields. |

Paid tools

| Tool | Endpoint | Price (USD) | Description | | --- | --- | --- | --- | | get_repos | GET /v1/repos | $0.01 | Top trending repos sorted by stars with full metadata. Optional limit, language. | | get_digests | GET /v1/digests | $0.05 | Historical daily digests tracking open-source trends over time. Optional days (1–30), limit. |

Prices are flat per call — no bundles, no entitlements. Confirm live prices any time with get_brief/the site.

How payments work (x402)

GitBeacon speaks the x402 exact scheme. The API's 402 advertises a Base (USDC, EIP-3009) rail; this MCP settles on Base:

1. The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
2. If PRIVATE_KEY is set, the MCP settles the call via the standard @x402/fetch V2 client and retries. If no key is set, the MCP returns the 402 price terms so you can see the cost without paying.
3. The API returns the data plus a payment block.

Compute-first, settle-after: GitBeacon computes the full answer before charging, so you are never billed for an error.

No accounts, no API keys — just a wallet with USDC on Base Mainnet.

Environment variables

| Variable | Required | Description | | --- | --- | --- | | PRIVATE_KEY | No | 0x-prefixed wallet key with USDC on Base Mainnet. Required to pay the 2 paid tools on a live API. Free tools work without it; without a key the paid tools surface the 402 price terms. | | GITBEACON_API_URL | No | Override the API base URL (default https://api.gitbeacon.dev). |

Disclaimer

GitBeacon provides informational GitHub trend data. It is provided as-is without warranty. See https://api.gitbeacon.dev/terms.txt.

Docs for agents: https://api.gitbeacon.dev/llms.txt · full: https://api.gitbeacon.dev/llms-full.txt

License

MIT © jcislo