{"_id":"cryptoquant-mcp","_rev":"2-7c7c9fb9e23b40b9fbc262ea0fce9974","name":"cryptoquant-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"0.2.0":{"name":"cryptoquant-mcp","version":"0.2.0","keywords":["cryptoquant","mcp","model-context-protocol","claude","claude-code","on-chain","bitcoin","ethereum","crypto","analytics","ai-agent"],"author":{"name":"CryptoQuant"},"license":"MIT","_id":"cryptoquant-mcp@0.2.0","maintainers":[{"name":"cryptoquant","email":"dev@cryptoquant.com"}],"homepage":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp#readme","bugs":{"url":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp/issues"},"bin":{"cryptoquant-mcp":"dist/index.js"},"dist":{"shasum":"de0e7e833879e63abdaa6444717395fbc375b2f9","tarball":"https://registry.npmjs.org/cryptoquant-mcp/-/cryptoquant-mcp-0.2.0.tgz","fileCount":52,"integrity":"sha512-rwasrGw5R9juWrEcXwqKbtpAvOeBfRtBWbf6gKfLAVQZaHD4B+UVoUTvavOt4Liw62H2noet681MBdV4pQTIiA==","signatures":[{"sig":"MEUCIQDtd80OBT48HnK2QoWB/6gJmPTdDmu+rf4azLJ8M+Q7HgIgJvv6rbPfO6QtwJkH/G2OGSXh5r9iMByFw+CwQTFMGhA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/cryptoquant-mcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":220611},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2ab5472bca310aca9debc019adc2f047e069590d","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc && cp -r src/data dist/","start":"node dist/index.js","prepare":"husky","prepublishOnly":"npm run build"},"_npmUser":{"name":"cryptoquant","email":"dev@cryptoquant.com"},"repository":{"url":"git+https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"CryptoQuant MCP Server - On-chain analytics for Claude and AI coding agents","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","husky":"^9.0.0","eslint":"^9.0.0","vitest":"^2.0.0","@eslint/js":"^9.39.2","typescript":"^5.5.0","@types/node":"^20.0.0","typescript-eslint":"^8.54.0"},"_npmOperationalInternal":{"tmp":"tmp/cryptoquant-mcp_0.2.0_1770106785533_0.48498202472119356","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"_id":"cryptoquant-mcp@1.0.0","bin":{"cryptoquant-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp/issues"},"dist":{"shasum":"f84fa5cee8df534fe218f7d46ee773fa6574cf03","tarball":"https://registry.npmjs.org/cryptoquant-mcp/-/cryptoquant-mcp-1.0.0.tgz","fileCount":13,"integrity":"sha512-rS/Y2AaFZcEnXGJkPeQqbc8pAJgp5AGaI9VmtNlm4o9lfcN1tutUKloqAbdHpTr69amuN8JGp8X4kXJpynL0Fg==","signatures":[{"sig":"MEQCIHgvo++NpOYXMnBVkhxOa/SFC6Gw8OgYkwtTfJlsCrDcAiAkVNy/5YDHzjd1MzEMA2yBQ6PPmuWJ0h0RggjyfpHSIQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICKa5F280ay+MWeGFSz39sH173a27Y4o7LyN+CyDOGIaAiAbstSZnZup3RMBKQN6NWWAJ+BSMxkGc1bgS5tGOpXlkA=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/cryptoquant-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":31010},"name":"cryptoquant-mcp","type":"module","author":{"name":"CryptoQuant"},"engines":{"node":">=18.0.0"},"gitHead":"7a9863ee4cfb2e85b6cf5f5dcb8aeb9c4b0636b8","license":"MIT","mcpName":"com.cryptoquant/mcp-server","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/ test/","test":"vitest run","build":"node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc","start":"node dist/index.js","prepare":"husky","typecheck":"tsc -p tsconfig.test.json","test:watch":"vitest","prepublishOnly":"npm run build","sync:metric-ids":"tsx test/helpers/sync-metric-ids.ts"},"version":"1.0.0","_npmUser":{"name":"cryptoquant","email":"dev@cryptoquant.com"},"homepage":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp#readme","keywords":["cryptoquant","mcp","model-context-protocol","claude","claude-code","on-chain","bitcoin","ethereum","crypto","analytics","ai-agent","mcp-server","on-chain-analytics"],"repository":{"url":"git+https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"CryptoQuant MCP stdio proxy - connects MCP clients to the remote CryptoQuant MCP server","directories":{},"maintainers":[{"name":"cryptoquant","email":"dev@cryptoquant.com"}],"_nodeVersion":"20.20.2","dependencies":{"@modelcontextprotocol/sdk":"^1.31.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","tsx":"^4.0.0","zod":"^3.23.0","husky":"^9.0.0","eslint":"^9.0.0","vitest":"^2.0.0","@eslint/js":"^9.39.2","typescript":"^5.5.0","@types/node":"^20.0.0","typescript-eslint":"^8.54.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cryptoquant-mcp_1.0.0_1790929554759_0.49884331436207074"}}},"time":{"created":"2026-02-03T08:19:45.415Z","modified":"2026-10-02T08:25:55.364Z","0.2.0":"2026-02-03T08:19:45.685Z","1.0.0":"2026-10-02T08:25:54.855Z"},"bugs":{"url":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp/issues"},"author":{"name":"CryptoQuant"},"license":"MIT","homepage":"https://github.com/CryptoQuantOfficial/cryptoquant-mcp#readme","keywords":["cryptoquant","mcp","model-context-protocol","claude","claude-code","on-chain","bitcoin","ethereum","crypto","analytics","ai-agent","mcp-server","on-chain-analytics"],"repository":{"url":"git+https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git","type":"git"},"description":"CryptoQuant MCP stdio proxy - connects MCP clients to the remote CryptoQuant MCP server","maintainers":[{"name":"cryptoquant","email":"dev@cryptoquant.com"}],"readme":"# CryptoQuant MCP\n\n[![npm version](https://img.shields.io/npm/v/cryptoquant-mcp.svg)](https://www.npmjs.com/package/cryptoquant-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nCryptoQuant on-chain, market, and derivatives data, plus CryptoQuant Research and QuickTake insights, for AI agents through the [Model Context Protocol](https://modelcontextprotocol.io).\n\nThis repository contains:\n\n- **Remote server setup** for `https://mcp.cryptoquant.com/mcp` (recommended; you sign in with OAuth)\n- **An Agent Plugins / Cursor plugin** (`plugin.json`, `mcp.json`, `skills/`) that connects to the remote server and teaches the agent which metric answers which question\n- **A local stdio proxy** (`npx cryptoquant-mcp`) for clients that cannot connect to remote MCP servers. It forwards every message to the remote server unchanged.\n\n<!-- TODO: demo GIF (to be recorded by the CryptoQuant team) -->\n\n## Remote server (recommended)\n\nServer URL: `https://mcp.cryptoquant.com/mcp` (Streamable HTTP, OAuth)\n\nNo API key is needed in your config. The first time you connect, your client opens a CryptoQuant sign-in page. More setup details: [CryptoQuant user guide](https://userguide.cryptoquant.com/api/mcp-server-beta/remote-mcp-recommended).\n\n### Claude (claude.ai and Claude Desktop)\n\nOpen **Settings → Connectors → Add custom connector** and paste the server URL.\n\n### ChatGPT\n\nAdd a custom connector with the server URL (developer mode). Availability depends on your ChatGPT plan.\n\n### Cursor\n\nInstall the **CryptoQuant** plugin from the Cursor marketplace (once listed). It adds the remote server and the `cryptoquant-onchain` skill.\n\nOr add the server yourself in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"cryptoquant\": {\n      \"url\": \"https://mcp.cryptoquant.com/mcp\"\n    }\n  }\n}\n```\n\n### VS Code\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"cryptoquant\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.cryptoquant.com/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http cryptoquant https://mcp.cryptoquant.com/mcp\n```\n\nThen run `/mcp` in Claude Code to sign in.\n\n## Local install (npx proxy)\n\nFor clients that only support local (stdio) servers. Requires Node.js 18+ and a [CryptoQuant API key](https://cryptoquant.com/account/api).\n\n```json\n{\n  \"mcpServers\": {\n    \"cryptoquant\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"cryptoquant-mcp\"],\n      \"env\": {\n        \"CRYPTOQUANT_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n| App | Config file |\n| --- | --- |\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` or `~/.cursor/mcp.json` |\n| Claude Code | project `.mcp.json` |\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `CRYPTOQUANT_API_KEY` | Yes | Your API key, sent to the remote server as a bearer token. If it is not set, the key saved by 0.x in `~/.cryptoquant/credentials` is used. |\n| `CRYPTOQUANT_MCP_URL` | No | Overrides the server URL (default `https://mcp.cryptoquant.com/mcp`). Must be `https`; plain `http` is accepted only for loopback addresses (`localhost`, `127.0.0.1`, `[::1]`). |\n\nWithout a key, the proxy prints setup instructions to stderr and exits.\n\n## Tools\n\nThe tools come from the remote server. This list is for reference and may change.\n\n| Tool | Description |\n| --- | --- |\n| `discover_endpoints` | Find data endpoints by asset and category |\n| `get_endpoint_info` | Parameters of an endpoint (window, exchange, token, ...) |\n| `query_data` | Query on-chain, market, and derivatives data |\n| `describe_metric` | Definition, thresholds, and interpretation of a metric |\n| `list_assets` | Supported assets |\n| `recent_research` | Latest CryptoQuant Research articles |\n| `recent_quicktake` | Latest QuickTake articles from CryptoQuant Verified Authors |\n| `query_research` | Search Research articles by topic |\n| `query_quicktake` | Search QuickTake articles by topic |\n\n## Assets, dates, and rate limits\n\n- **Assets:** BTC, ETH, XRP, TRX, stablecoins, ERC-20 tokens, and other altcoins. `list_assets` returns the current list.\n- **Dates:** `yyyyMMdd` for `window=day` (e.g. `20260115`), `yyyyMMddTHHmmss` for other windows (e.g. `20260115T000000`).\n- **Rate limits and history:** depend on your CryptoQuant plan. The server tells the agent your plan's limits when it connects. See [plans](https://cryptoquant.com/pricing).\n\n## Migrating from 0.x\n\n1.0 turns the npm package into a proxy to the remote server, so the local and remote servers now offer the same tools.\n\n- The `initialize` and `reset_session` tools are removed. Set `CRYPTOQUANT_API_KEY` in your MCP config instead. A key you saved in 0.x with `initialize(api_key=...)` keeps working; it is read from `~/.cryptoquant/credentials`.\n- QuickTake and Research tools are now available locally.\n- The package no longer exports a JavaScript library API.\n- `CRYPTOQUANT_API_URL` (the 0.x API base URL override) is no longer used; use `CRYPTOQUANT_MCP_URL` to point at another MCP server.\n- `npx -y cryptoquant-mcp` always fetches the latest version, so existing configs switch to 1.0 on the next start. Prompts or workflows that call `initialize` need to be updated.\n\nSee [CHANGELOG.md](CHANGELOG.md).\n\n## Development\n\n```bash\ngit clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git\ncd cryptoquant-mcp\nnpm install\nnpm test\nnpm run build\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","readmeFilename":"README.md"}