AgenticBTC MCP

Govern how AI agents pay and get paid.

AgenticBTC connects MCP-compatible agents to owner-controlled policies, payments, receivables, routing, and verifiable transaction evidence. Owners keep control of credentials and funds.

Try it safely first

• Run a no-funds Payment Firewall test

• Create a free account and API key

• Follow the setup guide

The Payment Firewall test requires no account, wallet, signer, or payment credentials. It evaluates a supplied x402 or MCP payment request and returns an allow or block decision plus a downloadable evidence receipt. It does not move funds.

Related MCP server: BotWallet MCP Server

Requirements

• Node.js 18 or newer

• A free AgenticBTC owner account and API key for hosted tools

• An MCP-compatible client such as OpenClaw or Claude Desktop

• A connected payment rail only when you are ready to execute real payments

Install and verify with no account

npx agenticbtc-mcp@latest doctor

doctor checks Node.js and the public AgenticBTC API. It uses no credentials, wallet, payment rail, or funds.

Connect your agent

npx agenticbtc-mcp@latest start

The guided setup shows the account-creation URL before asking for an API key. If you exit without a key, it makes no configuration changes.

Manual MCP configuration

{
  "mcpServers": {
    "agenticbtc": {
      "command": "npx",
      "args": ["-y", "agenticbtc-mcp@latest", "server"],
      "env": {
        "AGENTICBTC_API_URL": "https://agenticbtc.app",
        "AGENTICBTC_API_KEY": "your-owner-api-key"
      }
    }
  }
}

Do not commit API keys, wallet credentials, macaroons, or private keys.

What requires an account

• Public Payment Firewall test: no account, free, no funds

• doctor and help: no account, free, no funds

• Saved policies, scoped agent keys, hosted receipts, and connected AgenticBTC tools: free account and API key required

• Real payments: configured owner-controlled rail and available funds required

Installing this package does not grant access to anyone else's funds and does not create or fund a wallet.

Optional Lightning configuration

Lightning is optional. For an LND-compatible node, set AGENTICBTC_LND_HOST and AGENTICBTC_LND_MACAROON using credentials scoped to the actions you intend to allow.

Environment variables

Legacy AGENTBTC_* variable names remain accepted for compatibility. New setups should use AGENTICBTC_*.

Development

npm install
npm test

bin/agentbtc.js   CLI setup, status, and server launcher
src/server.js     MCP server implementation
package.json      npm package metadata

Security and support

• Security-sensitive reports: support@agenticbtc.io

• Documentation: agenticbtc.io/docs

• Issues: GitHub Issues

License

MIT. See LICENSE.