AgenticBTC MCP

Connect an MCP-compatible AI agent to AgenticBTC owner-controlled payment policies and payment rails.

AgenticBTC is bring-your-own-rail infrastructure. Owners keep control of credentials and funds, give each agent a scoped key, and enforce spending limits before execution.

Start here

• Public $10 Policy Demo
• Pricing
• Setup guide

The browser demo moves no funds. It shows a $3 request being approved, a $50 request being blocked by a $10 limit, and the resulting audit reason.

Requirements

• Node.js 18 or newer
• A free AgenticBTC owner account and owner API key from agenticbtc.app
• 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

npx agenticbtc-mcp start
npx agenticbtc-mcp status
npx agenticbtc-mcp --help

The help command requires no account and is the safest first local check.

Manual MCP configuration

{
  "mcpServers": {
    "agenticbtc": {
      "command": "npx",
      "args": ["-y", "agenticbtc-mcp", "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.

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

Variable	Purpose	Default
AGENTICBTC_API_URL	Hosted or self-hosted AgenticBTC API	https://agenticbtc.app
AGENTICBTC_API_KEY	Owner API key	Required for authenticated tools
AGENTICBTC_LND_HOST	Optional LND REST host	Unset
AGENTICBTC_LND_MACAROON	Optional LND macaroon	Unset

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.