# aibtcdev

> aibtcdev is an open-source MCP server for finance and payments. Bitcoin and Stacks wallet and DeFi tools for AI agents, exposed over MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows, VS Code
- **Repository:** https://github.com/aibtcdev/aibtc-mcp-server
- **MCP Registry name:** io.github.aibtcdev/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-21

## About

The README describes a stdio MCP server that gives an AI client its own Bitcoin and Stacks wallet. The wallet is created or imported locally, its mnemonic is stored encrypted with AES-256-GCM under the user's home directory, and the agent unlocks it with a password before transacting.

Once connected, the server exposes a large tool set covering Bitcoin L1 balances and sends via mempool.space, sBTC deposits and withdrawals, SIP-010 and SIP-009 token and NFT operations, BNS name lookups, PoX stacking, ALEX and Bitflow swaps, Zest lending, and x402 paid API calls. Tools are grouped into profiles so a lean core set can be loaded instead of all of them.

A built-in spend limit caps STX, sBTC and BTC spending per session and per day, and an OpenRouter bridge lets the same tools be driven by non-MCP models. It suits developers and operators who want agents to hold and move Bitcoin-family assets under explicit limits.

## Features

- **Agent-owned wallet:** Creates or imports a Stacks and Bitcoin wallet from one mnemonic, stored encrypted on the local machine.
- **Tool profiles:** Lets users load only a core set of tools or add groups such as defi, ordinals or stacking to limit context size.
- **Spend limits:** Caps STX, sBTC and BTC spending per session and per day, blocking spends above the cap before signing.
- **DeFi operations:** Provides ALEX and Bitflow swap tools and Zest supply, borrow and repay tools on mainnet.
- **x402 payments:** Discovers and calls paid x402 endpoints with automatic payment handling.
- **OpenRouter bridge:** Runs the tool-call loop against an OpenRouter model, with read-only and allowlist flags.

## Good for

- Letting an AI coding assistant check Bitcoin and STX balances for a wallet it controls
- Automating small sBTC or STX transfers under a configured daily spend cap
- Querying Zest lending positions or ALEX pool data from an MCP client
- Paying for x402 API endpoints from an autonomous agent
- Looking up or registering .btc names from a chat session

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y @aibtc/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server"
      ]
    }
  }
}
```

## FAQ

### Is the server free to use?

The README names an MIT license, and the package is published on npm. It does not describe any paid tier.

### Where are wallet secrets kept?

The README says the mnemonic is stored only encrypted in ~/.aibtc/ on the local machine and the password is not saved.

### What happens if an agent tries to spend more than the limit?

According to the README, a spend over the cap is blocked before it is signed or broadcast, and the agent is told to ask the user.

### Which networks are supported?

The README lists mainnet and testnet, with mainnet as the default.

### How do I add aibtcdev to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- npx -y @aibtc/mcp-server

### What are the best alternatives to aibtcdev?

The closest alternatives to aibtcdev are Universal Blockchain MCP, azeth-protocol, Tychi MCP, MCP Agentic Wallet — open-source session management for x402 and Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [azeth-protocol](https://ai-powered.com/mcp/azeth-protocol): azeth-protocol is an open-source MCP server for agent tooling.
- [Tychi MCP](https://ai-powered.com/mcp/tychi-mcp): Tychi MCP is an open-source MCP server for finance and payments.
- [MCP Agentic Wallet — open-source session management for x402](https://ai-powered.com/mcp/mcp-agentic-wallet-open-source-session-management-for-x402): MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments.
- [Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router](https://ai-powered.com/mcp/imperium-mcp-gateway-universal-490-tool-discovery-safe-proxy): Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router is a paid MCP server for agent tooling.
- [Agent Wallet MCP](https://ai-powered.com/mcp/agent-wallet-mcp): Agent Wallet MCP is a paid MCP server for finance and payments.
- [APEX DeFi, DefiLlama, DEX & EVM Audit MCP](https://ai-powered.com/mcp/apex-defi-defillama-dex-and-evm-audit-mcp): APEX DeFi, DefiLlama, DEX & EVM Audit MCP is a freemium MCP server for finance and payments.
- [Openmm MCP](https://ai-powered.com/mcp/openmm-mcp-2): Openmm MCP is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/aibtcdev
