Counterparty MCP Server
Give AI agents the ability to interact with Counterparty — the token protocol built on Bitcoin. Query balances, assets, orders, and dispensers. Compose, sign, and broadcast transactions. Works with any MCP-compatible client.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @21e14/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
COUNTERPARTY_NODE=<value> SIGNER_PRIVATE_KEY=<secret> SIGNER_ADDRESS=<value> claude mcp add io.github.xcp-mcp-server -- npx -y @21e14/mcp-server@1.0.1在終端機中執行。
{ "mcpServers": { "io.github.xcp-mcp-server": { "command": "npx", "args": [ "-y", "@21e14/[email protected]" ], "env": { "COUNTERPARTY_NODE": "<value>", "SIGNER_PRIVATE_KEY": "<secret>", "SIGNER_ADDRESS": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Give AI agents the ability to interact with Counterparty — the token protocol built on Bitcoin. Query balances, assets, orders, and dispensers. Compose, sign, and broadcast transactions. Works with any MCP-compatible client.
Interact with Counterparty — the token protocol on Bitcoin. Query, compose, sign.
No download needed — just add the config below to your AI client. npx fetches and runs the server automatically.
Add to claude_desktop_config.json (how to find it):
{
"mcpServers": {
"counterparty": {
"command": "npx",
"args": ["-y", "@21e14/mcp-server"]
}
}
}
claude mcp add counterparty -- npx -y @21e14/mcp-server
With signing (see Signing & Broadcasting):
claude mcp add counterparty \
-e SIGNER_PRIVATE_KEY=L1aW4aubDFB7yfras2S1mN... \
-e SIGNER_ADDRESS=bc1q... \
-- npx -y @21e14/mcp-server
Manage servers with claude mcp list, claude mcp get counterparty, or claude mcp remove counterparty.
Use Ctrl+Shift+P → MCP: Add Server → Stdio, then enter:
npx -y @21e14/mcp-server
Or add to .vscode/mcp.json:
{
"servers": {
"counterparty": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@21e14/mcp-server"]
}
}
}
Add to .cursor/mcp.json:
{
"mcpServers": {
"counterparty": {
"command": "npx",
"args": ["-y", "@21e14/mcp-server"]
}
}
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"counterparty": {
"command": "npx",
"args": ["-y", "@21e14/mcp-server"]
}
}
}
In ChatGPT desktop, go to Settings → Beta Features → MCP Servers, then add:
npx -y @21e14/mcp-server
The server speaks stdio. Point any MCP-compatible client at:
npx -y @21e14/mcp-server
That's it. The agent can now query the Counterparty network and compose unsigned transactions.
To let the agent sign and broadcast transactions, add a signing key:
{
"mcpServers": {
"counterparty": {
"command": "npx",
"args": ["-y", "@21e14/mcp-server"],
"env": {
"SIGNER_PRIVATE_KEY": "L1aW4aubDFB7yfras2S1mN...",
"SIGNER_ADDRESS": "bc1q..."
}
}
}
}
This enables the sign_and_broadcast tool. Signing gives the AI agent the ability to spend funds — read the security guidance below.
bc1q...), P2SH-P2WPKH (3...), or P2TR (bc1p...). Legacy P2PKH is not supported.Without signing keys, the server returns unsigned transaction hex from all compose tools. You can review and sign offline with your own tooling. This is the safest mode.
sign_and_broadcast extracts and returns the embedded OP_RETURN data from the transaction before signing — done locally without trusting the API, so the agent can verify the transaction matches what was requested.
The server includes protocol documentation that agents can read for context:
counterparty://protocol-overview — Assets, quantities, DEX, dispensers, fair minting, fees, and operational tipscounterparty://xcp420-standard — XCP-420 fair launch standardcounterparty://quick-start — Step-by-step workflows for common operationsgit clone https://github.com/XCP/mcp-server.git
cd mcp-server
npm install
npm test
Test locally:
{
"mcpServers": {
"counterparty": {
"command": "node",
"args": ["/path/to/mcp-server/dist/index.js"]
}
}
}
MIT
Interact with Counterparty — the token protocol on Bitcoin. Query, compose, sign.
{ "mcpServers": { "io.github.xcp-mcp-server": { "command": "npx", "args": [ "-y", "@21e14/[email protected]" ], "env": { "COUNTERPARTY_NODE": "<value>", "SIGNER_PRIVATE_KEY": "<secret>", "SIGNER_ADDRESS": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:COUNTERPARTY_NODE, SIGNER_PRIVATE_KEY, SIGNER_ADDRESS。
XCP 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 Interact with Counterparty — the token protocol on Bitcoin. Query, compose, sign.