# mcp-server

A stdio MCP server that hands the agent its own Bitcoin and Stacks wallet, so it can move funds and use DeFi tools. Useful once your agent has to sign real transactions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: aibtcdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aibtcdev/aibtc-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/aibtcdev-mcp-server

## What it does

On install the server creates a wallet and prints the Stacks and Bitcoin addresses, a password and a 24-word mnemonic. You see them once. The seed lives only as an encrypted blob (AES-256-GCM) under `~/.aibtc/`; the password is stored nowhere and the agent asks for it each time it unlocks. Wallet creation happens only in an interactive terminal, so piping the installer or running it in CI skips that step — add `--no-wallet` to skip it on purpose and set the wallet up from the agent instead.

Coverage runs from Bitcoin L1 through mempool.space (balances, sends, UTXOs) to SIP-010 tokens, SIP-009 NFTs, .btc domains, ALEX swaps, Zest lending, STX stacking and x402 payments for paid APIs. The toolset is split into groups, and the installer sets `AIBTC_TOOLS=core` — a 24-tool slice, because every tool definition eats model context. Other groups go into the server's `env` by hand.

Installers for Cursor, Windsurf, Gemini CLI, Codex and VS Code merge into the config you already have. A built-in bridge drives the tools through OpenRouter, and the spend caps, `--read-only` mode and allowlist are enforced when a tool actually runs, not just when it is listed. This server moves real money, so try `--testnet` first.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -- npx -y @aibtc/mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add aibtcdev-mcp-server -- npx -y @aibtc/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aibtcdev-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@aibtc/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aibtcdev-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aibtc/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add aibtcdev-mcp-server npx -y @aibtc/mcp-server
```

## When to use it
- give an agent its own wallet for on-chain actions
- look up a BTC balance through mempool.space
- swap tokens on ALEX from inside the chat
- call a paid API and settle it over x402
- stake STX and collect sBTC rewards

## Example prompts
- Unlock the wallet and show my BTC and STX balances
- Send 0.001 BTC to the address in my notes
- List x402 endpoints and pay for the cheapest one

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43872
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 104

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md