Claude MarketplacesSubmit

Mcp Server

xcp/mcp-server

Gives your AI agent read and write access to Counterparty, the token protocol built on Bitcoin. You get 24 query tools for balances, assets, DEX orders, dispensers, and transaction history, plus 18 compose tools for sending tokens, placing orders, issuing assets, distributing dividends, and running fair launches. The server can run in compose-only mode where it returns unsigned transaction hex for you to sign offline, or you can pass it a WIF private key to enable the sign_and_broadcast tool. It talks to the Counterparty API over HTTP and includes embedded protocol docs so the agent understands things like divisibility, XCP fees, and the XCP-420 fair mint standard. Useful if you're building token automation, trading bots, or just want to interact with Bitcoin tokens through natural language.

tools: 49
auth: Secret needed
transport: STDIO
env vars: 3
last updated: Feb 11, 2026

Tools

49 tools

Public tool metadata for what this MCP can expose to an agent.

get_balancesAll token balances for an address

All token balances for an address

No parameter schema in public metadata yet.

get_balanceSingle asset balance for an address

Single asset balance for an address

No parameter schema in public metadata yet.

get_asset_infoAsset metadata (supply, divisibility, issuer)

Asset metadata (supply, divisibility, issuer)

No parameter schema in public metadata yet.

get_asset_balancesAll holders of an asset

All holders of an asset

No parameter schema in public metadata yet.

get_assetsSearch/list assets

Search/list assets

No parameter schema in public metadata yet.

get_issuancesIssuance history for an asset

Issuance history for an asset

No parameter schema in public metadata yet.

get_owned_assetsAssets issued by an address

Assets issued by an address

No parameter schema in public metadata yet.

get_ordersDEX orders

DEX orders

No parameter schema in public metadata yet.

get_orderSingle order by hash

Single order by hash

No parameter schema in public metadata yet.

get_order_matchesMatches for an order

Matches for an order

No parameter schema in public metadata yet.

get_orders_by_pairOrder book for a trading pair

Order book for a trading pair

No parameter schema in public metadata yet.

get_asset_ordersOrders involving an asset

Orders involving an asset

No parameter schema in public metadata yet.

get_address_ordersOrders by address

Orders by address

No parameter schema in public metadata yet.

get_dispensersDispensers

Dispensers

No parameter schema in public metadata yet.

get_dispenserSingle dispenser by hash

Single dispenser by hash

No parameter schema in public metadata yet.

get_dispensers_by_assetDispensers for an asset

Dispensers for an asset

No parameter schema in public metadata yet.

get_address_dispensersDispensers by address

Dispensers by address

No parameter schema in public metadata yet.

get_dispensesPurchases from a dispenser

Purchases from a dispenser

No parameter schema in public metadata yet.

get_dividendsDividend distributions for an asset

Dividend distributions for an asset

No parameter schema in public metadata yet.

get_address_transactionsTransaction history for an address

Transaction history for an address

No parameter schema in public metadata yet.

get_sendsToken transfers from an address

Token transfers from an address

No parameter schema in public metadata yet.

get_transactionSingle transaction by hash

Single transaction by hash

No parameter schema in public metadata yet.

get_utxo_balancesTokens attached to a UTXO

Tokens attached to a UTXO

No parameter schema in public metadata yet.

get_latest_blockLatest block info

Latest block info

No parameter schema in public metadata yet.

compose_sendSend tokens to an address

Send tokens to an address

No parameter schema in public metadata yet.

compose_mpmaMulti-party multi-asset send

Multi-party multi-asset send

No parameter schema in public metadata yet.

compose_orderPlace a DEX order

Place a DEX order

No parameter schema in public metadata yet.

compose_cancelCancel an open order

Cancel an open order

No parameter schema in public metadata yet.

compose_btcpayPay for a matched BTC order

Pay for a matched BTC order

No parameter schema in public metadata yet.

compose_issuanceCreate or update an asset (supports inscriptions)

Create or update an asset (supports inscriptions)

No parameter schema in public metadata yet.

compose_dispenserCreate, open, or close a dispenser

Create, open, or close a dispenser

No parameter schema in public metadata yet.

compose_dispenseBuy from a dispenser

Buy from a dispenser

No parameter schema in public metadata yet.

compose_dividendDistribute dividends to holders

Distribute dividends to holders

No parameter schema in public metadata yet.

compose_broadcastBroadcast a message (supports inscriptions)

Broadcast a message (supports inscriptions)

No parameter schema in public metadata yet.

compose_sweepSweep all assets to a destination

Sweep all assets to a destination

No parameter schema in public metadata yet.

compose_destroyPermanently burn tokens

Permanently burn tokens

No parameter schema in public metadata yet.

compose_fairminterCreate a fair launch (supports inscriptions)

Create a fair launch (supports inscriptions)

No parameter schema in public metadata yet.

compose_xcp420_fairminterXCP-420 compliant fair launch

XCP-420 compliant fair launch

No parameter schema in public metadata yet.

compose_fairmintMint from an active fair launch

Mint from an active fair launch

No parameter schema in public metadata yet.

compose_attachAttach tokens to a UTXO

Attach tokens to a UTXO

No parameter schema in public metadata yet.

compose_detachDetach tokens from a UTXO

Detach tokens from a UTXO

No parameter schema in public metadata yet.

compose_movetoutxoMove a UTXO to a new output

Move a UTXO to a new output

No parameter schema in public metadata yet.

sign_and_broadcastSign and broadcast (requires signing keys)

Sign and broadcast (requires signing keys)

No parameter schema in public metadata yet.

broadcast_transactionBroadcast an already-signed transaction

Broadcast an already-signed transaction

No parameter schema in public metadata yet.

get_fee_estimateCurrent fee rate estimate

Current fee rate estimate

No parameter schema in public metadata yet.

decode_transactionDecode raw transaction hex

Decode raw transaction hex

No parameter schema in public metadata yet.

unpack_transactionDecode a Counterparty message from a transaction

Decode a Counterparty message from a transaction

No parameter schema in public metadata yet.

get_server_infoNode status and version

Node status and version

No parameter schema in public metadata yet.

api_requestRaw API request to any endpoint

Raw API request to any endpoint

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

COUNTERPARTY_NODE

Counterparty node URL (default: https://api.counterparty.io:4000)

SIGNER_PRIVATE_KEYsecret

WIF-encoded private key for transaction signing

SIGNER_ADDRESS

Bitcoin address for the signing key

Readme

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.

Install

No download needed — just add the config below to your AI client. npx fetches and runs the server automatically.

Claude Desktop

Add to claude_desktop_config.json (how to find it):

{
  "mcpServers": {
    "counterparty": {
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"]
    }
  }
}

Claude Code

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.

View the full README on GitHub

Details

Repository: github.com/xcp/mcp-server
Category: Finance & Commerce
Package: @21e14/mcp-server
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Finance & Commerce MCP servers

1

Spree Commerce developer docs for AI agentsspree/spreeSpree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.15.8Kstars

2

Tradememory Protocolmnemox-ai/tradememory-protocolTamper-evident decision audit trail and outcome-weighted memory for AI trading agents.1.4Kstars

3

Finlab Aikoreal6803/finlab-aiQuantitative trading toolkit with 900+ data columns, backtesting, and 60+ strategy examples.425stars

4

Blockrun Mcpblockrunai/blockrun-mcpWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.390stars

5

AkTools MCP Serveraahl/mcp-aktoolsMCP Server for stock and crypto381stars

6

AdLoopklosk/adloopGoogle Ads MCP server with Reddit Ads, GA4 and Tag Manager. Every change is previewed first.300stars