{"_id":"@blurt-blockchain/blurt-mcp-server","_rev":"4-445f68bec7ec86e3dc77de314851f356","name":"@blurt-blockchain/blurt-mcp-server","dist-tags":{"latest":"0.4.3"},"versions":{"0.4.0":{"name":"@blurt-blockchain/blurt-mcp-server","version":"0.4.0","keywords":["blurt","blockchain","mcp","model-context-protocol","dblurt"],"author":{"name":"nalexadre - Blurt blockchain"},"license":"GPL-3.0-or-later","_id":"@blurt-blockchain/blurt-mcp-server@0.4.0","maintainers":[{"name":"beblurt","email":"dev@beblurt.com"}],"homepage":"https://gitlab.com/blurt-blockchain/blurt-mcp-server","bugs":{"url":"https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/issues"},"bin":{"blurt-mcp-stdio":"dist/server-stdio.js","blurt-mcp-server":"dist/server.js"},"dist":{"shasum":"52e22196f6585067c71d8d890e8b2541ff8bdf33","tarball":"https://registry.npmjs.org/@blurt-blockchain/blurt-mcp-server/-/blurt-mcp-server-0.4.0.tgz","fileCount":66,"integrity":"sha512-N+ZddJ75C465VT/99JVak19IOtZw0oF3cRlRH6YfsMqFKCp9yrvJObQveyg0uO0Sj367QcsyiWj8GOvgNSOcDA==","signatures":[{"sig":"MEQCIAEQn/BtHyHU7XJjKQCSrg5m8Fr4XJ6vXke3lVG179nQAiBX0tsxbS0WY6mFWZuDWZ692mNkdcPkz9zF0PySYUentA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":299777},"main":"dist/server.js","type":"module","engines":{"node":">=18"},"gitHead":"81f7dd817d0d1303bdf0a4efdcc2f3da39eb9020","scripts":{"dev":"tsx watch src/server.ts","test":"node --import tsx --test test/uri.test.ts test/search.test.ts test/contract.test.ts test/resilience.test.ts test/write.test.ts test/ops.test.ts test/package.test.ts test/stdio.test.ts test/network.test.ts","build":"tsc -p tsconfig.json","start":"node dist/server.js","release":"commit-and-tag-version","test:all":"node --import tsx --test test/*.test.ts","dev:stdio":"tsx src/server-stdio.ts","inspector":"npx @modelcontextprotocol/inspector dist/server.js","test:http":"node --import tsx --test test/http.test.ts","test:live":"node --import tsx --test test/live.test.ts","typecheck":"tsc -p tsconfig.json --noEmit","docs:check":"npm run docs:tools && git diff --exit-code docs/tools.generated.md","docs:tools":"tsx scripts/generate-tool-docs.ts","pack:check":"npm run build && npm pack --dry-run","smoke:http":"node scripts/smoke-http.mjs","release:dry":"commit-and-tag-version --dry-run","start:stdio":"node dist/server-stdio.js","check:secrets":"node scripts/check-secrets.mjs","release:major":"commit-and-tag-version --release-as major","release:minor":"commit-and-tag-version --release-as minor","smoke:package":"node scripts/smoke-package.mjs"},"_npmUser":{"name":"beblurt","email":"dev@beblurt.com"},"repository":{"url":"git+https://gitlab.com/blurt-blockchain/blurt-mcp-server.git","type":"git"},"_npmVersion":"10.9.8","description":"Model Context Protocol (MCP) server exposing the Blurt blockchain (accounts, history, posts) over Streamable HTTP.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","dotenv":"^17.4.2","express":"^5.2.1","@beblurt/dblurt":"^0.15.0","@modelcontextprotocol/sdk":"^1.29.0","@beblurt/blurt-nodes-checker":"^2.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.4","typescript":"^5.9.3","@types/node":"^26.0.1","@types/express":"^5.0.6","commit-and-tag-version":"^12.7.3"},"_npmOperationalInternal":{"tmp":"tmp/blurt-mcp-server_0.4.0_1782940130595_0.6026889172713337","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@blurt-blockchain/blurt-mcp-server","version":"0.4.1","keywords":["blurt","blockchain","mcp","model-context-protocol","dblurt"],"author":{"name":"nalexadre - Blurt blockchain"},"license":"GPL-3.0-or-later","_id":"@blurt-blockchain/blurt-mcp-server@0.4.1","maintainers":[{"name":"beblurt","email":"dev@beblurt.com"}],"homepage":"https://gitlab.com/blurt-blockchain/blurt-mcp-server","bugs":{"url":"https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/issues"},"bin":{"blurt-mcp-stdio":"dist/server-stdio.js","blurt-mcp-server":"dist/server.js"},"dist":{"shasum":"0c3b7e830424934f08cdbfff25424b29978341f2","tarball":"https://registry.npmjs.org/@blurt-blockchain/blurt-mcp-server/-/blurt-mcp-server-0.4.1.tgz","fileCount":71,"integrity":"sha512-QsRI366TKCPHqZ3xpUQdEVgKmHzgO1EMUxo5lwAD7FWYB44RDaKWqVfxagMv/gdrbyL6mvqRR/rszF5+8RUPQg==","signatures":[{"sig":"MEYCIQDqXgvhTHaGz9qzMTkkwHSK4rKZ6uhDBaloWECYsqYvxAIhAPVAh6CtdjU7VeQawakfl0XnxHmonjkQlYLB0KN6zCEn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":333774},"main":"dist/server.js","type":"module","engines":{"node":">=18"},"gitHead":"9e0f105b00efcd381fc0a850f727aa47f377db2f","scripts":{"dev":"tsx watch src/server.ts","test":"node --import tsx --test test/uri.test.ts test/search.test.ts test/contract.test.ts test/resilience.test.ts test/write.test.ts test/ops.test.ts test/package.test.ts test/stdio.test.ts test/network.test.ts","build":"tsc -p tsconfig.json","start":"node dist/server.js","release":"commit-and-tag-version","docs:dev":"vitepress dev docs","test:all":"node --import tsx --test test/*.test.ts","dev:stdio":"tsx src/server-stdio.ts","docs:site":"vitepress build docs","inspector":"npx @modelcontextprotocol/inspector dist/server.js","test:http":"node --import tsx --test test/http.test.ts","test:live":"node --import tsx --test test/live.test.ts","typecheck":"tsc -p tsconfig.json --noEmit","docs:check":"npm run docs:tools && npm run docs:links && npm run docs:site && git diff --exit-code docs/tools.generated.md","docs:links":"node scripts/check-doc-links.mjs","docs:tools":"tsx scripts/generate-tool-docs.ts","pack:check":"npm run build && npm pack --dry-run","smoke:http":"node scripts/smoke-http.mjs","release:dry":"commit-and-tag-version --dry-run","start:stdio":"node dist/server-stdio.js","docs:preview":"vitepress preview docs","check:secrets":"node scripts/check-secrets.mjs","release:major":"commit-and-tag-version --release-as major","release:minor":"commit-and-tag-version --release-as minor","smoke:package":"node scripts/smoke-package.mjs","docs:site:clean":"rm -rf docs/.vitepress/dist"},"_npmUser":{"name":"beblurt","email":"dev@beblurt.com"},"repository":{"url":"git+https://gitlab.com/blurt-blockchain/blurt-mcp-server.git","type":"git"},"_npmVersion":"10.9.8","description":"Model Context Protocol (MCP) server exposing the Blurt blockchain (accounts, history, posts) over Streamable HTTP.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","dotenv":"^17.4.2","express":"^5.2.1","@beblurt/dblurt":"^0.15.0","@modelcontextprotocol/sdk":"^1.29.0","@beblurt/blurt-nodes-checker":"^2.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.4","vitepress":"2.0.0-alpha.17","typescript":"^5.9.3","@types/node":"^26.0.1","@types/express":"^5.0.6","commit-and-tag-version":"^12.7.3"},"_npmOperationalInternal":{"tmp":"tmp/blurt-mcp-server_0.4.1_1783072639231_0.06985233385950407","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@blurt-blockchain/blurt-mcp-server","version":"0.4.2","keywords":["blurt","blockchain","mcp","model-context-protocol","dblurt"],"author":{"name":"nalexadre - Blurt blockchain"},"license":"GPL-3.0-or-later","_id":"@blurt-blockchain/blurt-mcp-server@0.4.2","maintainers":[{"name":"beblurt","email":"dev@beblurt.com"}],"homepage":"https://gitlab.com/blurt-blockchain/blurt-mcp-server","bugs":{"url":"https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/issues"},"bin":{"blurt-mcp-stdio":"dist/server-stdio.js","blurt-mcp-server":"dist/server.js"},"dist":{"shasum":"ab7354800f10da55320fe3b0e3e0f5bcfde56d72","tarball":"https://registry.npmjs.org/@blurt-blockchain/blurt-mcp-server/-/blurt-mcp-server-0.4.2.tgz","fileCount":73,"integrity":"sha512-gxAEKXga8sVdLTumc7IZwr2O2z2NIEwMWZLTps9XjcgUAKfJIa9JAr4rDPd3JMTt1x77p+3eIdjPV2Vvex8cNw==","signatures":[{"sig":"MEYCIQDaRld3wOd9tInFaTFV29TwypDxjHO8Hl9aPOYPEEZRXAIhAOgatz81mHs1bvzaaxII7VfYKoY3vREpT5XZP20+iJOd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":343070},"main":"dist/server.js","type":"module","engines":{"node":">=18"},"gitHead":"42bab40fd2b5c5f338e0b7d86281fe5fc2fa52b6","scripts":{"dev":"tsx watch src/server.ts","test":"node --import tsx --test test/uri.test.ts test/search.test.ts test/contract.test.ts test/resilience.test.ts test/write.test.ts test/ops.test.ts test/package.test.ts test/stdio.test.ts test/network.test.ts","build":"tsc -p tsconfig.json","start":"node dist/server.js","release":"commit-and-tag-version","docs:dev":"vitepress dev docs","test:all":"node --import tsx --test test/*.test.ts","dev:stdio":"tsx src/server-stdio.ts","docs:site":"vitepress build docs","inspector":"npx @modelcontextprotocol/inspector dist/server.js","test:http":"node --import tsx --test test/http.test.ts","test:live":"node --import tsx --test test/live.test.ts","typecheck":"tsc -p tsconfig.json --noEmit","docs:check":"npm run docs:tools && npm run docs:links && npm run docs:site && git diff --exit-code docs/tools.generated.md","docs:links":"node scripts/check-doc-links.mjs","docs:tools":"tsx scripts/generate-tool-docs.ts","pack:check":"npm run build && npm pack --dry-run","smoke:http":"node scripts/smoke-http.mjs","release:dry":"commit-and-tag-version --dry-run","start:stdio":"node dist/server-stdio.js","docs:preview":"vitepress preview docs","check:secrets":"node scripts/check-secrets.mjs","release:major":"commit-and-tag-version --release-as major","release:minor":"commit-and-tag-version --release-as minor","smoke:package":"node scripts/smoke-package.mjs","docs:site:clean":"rm -rf docs/.vitepress/dist"},"_npmUser":{"name":"beblurt","email":"dev@beblurt.com"},"repository":{"url":"git+https://gitlab.com/blurt-blockchain/blurt-mcp-server.git","type":"git"},"_npmVersion":"10.9.8","description":"Model Context Protocol (MCP) server exposing the Blurt blockchain (accounts, history, posts) over Streamable HTTP.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","dotenv":"^17.4.2","express":"^5.2.1","@beblurt/dblurt":"^0.15.0","@modelcontextprotocol/sdk":"^1.29.0","@beblurt/blurt-nodes-checker":"^2.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.4","vitepress":"2.0.0-alpha.17","typescript":"^5.9.3","@types/node":"^26.0.1","@types/express":"^5.0.6","commit-and-tag-version":"^12.7.3"},"_npmOperationalInternal":{"tmp":"tmp/blurt-mcp-server_0.4.2_1783342731973_0.13150445024381963","host":"s3://npm-registry-packages-npm-production"}},"0.4.3":{"name":"@blurt-blockchain/blurt-mcp-server","version":"0.4.3","description":"Model Context Protocol (MCP) server exposing the Blurt blockchain (accounts, history, posts) over Streamable HTTP.","type":"module","author":{"name":"nalexadre - Blurt blockchain"},"license":"GPL-3.0-or-later","homepage":"https://gitlab.com/blurt-blockchain/blurt-mcp-server","repository":{"type":"git","url":"git+https://gitlab.com/blurt-blockchain/blurt-mcp-server.git"},"bugs":{"url":"https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/issues"},"keywords":["blurt","blockchain","mcp","model-context-protocol","dblurt"],"engines":{"node":">=18"},"scripts":{"dev":"tsx watch src/server.ts","start":"node dist/server.js","start:stdio":"node dist/server-stdio.js","dev:stdio":"tsx src/server-stdio.ts","inspector":"npx @modelcontextprotocol/inspector dist/server.js","build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","check:secrets":"node scripts/check-secrets.mjs","docs:tools":"tsx scripts/generate-tool-docs.ts","docs:llms":"node scripts/generate-llms-docs.mjs","docs:llms:check":"node scripts/generate-llms-docs.mjs --check","docs:check":"npm run docs:tools && npm run docs:llms && npm run docs:links && npm run docs:site && npm run docs:siteweb && git diff --exit-code docs/tools.generated.md docs/llms.txt docs/llms-full.txt","test":"node --import tsx --test test/uri.test.ts test/search.test.ts test/contract.test.ts test/resilience.test.ts test/write.test.ts test/ops.test.ts test/package.test.ts test/stdio.test.ts test/network.test.ts","test:live":"node --import tsx --test test/live.test.ts","test:http":"node --import tsx --test test/http.test.ts","smoke:http":"node scripts/smoke-http.mjs","test:all":"node --import tsx --test test/*.test.ts","release":"commit-and-tag-version","release:minor":"commit-and-tag-version --release-as minor","release:major":"commit-and-tag-version --release-as major","release:dry":"commit-and-tag-version --dry-run","pack:check":"npm run build && npm pack --dry-run","smoke:package":"node scripts/smoke-package.mjs","docs:links":"node scripts/check-doc-links.mjs","docs:site":"vitepress build docs","docs:siteweb":"npm run docs:llms && BLURT_DOCS_TARGET=siteweb vitepress build docs && node scripts/generate-siteweb-assets.mjs","docs:preview":"vitepress preview docs","docs:dev":"vitepress dev docs","docs:site:clean":"rm -rf docs/.vitepress/dist"},"dependencies":{"@beblurt/blurt-nodes-checker":"^2.2.3","@beblurt/dblurt":"^0.17.0","@modelcontextprotocol/sdk":"^1.29.0","dotenv":"^17.4.2","express":"^5.2.1","zod":"^4.4.3"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^26.0.1","commit-and-tag-version":"^12.7.3","tsx":"^4.22.4","typescript":"^5.9.3","vitepress":"2.0.0-alpha.17"},"main":"dist/server.js","bin":{"blurt-mcp-server":"dist/server.js","blurt-mcp-stdio":"dist/server-stdio.js"},"_id":"@blurt-blockchain/blurt-mcp-server@0.4.3","gitHead":"45d36872ffdabb98cb3acbc781211ed76c5340cb","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-t373CN2g9Sf0gPlj8tUFtwhejEcdHOET7bEOImuRbRy6t5ciaNj8TJlwtUFHsRrepSBq6MXBbdG1dtIxbklGjw==","shasum":"26e37a3afad01ccabc720ae1f6e5d3569e45e795","tarball":"https://registry.npmjs.org/@blurt-blockchain/blurt-mcp-server/-/blurt-mcp-server-0.4.3.tgz","fileCount":73,"unpackedSize":347332,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD/ZHuXgibc531DZr0kc7XpgEXIlQ7VRjaw/YX8TjBgGQIhAObDToMZRklbpye59Tn8Pin42BHh5zCcQ/3UikLPhdUM"}]},"_npmUser":{"name":"beblurt","email":"dev@beblurt.com"},"directories":{},"maintainers":[{"name":"beblurt","email":"dev@beblurt.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/blurt-mcp-server_0.4.3_1784367195235_0.06904953848679596"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T21:08:50.409Z","modified":"2026-07-18T09:33:15.569Z","0.4.0":"2026-07-01T21:08:50.880Z","0.4.1":"2026-07-03T09:57:19.367Z","0.4.2":"2026-07-06T12:58:52.129Z","0.4.3":"2026-07-18T09:33:15.380Z"},"bugs":{"url":"https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/issues"},"author":{"name":"nalexadre - Blurt blockchain"},"license":"GPL-3.0-or-later","homepage":"https://gitlab.com/blurt-blockchain/blurt-mcp-server","keywords":["blurt","blockchain","mcp","model-context-protocol","dblurt"],"repository":{"type":"git","url":"git+https://gitlab.com/blurt-blockchain/blurt-mcp-server.git"},"description":"Model Context Protocol (MCP) server exposing the Blurt blockchain (accounts, history, posts) over Streamable HTTP.","maintainers":[{"name":"beblurt","email":"dev@beblurt.com"}],"readme":"# blurt-mcp-server\n\n[![pipeline status](https://gitlab.com/blurt-blockchain/blurt-mcp-server/badges/main/pipeline.svg)](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/pipelines)\n[![license: GPL-3.0-or-later](https://img.shields.io/badge/license-GPL--3.0--or--later-blue.svg)](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/blob/main/LICENSE)\n[![node >= 18](https://img.shields.io/badge/node-%E2%89%A518-brightgreen.svg)](https://blurt-blockchain.gitlab.io/blurt-mcp-server/usage.html#requirements)\n\n**Talk to the [Blurt blockchain](https://blurt.blog) from an AI assistant.**\n\n`blurt-mcp-server` is a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for the Blurt blockchain. It gives MCP-capable assistants such as Claude, ChatGPT, Cursor, Codex and other tools a safe way to read public Blurt blockchain data: accounts, posts, communities, witnesses, curation data, notifications and market information.\n\nThe public hosted endpoint is **read-only by default**. It holds no private keys and cannot post, vote, transfer, or change on-chain state.\n\n> 🟢 **Try it in 30 seconds — nothing to install.** Add this hosted endpoint as a custom/remote MCP connector in your AI app:\n>\n> ```text\n> https://mcp.blurt-blockchain.com/mcp\n> ```\n\n## Who is this for?\n\n- **Blurt blockchain users and community members** who want to ask natural-language questions about accounts, posts, communities, witnesses and rewards.\n- **Witnesses and ecosystem maintainers** who want a quick read-only view of network health, witness status, curation and public activity.\n- **AI-assistant users** who want their assistant to understand Blurt blockchain data without copying URLs or JSON by hand.\n- **Developers and operators** who want to self-host, inspect, extend or integrate an MCP server for the Blurt blockchain.\n\nIf you already know MCP, this package gives you a ready-to-use Blurt blockchain connector. If you are new to MCP, think of it as a standard way for an AI assistant to call well-described tools instead of scraping webpages or guessing API calls.\n\n## What you can ask\n\nYou never need to name a tool. Ask a normal question and let the AI assistant choose the right tool or chain of tools:\n\n- *\"What is the Blurt blockchain's market cap and how many BLURT are in circulation?\"*\n- *\"Analyze the account `nalexadre`: profile, vote value in USD, followers and latest posts.\"*\n- *\"Find a community about cats and show me its details.\"*\n- *\"List the top 10 Blurt blockchain witnesses and flag any that look inactive or behind on version.\"*\n- *\"Who are the biggest curators on this post, and how much is each of their upvotes worth?\"*\n\n→ More examples and the read-tool reference: **[Tools & resources](https://blurt-blockchain.gitlab.io/blurt-mcp-server/tools.html)**.\n\n## What it can do\n\n| Area | Examples |\n| --- | --- |\n| 👤 **Accounts & wallets** | profiles, balances, Blurt Power, operation history, rewards, pending rewards, relationships, delegations, account lookup |\n| ✍️ **Content** | individual posts, full discussion trees, account posts, trending/ranked publications |\n| 🌐 **Communities** | discovery, details, subscriptions and roles |\n| 🌱 **Onboarding** | referrals from the beBlurt referral system |\n| 🏅 **Curation** | post voters and rebloggers, vote-value estimates in BLURT and USD |\n| 🔔 **Notifications** | recent notifications and unread counts |\n| 🏛️ **Governance** | witness ranking, witness health and account witness votes |\n| 💰 **Market & network** | BLURT price, market cap, supply, reward pool and chain status |\n| 🔎 **Search / fetch** | `blurt://` resource discovery for connector-style clients |\n| ✍️ **Write** *(opt-in, local by default)* | claim, vote, comment, post and social actions signed locally with a posting key; see [write operations](https://blurt-blockchain.gitlab.io/blurt-mcp-server/write-operations.html) |\n\n## Quick start\n\n### 1. Hosted endpoint\n\nUse this when your AI app supports remote MCP / Streamable HTTP connectors:\n\n```text\nhttps://mcp.blurt-blockchain.com/mcp\n```\n\n### 2. Desktop app through a bridge\n\nSome desktop apps only launch local commands. In that case, bridge the hosted endpoint with `mcp-remote`:\n\n```json\n{\n  \"mcpServers\": {\n    \"blurt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.blurt-blockchain.com/mcp\"]\n    }\n  }\n}\n```\n\n### 3. Fully local stdio server\n\nUse this when your client launches a local MCP server process:\n\n```bash\nnpx -y -p @blurt-blockchain/blurt-mcp-server blurt-mcp-stdio\n```\n\nFor client configuration, prefer the same environment-file layout used by write mode, even for read-only usage:\n\n```json\n{\n  \"mcpServers\": {\n    \"blurt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@blurt-blockchain/blurt-mcp-server\", \"blurt-mcp-stdio\"],\n      \"env\": { \"BLURT_ENV_FILE\": \"/home/you/.config/blurt-mcp/secret.env\" }\n    }\n  }\n}\n```\n\nThe file can start empty or contain read-only configuration such as `BLURT_RPC_URLS` and `BLURT_PRICE_URL`. Add a posting key only if you deliberately enable local write tools.\n\n→ Full setup guide: **[Installation & usage](https://blurt-blockchain.gitlab.io/blurt-mcp-server/usage.html)**\n→ Copy-paste client configs: **[Install snippets](https://blurt-blockchain.gitlab.io/blurt-mcp-server/install-snippets.html)**.\n\n## Compatible clients\n\nRemote-capable clients can use the hosted endpoint directly. Stdio-only clients can either bridge the hosted endpoint with `mcp-remote` or run the package locally.\n\n| Client | Type | Local stdio | Remote HTTP | Config file | Open source |\n| --- | --- | ---: | ---: | --- | ---: |\n| ChatGPT web — Apps / Connectors | Web | No | Yes | UI only | No |\n| Claude Desktop | Desktop | Yes | Yes | `claude_desktop_config.json` | No |\n| Claude Code | CLI | Yes | Yes | `~/.claude.json`, `.mcp.json` | No |\n| OpenAI Codex (CLI / IDE) | CLI / IDE | Yes | Yes | `~/.codex/config.toml` | Yes |\n| VS Code — Copilot agent | IDE | Yes | Yes | `.vscode/mcp.json` | Partial |\n| Cursor | IDE | Yes | Yes | `.cursor/mcp.json` | No |\n| Windsurf / Cascade | IDE | Yes | Yes | `mcp_config.json` | No |\n| Gemini CLI | CLI | Yes | Yes | `~/.gemini/settings.json` | Yes |\n| JetBrains AI Assistant | IDE | Yes | Yes | Settings UI | No |\n| Cline | IDE ext. / CLI | Yes | Yes | `~/.cline/mcp.json` | Yes |\n\n→ Full compatibility matrix: **[Compatible clients](https://blurt-blockchain.gitlab.io/blurt-mcp-server/clients.html)**. *(Community-maintained; as of 2026-06-28.)*\n\n## Documentation\n\n- [Overview](https://blurt-blockchain.gitlab.io/blurt-mcp-server/) — start here if you are new to the project\n- [Installation & usage](https://blurt-blockchain.gitlab.io/blurt-mcp-server/usage.html) — requirements, configuration and connection modes\n- [Install snippets](https://blurt-blockchain.gitlab.io/blurt-mcp-server/install-snippets.html) — copy-paste hosted, package, stdio and client configs\n- [Tools & resources](https://blurt-blockchain.gitlab.io/blurt-mcp-server/tools.html) — readable tool categories and example prompts\n- [Generated tool reference](https://blurt-blockchain.gitlab.io/blurt-mcp-server/tools.generated.html) — generated contract index from the tool registry\n- [Write operations](https://blurt-blockchain.gitlab.io/blurt-mcp-server/write-operations.html) — opt-in local signing with a posting key\n- [Compatible clients](https://blurt-blockchain.gitlab.io/blurt-mcp-server/clients.html) — client compatibility notes\n- [Architecture](https://blurt-blockchain.gitlab.io/blurt-mcp-server/architecture.html), [MCP compatibility register](https://blurt-blockchain.gitlab.io/blurt-mcp-server/mcp-compatibility-register.html), [Deployment](https://blurt-blockchain.gitlab.io/blurt-mcp-server/deployment.html), [Operations](https://blurt-blockchain.gitlab.io/blurt-mcp-server/operations.html)\n- [Security](https://blurt-blockchain.gitlab.io/blurt-mcp-server/security.html) · [Contributing](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/blob/main/CONTRIBUTING.md)\n\n## Security\n\nThe server is **read-only by default** and holds **no private keys**. Optional write tools are **opt-in and local by default**, use a **posting key only** and are not exposed over HTTP unless an operator deliberately enables an unsafe trusted-deployment override.\n\nNew write deployments should start with a small capability profile such as `BLURT_WRITE_PROFILE=curator`. See the [security guide](https://blurt-blockchain.gitlab.io/blurt-mcp-server/security.html) and [write operations](https://blurt-blockchain.gitlab.io/blurt-mcp-server/write-operations.html).\n\n## Support\n\nYou can contact the maintainer in the `dev` channel of the Blurt Discord server: <https://discord.blurt.world/>.\n\nUseful Blurt blockchain development posts can also be found in the [Dev on Blurt community](https://beblurt.com/community/blurt-101010).\n\n## Contributing\n\nPull requests for new features, bug fixes and documentation improvements are welcome.\n\nBefore opening a pull request, run the checks that match your change. For most code changes:\n\n```bash\nnpm ci\nnpm run docs:check\nnpm run build\nnpm test\nnpm run typecheck\n```\n\nSee [CONTRIBUTING.md](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/blob/main/CONTRIBUTING.md) for the development workflow.\n\n## Author\n\n[@nalexadre](https://beblurt.com/@nalexadre) — Blurt blockchain witness.\n\n## License\n\nThis package currently declares `GPL-3.0-or-later` in `package.json`.\n\nSee the [LICENSE file](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/blob/main/LICENSE) for the full license text.\n","readmeFilename":"README.md"}