Neutron MCP Server

Add Bitcoin Lightning payments to any AI-powered app in 2 minutes. This MCP server connects Neutron's payment API to Claude, Cursor, Windsurf, and any MCP-compatible client.

Setup (2 minutes)

1. Get API Keys

Sign up at portal.neutron.me → API Keys.

2. Add to Your AI Tool

Paste this config into your tool of choice:

{
  "mcpServers": {
    "neutron": {
      "command": "npx",
      "args": ["-y", "neutron-mcp"],
      "env": {
        "NEUTRON_API_KEY": "your_api_key",
        "NEUTRON_API_SECRET": "your_api_secret"
      }
    }
  }
}

Where to paste:

| Tool | Config File | |------|-------------| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows) | | Claude Code | ~/.claude.json or project .mcp.json | | Cursor | .cursor/mcp.json in your project | | Windsurf | Windsurf MCP settings | | Cline (VS Code) | Cline MCP settings |

3. Start Using

Ask your AI assistant:

"Check my Neutron wallet balances"

That's it. You're connected.

What Can It Do?

Accept Payments

"Create a Lightning invoice for 50,000 sats"

Your AI creates the invoice, returns the payment string and QR code page. Customer pays instantly.

Send Payments

"Send 10,000 sats to [email protected]"

"Pay this Lightning invoice: lnbc100u1p..."

"Send 0.01 BTC to bc1qxy2kgd..."

Manage Treasury

"Show all wallet balances"

"Convert 0.005 BTC to USDT"

"What's the current BTC/USD rate?"

Fiat Payouts

"Look up bank codes for Vietnam"

"Send 500,000 VND to bank account 0123456789 at institution 970422"

Webhooks

"Set up a webhook at https://myapp.com/payments with secret my-secret-key"

All 20 Tools

Account

| Tool | What It Does | |------|-------------| | neutron_authenticate | Verify API credentials | | neutron_get_account | Account info and status | | neutron_get_wallets | All wallet balances | | neutron_get_wallet | Specific wallet by ID |

Payments

| Tool | What It Does | |------|-------------| | neutron_create_lightning_invoice | Generate Lightning invoice to receive BTC (auto-confirms) | | neutron_create_transaction | Create any payment: Lightning, on-chain, USDT, fiat | | neutron_confirm_transaction | Confirm a quoted transaction to execute it | | neutron_get_transaction | Check transaction status | | neutron_list_transactions | List/filter transaction history |

Receive Addresses

| Tool | What It Does | |------|-------------| | neutron_get_btc_address | Get your Bitcoin on-chain deposit address | | neutron_get_usdt_address | Get your USDT deposit address (TRON or Ethereum) |

Webhooks

| Tool | What It Does | |------|-------------| | neutron_create_webhook | Register webhook for payment notifications | | neutron_list_webhooks | List registered webhooks | | neutron_update_webhook | Update webhook URL or secret | | neutron_delete_webhook | Remove a webhook |

Reference

| Tool | What It Does | |------|-------------| | neutron_get_rate | BTC exchange rates (USD, VND, USDT, etc.) | | neutron_get_fiat_institutions | Bank codes by country (for fiat payouts) |

Key Concepts

• Amounts are in BTC, not satoshis. 10,000 sats = 0.0001 BTC.
• Two-step flow: create_transaction returns a quote → confirm_transaction executes it.
• Set amount on one side only — source OR destination, not both.
• create_lightning_invoice is a shortcut that auto-confirms (no second step needed).
• Fiat payouts require KYC (recipient name + country). Bitcoin (Lightning + on-chain), stablecoins (USDT on TRON/ETH), and swaps require no KYC.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | NEUTRON_API_KEY | Yes | Your Neutron API key | | NEUTRON_API_SECRET | Yes | Your Neutron API secret | | NEUTRON_API_URL | No | API URL (default: https://api.neutron.me) |

Example: Add Payments to a Web App

Ask your AI assistant:

"Help me add Bitcoin payments to my Next.js checkout. When a user clicks Pay, create a Lightning invoice for the cart total, show a QR code, and redirect to a success page when the webhook fires."

The AI uses neutron_create_lightning_invoice for the invoice, neutron_create_webhook for notifications, and writes the frontend + backend code — all in one conversation.

Links

• Docs: docs.neutron.me
• API Reference: docs.neutron.me/reference
• MCP Guide: docs.neutron.me/docs/mcp-for-ai-agents
• Issues: GitHub
• Contact: [email protected]

License

MIT