Log inSubmit server
Aibtc MCP Server logo

Aibtc MCP Server

Bitcoin- and Stacks-focused MCP tools for wallets, transactions, sBTC, tokens, DeFi, NFTs, and paid APIs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Aibtc MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-85": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server@latest"
      ],
      "env": {
        "NETWORK": "YOUR_VALUE_HERE",
        "AIBTC_TOOLS": "YOUR_VALUE_HERE",
        "OPENROUTER_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Aibtc MCP Server connects AI agents to Bitcoin and Stacks operations, including wallet management, balances, transfers, smart contracts, sBTC, tokens, NFTs, DeFi, and x402 payments. It runs as a standard stdio MCP server and can create or import encrypted local wallets under ~/.aibtc/. Use it when an agent needs to inspect or transact with Bitcoin-native assets, with testnet support and spend controls for selected workflows.

Use cases

  • Create and manage encrypted Bitcoin and Stacks wallets
  • Check STX, sBTC, and SIP-010 token balances
  • Transfer STX or sBTC and monitor transactions
  • Call and deploy Stacks smart contracts
  • Deposit or withdraw sBTC across Bitcoin L1 and Stacks

Key features

  • Encrypted local wallet storage
  • Stacks transactions and Clarity contract calls
  • sBTC deposits, withdrawals, and status tracking
  • SIP-010 token balance queries
  • Configurable tool profiles and testnet mode
  • OpenRouter bridge with spend controls

Tools381

What Aibtc MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~69.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/21 checks healthy over the last 93d

What it can do

From the 381 tools this server returned when we ran it.

Runs commands · 8Can delete or modify data · 10Handles credentials · 59Makes network requests · 23Read-only tools · 363
Network at startup3 connections
Files written at startup2
Install scriptsprepare
npm provenanceSigned build
Package age278 days
Maintainers1

Observed 2026-10-25 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · @aibtc/mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars12Stargazers on the source repository.
npm downloads5.2kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed381Callable tools this server registers over MCP.

How Aibtc MCP Server works

What Aibtc MCP Server does

Aibtc MCP Server exposes Bitcoin- and Stacks-oriented capabilities to MCP-compatible AI clients. Its wallet tools let an agent create, import, unlock, lock, list, switch, export, delete, and manage locally encrypted wallets. A generated wallet uses a BIP39 24-word mnemonic, which is shown once during creation and stored in encrypted form under ~/.aibtc/.

The server covers STX balances and transfers, signed transaction broadcasting, Clarity contract calls and deployment, read-only contract queries, transaction status checks, and SIP-010 token balances. It also provides sBTC operations for balances, transfers, deposits, withdrawals to Bitcoin L1, peg information, and deposit or withdrawal status.

Its broader feature set includes Bitcoin L1 balances and UTXO operations, SIP-009 NFTs, ALEX and Zest DeFi workflows, stacking and PoX operations, BNS domains, and x402 payment handling. Tool groups can be selected so an agent does not need every available definition in its context.

How it works

Installers configure the server for supported MCP clients, or the server can be added manually as a stdio process using npx @aibtc/mcp-server@latest. The installer merges its settings into an existing client configuration. Claude Code is the default installation target; flags are available for Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex, and VS Code.

Wallet credentials are encrypted locally with AES-256-GCM. Transactions require an unlocked wallet. STX amounts use micro-STX, while sBTC amounts use eight-decimal satoshi units. Contract calls accept typed arguments and can include STX, fungible-token, and NFT post conditions. Spending limits can constrain STX and sBTC leaving the wallet.

A testnet mode is available through the --testnet installation option. The optional OpenRouter bridge runs the server in a model-driven tool loop and supports read-only mode, allowlists, blocklists, spend caps, network selection, and a maximum turn count.

Setup and configuration

Run npx @aibtc/mcp-server@latest --install for a Claude Code setup, or add --desktop, --cursor, --windsurf, --gemini, --codex, or --vscode for the corresponding client. The interactive installer can create a wallet, print its addresses, and display the generated password and mnemonic once. Use --no-wallet to skip wallet creation and create or import one later through tools.

Set NETWORK to select the network in a manual configuration. AIBTC_TOOLS controls loaded tool groups: core provides a smaller default set, comma-separated groups add capabilities, and all loads the full set. If it is unset, all tools are loaded. The OpenRouter bridge requires OPENROUTER_API_KEY.

Limitations and notes

The mnemonic and wallet password require careful handling: the mnemonic is only shown once during creation, and anyone with it can access the funds. Exporting a mnemonic should be reserved for a secure environment. Deleting a wallet is permanent, and rotating its password locks an already-unlocked wallet until it is unlocked again.

sBTC deposits build, sign, and broadcast Bitcoin transactions and use the wallet's Taproot address for the reclaim path. Cardinal UTXOs are used by default; enabling ordinal UTXOs is intended for advanced users. sBTC withdrawals create a request that signers later process on Bitcoin L1, so status checks are part of that workflow.

The OpenRouter bridge applies its allow and block rules at execution time. Its safety receipt describes configured boundaries but does not claim that funds moved. Keep write tools disabled or constrained when an agent should only inspect balances, contracts, or transaction status.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Aibtc MCP Server

Aibtc MCP Server is an MCP server that connects AI agents to Bitcoin and Stacks wallets and blockchain operations. Its main tools manage encrypted wallets, query STX, sBTC, and token balances, transfer assets, call contracts, deploy contracts, broadcast transactions, and track sBTC deposits or withdrawals.

Install it with `npx @aibtc/mcp-server@latest --install`. This targets Claude Code by default; add `--desktop`, `--cursor`, `--windsurf`, `--gemini`, `--codex`, or `--vscode` for other supported clients. The installer merges its configuration and should be followed by a client restart.

Yes. Run `npx @aibtc/mcp-server@latest --install --cursor` to write the Cursor MCP configuration. The server uses the standard stdio MCP transport, and the installer places its settings in Cursor's MCP configuration without clobbering existing servers or settings.

Wallets are encrypted locally with AES-256-GCM and stored under `~/.aibtc/`. The wallet can be locked to clear sensitive data from memory, and an automatic lock timeout can be configured. The creation mnemonic is displayed once, so it must be backed up securely.

Add `--testnet` to the installation command, such as `npx @aibtc/mcp-server@latest --install --cursor --testnet`. The option can be combined with the supported client installation flags and selects testnet for that setup.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAibtc MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-server-85?style=directory)](https://allmcps.com/mcp/mcp-server-85)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-server-85"><img src="https://allmcps.com/api/badge/mcp-server-85?style=directory" alt="Aibtc MCP Server on AllMCPs" /></a>