Blink MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to the Blink Bitcoin and Lightning Network API.

Features

• Lightning Network: Create and pay invoices, send to Lightning addresses

• On-Chain Bitcoin: Generate addresses, send transactions, estimate fees

• Stablesats (USD): Full support for USD-denominated wallets

• Intraledger Transfers: Free instant transfers between Blink users

• Webhooks: Register callbacks for payment notifications

• Real-time Subscriptions: Monitor invoice status and account updates

• Price Data: Get real-time and historical Bitcoin prices

• L402 Consumer: Discover, pay for, and cache tokens for L402-gated APIs

• L402 Producer: Create Lightning paywalls and verify payment tokens

• L402 Discovery: Search l402.directory and 402index.io for paid APIs

Related MCP server: RGB Lightning Network MCP Server

Prerequisites

• Node.js 18+

• A Blink wallet account (dashboard.blink.sv)

• A Blink API key

Installation

From Source

git clone https://github.com/yourusername/blink-mcp.git
cd blink-mcp
npm install
npm run build

Getting an API Key

1. Log in to your Blink wallet at dashboard.blink.sv

2. Go to Settings > API Keys

3. Click Create API Key

4. Select the permissions you need:

   • Read: View balances, transactions, and account info

   • Receive: Create invoices and addresses to receive payments

   • Write: Send payments and modify account settings

5. Copy the generated API key

Configuration

Set the following environment variables:

# Required: Your Blink API key
export BLINK_API_KEY=blink_xxxxxxxxxxxxx

# Optional: Network to use (default: mainnet)
export BLINK_NETWORK=mainnet  # or 'staging' for testnet

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "blink": {
      "command": "node",
      "args": ["/path/to/blink-mcp/dist/index.js"],
      "env": {
        "BLINK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if installed globally via npm:

{
  "mcpServers": {
    "blink": {
      "command": "blink-mcp",
      "env": {
        "BLINK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with Other MCP Clients

The server uses stdio transport. Run it with:

BLINK_API_KEY=your_key node dist/index.js

Available Tools

Wallet & Account (17 tools)

Lightning Network (12 tools)

On-Chain Bitcoin (7 tools)

Intraledger (Blink-to-Blink) (3 tools)

Webhooks & Subscriptions (9 tools)

L402 Protocol (6 tools)

Example Conversations

Check Balance

User: What's my Bitcoin balance?
Assistant: [Uses get_wallets tool]
Your BTC wallet has 50,000 sats and your USD wallet has $12.50.

Create Invoice

User: Create an invoice for 10,000 sats
Assistant: [Uses create_invoice tool]
Here's your Lightning invoice for 10,000 sats:
lnbc100u1p...

Send Payment

User: Send 1000 sats to user@blink.sv
Assistant: [Uses pay_lightning_address tool]
Payment of 1,000 sats sent successfully to user@blink.sv!

Monitor Invoice

User: Let me know when invoice lnbc... is paid
Assistant: [Uses subscribe_invoice_status tool]
I'm now monitoring the invoice. I'll notify you when it's paid.

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint

Architecture

src/
├── index.ts              # MCP server entry point
├── client.ts             # Blink GraphQL client
├── types.ts              # TypeScript type definitions
├── graphql/
│   └── operations.ts     # GraphQL queries, mutations, subscriptions
└── tools/
    ├── wallet.ts         # Wallet and account tools
    ├── lightning.ts      # Lightning Network tools
    ├── onchain.ts        # On-chain Bitcoin tools
    ├── intraledger.ts    # Blink-to-Blink transfer tools
    ├── webhooks.ts       # Webhook and subscription tools
    └── l402.ts           # L402 consumer, producer, and discovery tools

API Reference

This MCP server wraps the Blink GraphQL API. For detailed API documentation, visit:

• Blink Agent Playbook: Canonical AI agent API reference — order of operations, safety constraints, and verification checklist.

• Blink Developer Docs

• Blink API Playground

• llms.txt: Machine-readable discovery metadata for AI agents.

Security Considerations

• API Key Security: Never commit your API key to version control

• Permission Scoping: Use the minimum required permissions for your use case

• Write Operations: Be cautious with write permissions as they allow sending funds

• Environment Variables: Store API keys in environment variables, not in config files

Troubleshooting

"BLINK_API_KEY environment variable is required"

Make sure you've set the BLINK_API_KEY environment variable with your API key.

"GraphQL Error: Not authorized"

Your API key may not have the required permissions. Check your key's scopes in the Blink wallet settings.

WebSocket connection issues

Real-time subscriptions require a stable connection. Check your network and firewall settings.

License

MIT

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Links

• Blink Wallet

• Blink Developer Docs

• Blink Agent Playbook

• Model Context Protocol

• MCP SDK