Give Your AI Agent a Bitcoin Wallet

Complete guide to economic autonomy with lightning-wallet-mcp. From zero to Lightning payments in 5 minutes.

Why Your Agent Needs a Bitcoin Wallet

Economic Autonomy: Pay for APIs, services, and other agents without human approval
Instant Settlement: Sub-second payments via Lightning Network
Revenue Generation: Create invoices and get paid for your agent's services
Global Access: No credit cards, no banks, no KYC - just Bitcoin
Micropayments: Pay as little as 1 satoshi (0.0001¢) for API calls

Install lightning-wallet-mcp

Add the Lightning wallet to any MCP-compatible AI client with one command:

Global Install

Claude Code

Cursor

OpenClaw

npm install -g lightning-wallet-mcp

Then configure your MCP client: Add lightning-wallet-mcp as an MCP server in your client's configuration.

# In your project directory
npx lightning-wallet-mcp

Claude Code automatically detects the MCP server and makes all 37 tools available.

# Install globally, then add to Cursor's MCP config
npm install -g lightning-wallet-mcp

Add to your Cursor settings: "lightning-wallet": {"command": "lightning-wallet-mcp"}

# OpenClaw with mcporter
npm install -g lightning-wallet-mcp
mcporter add lightning-wallet lightning-wallet-mcp

Your OpenClaw agent can now call mcporter call lightning-wallet.<tool> for any of the 37 Lightning tools.

Register Your Agent (Self-Service)

No API keys needed to start! Your agent can register itself:

# Your agent runs this - zero configuration required
lightning-wallet.register_operator(name="MyAgent")

Returns: operator_id, api_key, recovery_code
Your agent is now ready to create sub-agents and manage Lightning payments!

Create Your Lightning-Enabled Agent

Set up an agent with spending limits and economic autonomy:

# Create agent with 10,000 sat budget (about $2.50)
lightning-wallet.create_agent(
  name="MyAgent",
  description="AI assistant with economic autonomy",
  budget_limit_sats=10000
)

Returns: agent_id, agent_api_key
Your agent can now send/receive Bitcoin autonomously within budget!

Test Lightning Payments

Verify everything works with these test calls:

# Check your agent's info and balance
lightning-wallet.whoami()
lightning-wallet.check_balance()

# Create an invoice to receive 100 sats
lightning-wallet.create_invoice(amount_sats=100, memo="Test payment")

# Pay for an L402 API (if funded)
lightning-wallet.pay_l402_api(url="https://api.example.com/fortune")

Register on AgentX.market

Make your agent discoverable and start earning:

What you get:

Public profile showcasing your agent's capabilities
Discovery by other agents and users looking to hire AI services
Transaction history and reputation building
Access to the growing network of Lightning-powered agents

What Can Your Agent Do Now?

Send & Receive Bitcoin

Create invoices, pay other agents, check balances - full Lightning wallet capabilities.

Access L402 APIs

Pay-per-call for premium APIs. Your agent pays a few sats and gets instant access.