Aibtc MCP Server

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.

Local serverstdio

What is the Aibtc MCP server?

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments. Exposed over MCP by the aibtc mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

The aibtc-bitcoin-wallet skill provides: - Structured workflows for Bitcoin L1 operations (balance, send, fees) - Reference guides for Pillar smart wallets and Stacks L2 DeFi - LLM-agnostic instructions that work with Claude Code, Cursor, Codex, and 20+ other tools

  • Bitcoin L1 — - Check balances, send BTC, manage UTXOs via mempool.space
  • Agent's Own Wallet — - Agents get their own wallet to perform blockchain transactions
  • Secure Storage — - Wallets encrypted with AES-256-GCM and stored locally
  • 150+ Tools — - Bitcoin L1 + comprehensive Stacks L2 operations
  • sBTC Support — - Native Bitcoin on Stacks operations
  • Token Operations — - SIP-010 fungible token transfers and queries

Its toolset

Everything the assistant can do here goes through one of these:

  • list_x402_endpoints — Discover x402 endpoints
  • execute_x402_endpoint — Execute x402 endpoint with auto-payment
  • scaffold_x402_endpoint — Generate x402 Cloudflare Worker project
  • scaffold_x402_ai_endpoint — Generate x402 AI API with OpenRouter

Configuration

You will need 4 environment variables: NETWORK, CLIENT_MNEMONIC, OPENROUTER_API_KEY, HIRO_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

The server ships on npm as @aibtc/mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

When to reach for it

This sits in the payments and commerce group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Aibtc's toolset — list_x402_endpoints, execute_x402_endpoint, scaffold_x402_endpoint and 1 more — is a fair guide to whether it matches your workflow. It is maintained by aibtcdev; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the aibtc mcp server does with a few real requests.

Available tools

ToolWhat it does
list_x402_endpointsDiscover x402 endpoints
execute_x402_endpointExecute x402 endpoint with auto-payment
scaffold_x402_endpointGenerate x402 Cloudflare Worker project
scaffold_x402_ai_endpointGenerate x402 AI API with OpenRouter

How to install the Aibtc MCP server

{
  "mcpServers": {
    "aibtc": {
      "command": "npx",
      "args": ["@aibtc/mcp-server@latest"],
      "env": {
        "CLIENT_MNEMONIC": "your twenty four word mnemonic phrase",
        "NETWORK": "testnet"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
NETWORKConfiguration value read at startup.Optional
CLIENT_MNEMONICConfiguration value read at startup.Optional
OPENROUTER_API_KEYCredential the server authenticates with.Yes
HIRO_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Aibtc to list x402 endpoints.
  • Use Aibtc to execute x402 endpoint.
  • Use Aibtc to scaffold x402 endpoint.

Frequently asked questions

It connects Aibtc to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (list_x402_endpoints, execute_x402_endpoint, scaffold_x402_endpoint, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Aibtc directly.