gitbeacon-mcp
MCP server for GitBeacon — pay-per-call GitHub trendintelligence for AI agents. Read the current daily LLM-analyzed digest of open-sourcetrends, poll for new digests, pull the top trending repos with full metadata, and walkhistorical digests to see how trends evolved. Pay per call with USDC on Base viax402 — 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 canlearn 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 timewith get_brief/the site.
How payments work (x402)
GitBeacon speaks the x402 exact scheme. The API's 402 advertises aBase (USDC, EIP-3009) rail; this MCP settles on Base:
- The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with theaccepted terms.
- If
PRIVATE_KEYis set, the MCP settles the call via the standard@x402/fetchV2client and retries. If no key is set, the MCP returns the 402 price terms so you cansee the cost without paying. - The API returns the data plus a
paymentblock.
Compute-first, settle-after: GitBeacon computes the full answer before charging, soyou 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 withoutwarranty. 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
