{"_id":"@carbon-cashmere/x402-mcp","_rev":"4-f32426364d21f5fd732124a5517e0fc4","name":"@carbon-cashmere/x402-mcp","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@carbon-cashmere/x402-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","x402","crypto","ai-agent","claude","cursor","micropayments","trading-signals","on-chain-analytics"],"author":{"name":"Carbon & Cashmere"},"license":"MIT","_id":"@carbon-cashmere/x402-mcp@0.1.0","maintainers":[{"name":"nedeljko87","email":"info@carbon-cashmere.de"}],"homepage":"https://api.carbon-cashmere.de","bugs":{"url":"https://github.com/CarbonCashmere/x402-mcp/issues"},"bin":{"x402-mcp":"dist/index.js"},"dist":{"shasum":"f8b96ed12d64ef15a7394a69f9d56867763482dd","tarball":"https://registry.npmjs.org/@carbon-cashmere/x402-mcp/-/x402-mcp-0.1.0.tgz","fileCount":16,"integrity":"sha512-P2g5LN+KB07b04bxGU8M8IegW4+f5vgGN0hx9BPYcOvO8Z/uo82tVgPYyqOGAzzD/0IzsTESnvhESK05jzK8qg==","signatures":[{"sig":"MEUCIQCiqkQ1Vr5QAN/f85MyDAK09XxpSS8Q3M5xn8+8JoIAPgIgDXjT34dx95fPLlMkzU9ig43X78MU7JsDy6UaAHuTnBM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30105},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"9c7f80ff6c4499c76fc21cb81516bf1c6b8b08c9","scripts":{"dev":"tsx src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"nedeljko87","email":"info@carbon-cashmere.de"},"repository":{"url":"git+https://github.com/CarbonCashmere/x402-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that exposes Carbon & Cashmere's 177 crypto market intelligence endpoints with automatic x402 micropayments. Buy crypto signals, on-chain data, and trading intelligence directly from your AI agent's wallet.","directories":{},"_nodeVersion":"20.20.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","@x402/evm":"^2.12.0","@x402/svm":"^2.12.0","@scure/base":"^1.2.6","@solana/kit":"^5.1.0","@x402/axios":"^2.12.0","@modelcontextprotocol/sdk":"^1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-mcp_0.1.0_1779225276954_0.19966010977235005","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@carbon-cashmere/x402-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","x402","crypto","ai-agent","claude","cursor","micropayments","trading-signals","on-chain-analytics"],"author":{"name":"Carbon & Cashmere"},"license":"MIT","_id":"@carbon-cashmere/x402-mcp@0.2.0","maintainers":[{"name":"nedeljko87","email":"info@carbon-cashmere.de"}],"homepage":"https://api.carbon-cashmere.de","bugs":{"url":"https://github.com/CarbonCashmere/x402-mcp/issues"},"bin":{"x402-mcp":"dist/index.js"},"dist":{"shasum":"75888bea1ac8d03513b752fe47e0d6e7ff9ddbea","tarball":"https://registry.npmjs.org/@carbon-cashmere/x402-mcp/-/x402-mcp-0.2.0.tgz","fileCount":16,"integrity":"sha512-6gwBlnQZwUEBvroGQOrvu82AzcK3FjKse8/SWFl3l9UsjhbIDmfVcQFq0VIbWwjlZZWpoSIu0f+AHXq0FGWDKw==","signatures":[{"sig":"MEUCIGKxYmVv0CCfvRFRZqDA/7BfYHPtnLHKgjWytYajQ9uSAiEAqzz7N3qo/lXvime6+uo2CMMSlC1k4Q9hvBy1TjcU+tk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34476},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"71260fdd9b4fde087425102c5de4b65748c0364d","scripts":{"dev":"tsx src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"nedeljko87","email":"info@carbon-cashmere.de"},"repository":{"url":"git+https://github.com/CarbonCashmere/x402-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that exposes Carbon & Cashmere's 177 crypto market intelligence endpoints with automatic x402 micropayments. Buy crypto signals, on-chain data, and trading intelligence directly from your AI agent's wallet.","directories":{},"_nodeVersion":"20.20.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","@x402/evm":"^2.12.0","@x402/svm":"^2.12.0","@scure/base":"^1.2.6","@solana/kit":"^5.1.0","@x402/axios":"^2.12.0","@modelcontextprotocol/sdk":"^1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-mcp_0.2.0_1779226438188_0.2692616075582708","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@carbon-cashmere/x402-mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","x402","crypto","ai-agent","claude","cursor","micropayments","trading-signals","on-chain-analytics"],"author":{"name":"Carbon & Cashmere"},"license":"MIT","_id":"@carbon-cashmere/x402-mcp@0.2.1","maintainers":[{"name":"nedeljko87","email":"info@carbon-cashmere.de"}],"homepage":"https://api.carbon-cashmere.de","bugs":{"url":"https://github.com/CarbonCashmere/x402-mcp/issues"},"bin":{"x402-mcp":"dist/index.js"},"dist":{"shasum":"8eb7b87f3c3a7f2242f2e075082a9f134c30b8f9","tarball":"https://registry.npmjs.org/@carbon-cashmere/x402-mcp/-/x402-mcp-0.2.1.tgz","fileCount":16,"integrity":"sha512-utASbkkty3+Aek9vS1LZpxOzbbAsDfnl79ZgvukEYM9qb3DRQ2i1XercKkwulrBbcLMs8ieKAFXcuSVpJh3FHA==","signatures":[{"sig":"MEQCID9gFiXNlJnMTlkkG+GCSS7/voZF+3zl19w0uk4Q513cAiBnFwzKUesV+w0m/ow1bj8/4vnlXccnFp9S5Au+G9aaRQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37414},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"2c480360fc6067ec36c56f6fd255e47225d8c4b4","scripts":{"dev":"tsx src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"nedeljko87","email":"info@carbon-cashmere.de"},"repository":{"url":"git+https://github.com/CarbonCashmere/x402-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server that exposes Carbon & Cashmere's 177 crypto market intelligence endpoints with automatic x402 micropayments. Buy crypto signals, on-chain data, and trading intelligence directly from your AI agent's wallet.","directories":{},"_nodeVersion":"20.20.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","@x402/evm":"^2.12.0","@x402/svm":"^2.12.0","@scure/base":"^1.2.6","@solana/kit":"^5.1.0","@x402/axios":"^2.12.0","@modelcontextprotocol/sdk":"^1.9.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-mcp_0.2.1_1779298560920_0.18132033043530216","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@carbon-cashmere/x402-mcp","mcpName":"io.github.CarbonCashmere/x402-mcp","version":"0.2.2","description":"MCP server that exposes Carbon & Cashmere's 177 crypto market intelligence endpoints with automatic x402 micropayments. Buy crypto signals, on-chain data, and trading intelligence directly from your AI agent's wallet.","type":"module","bin":{"x402-mcp":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","clean":"rm -rf dist"},"keywords":["mcp","model-context-protocol","x402","crypto","ai-agent","claude","cursor","micropayments","trading-signals","on-chain-analytics"],"author":{"name":"Carbon & Cashmere"},"license":"MIT","homepage":"https://api.carbon-cashmere.de","repository":{"type":"git","url":"git+https://github.com/CarbonCashmere/x402-mcp.git"},"bugs":{"url":"https://github.com/CarbonCashmere/x402-mcp/issues"},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.9.0","@x402/axios":"^2.12.0","@x402/evm":"^2.12.0","@x402/svm":"^2.12.0","axios":"^1.13.2","viem":"^2.39.0","@solana/kit":"^5.1.0","@scure/base":"^1.2.6"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.6.0"},"_id":"@carbon-cashmere/x402-mcp@0.2.2","gitHead":"40d1131411eb2b19368813f372a24cf224a91a68","types":"./dist/index.d.ts","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-AWHAOLAjxPddqYqr/wRCnpN/0qCFvBoUr4vlyhFjl5mylP3M82ZZuunmnUE+v5i4HbvQHtViwKmQ/e0bOudvuw==","shasum":"83a600a60334e3346e9159c63b2f69e2e43d2c04","tarball":"https://registry.npmjs.org/@carbon-cashmere/x402-mcp/-/x402-mcp-0.2.2.tgz","fileCount":16,"unpackedSize":37464,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIExiZg7y0RoNkWLwoRbM/JfqQrdmywaMfrUpZLYboN7kAiBle08XQJLj+1IF2m62lHJoPJACdrJepRO2dSPNtoMumw=="}]},"_npmUser":{"name":"nedeljko87","email":"info@carbon-cashmere.de"},"directories":{},"maintainers":[{"name":"nedeljko87","email":"info@carbon-cashmere.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/x402-mcp_0.2.2_1779303653268_0.7522436656889897"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-19T21:14:36.748Z","modified":"2026-05-20T19:00:53.571Z","0.1.0":"2026-05-19T21:14:37.144Z","0.2.0":"2026-05-19T21:33:58.358Z","0.2.1":"2026-05-20T17:36:01.092Z","0.2.2":"2026-05-20T19:00:53.441Z"},"bugs":{"url":"https://github.com/CarbonCashmere/x402-mcp/issues"},"author":{"name":"Carbon & Cashmere"},"license":"MIT","homepage":"https://api.carbon-cashmere.de","keywords":["mcp","model-context-protocol","x402","crypto","ai-agent","claude","cursor","micropayments","trading-signals","on-chain-analytics"],"repository":{"type":"git","url":"git+https://github.com/CarbonCashmere/x402-mcp.git"},"description":"MCP server that exposes Carbon & Cashmere's 177 crypto market intelligence endpoints with automatic x402 micropayments. Buy crypto signals, on-chain data, and trading intelligence directly from your AI agent's wallet.","maintainers":[{"name":"nedeljko87","email":"info@carbon-cashmere.de"}],"readme":"# @carbon-cashmere/x402-mcp\n\nMCP server that exposes [Carbon & Cashmere's](https://api.carbon-cashmere.de) 177 crypto market intelligence endpoints to your AI agent — with **automatic x402 USDC micropayments** from your wallet.\n\n## What you get\n\nWhen this MCP is installed, your AI agent can call tools like:\n\n- `get_v1_news` — analyzed crypto news with sentiment + market impact\n- `get_v1_stablecoins` — total market cap, per-coin supply, chain distribution\n- `get_v1_onchain_btc` — Bitcoin on-chain metrics (hash-rate, mempool, miner flows)\n- `get_v1_bittensor_leaderboard` — top-100 Bittensor miners by emission\n- `get_v1_mantis_realized_accuracy` — MANTIS subnet (UID 253) realized accuracy track-record\n- `get_v1_intel_snapshot` — aggregated market intel snapshot\n- … plus subscriptions ($10/day, $50/week, $200/month), sponsor tiers ($500–$50000), and 170+ research endpoints priced **$0.003 – $0.50 per call**\n\n**177 paid endpoints total.** Default exposes top 100 (curated by revenue + popularity). Set `X402_TOOL_LIMIT=177` to expose all incl. per-coin variants.\n\nEach tool invocation triggers a single USDC micropayment from your configured wallet. No subscription. No API key. Pay only for what you use.\n\n## Install\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"carbon-cashmere\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carbon-cashmere/x402-mcp\"],\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"0x_your_evm_private_key_here\",\n        \"SVM_PRIVATE_KEY\": \"your_base58_solana_private_key_here_optional\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The top 100 Carbon & Cashmere tools (curated by revenue + popularity) appear in your tool palette.\n\n### Cursor / Cline / Continue\n\nSame JSON config, paste into your MCP settings panel.\n\n## Wallet setup\n\n> **Security: use a dedicated spending wallet, not your main wallet.**\n> Your `EVM_PRIVATE_KEY` sits in plaintext in your Claude Desktop config. Any\n> process on the host with read access to that file gets the key. Treat it as\n> a hot wallet you would not mind losing: fund it with the small amount you\n> plan to spend ($10–$50 in USDC), never with your main holdings.\n\n- **EVM_PRIVATE_KEY** (required for Base / Polygon / Arbitrum / World / Avalanche payments)\n  - 0x-prefixed hex string (e.g. `0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80`)\n  - Fund with USDC on Base mainnet (cheapest, fastest, ~$0.0001 gas per call)\n  - One-time cost: ~$10 USDC covers 200+ tool calls\n  - **Hard cap = wallet balance.** A runaway agent loop can spend the funded\n    amount but no more; signing is bounded by USDC available on the chain.\n- **SVM_PRIVATE_KEY** (optional, for Solana payments)\n  - base58-encoded Solana keypair bytes\n  - Only needed if a tool routes Solana-only\n\n**Network whitelist.** The MCP server only signs payments for networks that\nappear in the API's 402-response `accepts[]` array (currently Base, Polygon,\nArbitrum, World Chain, Solana, Algorand, Stellar). Requests routed to any\nother chain are rejected at the signing layer — your key cannot be tricked\ninto signing for an arbitrary network.\n\n**Keys never leave your machine.** They live only in your Claude Desktop\nconfig and the MCP process running locally. Payment signing happens on your\ndevice; only the signed EIP-712 / SIWS payload travels to Carbon & Cashmere.\n\n### Discovery-only mode (no keys set)\n\nIf you start the MCP server without `EVM_PRIVATE_KEY` and without\n`SVM_PRIVATE_KEY`, it runs in **discovery-only mode**: tool registration\nworks, free endpoints work, paid tool invocations surface a 402 error to the\nagent. Useful for: evaluating the tool catalog, MCP marketplace introspection\n(Glama, npm scrapers), or running in a CI/test environment without funding\na wallet.\n\n## How it works\n\n```\nClaude Desktop          @carbon-cashmere/x402-mcp        api.carbon-cashmere.de\n     |                          (your machine)                 (our server)\n     |  call get_v1_news        |                                 |\n     |------------------------->|  GET /v1/news                   |\n     |                          |-------------------------------->|\n     |                          |  402 + PAYMENT-REQUIRED         |\n     |                          |<--------------------------------|\n     |                          |  sign with EVM_PRIVATE_KEY      |\n     |                          |  GET /v1/news + PAYMENT-SIG     |\n     |                          |-------------------------------->|\n     |                          |  200 OK + data                  |\n     |                          |<--------------------------------|\n     |  formatted data          |                                 |\n     |<-------------------------|                                 |\n```\n\nBuilt on official Coinbase x402 v2 protocol. Settlement happens on Base USDC (or your chosen chain). Typical latency: ~2-3 seconds per call (one-shot payment + data).\n\n## Tool count\n\nBy default, the top 100 tools are exposed — curated server-side by a scoring\nthat combines actual settlement volume, USD revenue, exploration weighting,\nand description quality (the catalog re-ranks without requiring an npm\nre-publish).\n\n| `X402_TOOL_LIMIT` | What you get |\n|---|---|\n| `50` | Minimal footprint — top free + bundles + a few high-revenue endpoints |\n| `100` (default) | High-revenue tier — adds $10–$50 subscriptions, sponsor tiers, weekly/daily reports, on-chain bundles |\n| `177` | Everything — adds per-coin specialized routes (vol-regime/{coin}, hurst/{coin}, trend/{coin}, …). Recommended only when your agent knows which coin to query. |\n\nOverride:\n```json\n\"env\": {\n  \"X402_TOOL_LIMIT\": \"177\"\n}\n```\n\nWhy a default cap: too many MCP tools can degrade an agent's tool-selection\naccuracy. 100 is the empirical sweet spot for Claude 3.5 Sonnet and newer.\n\n## Configuration env\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `EVM_PRIVATE_KEY` | one of | — | 0x-prefixed EVM key for Base/Polygon/Arbitrum |\n| `SVM_PRIVATE_KEY` | one of | — | base58 Solana keypair |\n| `X402_API_BASE` | no | `https://api.carbon-cashmere.de` | API base URL |\n| `X402_TOOL_LIMIT` | no | `100` | Max tools exposed (1-177) |\n| `X402_LOG_LEVEL` | no | `info` | `debug \\| info \\| warn \\| error` |\n\n## Security\n\n- **Keys never leave your machine.** The MCP server runs locally as a child process of Claude Desktop.\n- **Pay-per-call cap.** Each call costs $0.003–$0.50. Even a runaway loop is bounded by wallet balance.\n- **No off-chain credentials.** No API keys. No OAuth. Pure on-chain settlement.\n- **Open source.** Audit the code yourself: [github.com/CarbonCashmere/x402-mcp](https://github.com/CarbonCashmere/x402-mcp)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n## Links\n\n- Carbon & Cashmere API: <https://api.carbon-cashmere.de>\n- x402 protocol: <https://github.com/coinbase/x402>\n- MCP protocol: <https://modelcontextprotocol.io>\n","readmeFilename":"README.md"}