Alby Bitcoin Payments MCP
About
Connect any bitcoin lightning wallet to agents to send and receive payments instantly at low cost.
Details
- Author
- getAlby
- Downloads
- 300
- Categories
- Cloud Service, Other, Finance, Developer Tools
Jump to
- Connects Bitcoin Lightning wallet to an LLM
- Uses Nostr Wallet Connect (NWC) protocol
- Supports NWC, LNURL, and L402 payments
- Built with Alby SDK and Alby Lightning Tools
- Based on the official MCP TypeScript SDK
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Alby Bitcoin Payments MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server by following the instructions at the GitHub repository (https://github.com/getAlby/mcp/). It can be used remotely or client-side.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"alby bitcoin payments mcp": {
"nwc": {
"command": "npx",
"args": [
"-y",
"@getalby/mcp"
],
"env": {
"NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
}
}
}
}
}McpServers
{
"nwc": {
"command": "npx",
"args": [
"-y",
"@getalby/mcp"
],
"env": {
"NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
}
}
}Control a Lightning wallet using Nostr Wallet Connect (NWC).
NEW:also checkoutAlby CLIfor agents that don't support MCP.
Connect a bitcoin lightning wallet to your LLM using Nostr Wallet Connect (NWC).
This MCP server uses theofficial MCP TypeScript SDK
This MCP server has knowledge ofNWC,LNURLandL402usingAlby SDKandAlby Lightning Tools.
Take a look atAwesome AI Bitcoinfor places where you can use the Alby MCP.
In case you get stuck, see troubleshooting section below.
If your agent supports remote MCP servers - SSE (e.g. N8N) or HTTP Streamable transports, you can connect to Alby's MCP server.
- SSE:https://mcp.getalby.com/sse
- HTTP Streamable:https://mcp.getalby.com/mcp
Both require providing an NWC connection secret as authentication, either asBearerauthentication (preferred) or via thenwcquery parameter.
Example:Authorization: Bearer nostr+walletconnect://...
If your agent UI supports bearer auth, just paste the connection secret into the bearer auth field.
If your agent doesn't support bearer auth, you can pass the NWC connection secret as a query parameter.
Example:https://mcp.getalby.com/sse?nwc=ENCODED_CONNECTION_SECRETorhttps://mcp.getalby.com/mcp?nwc=ENCODED_CONNECTION_SECRET
To get ENCODED_CONNECTION_SECRET, open browser devtools (right click -> inspect) and enter this in the console, with your own NWC connection secret set:
encodeURIComponent("nostr+walletconnect://...");
In case there is a message asking for confirmation for pasting, follow the instructions, and then enter the above command again.
Once the command has run, copy the output and replace ENCODED_CONNECTION_SECRET. It will look like this:nostr%2Bwalletconnect%3A%2F%2F...
Currently, at least a Claude Pro subscription is required to be able to connect to remote MCP servers.
- Go to Settings -> Connectors
- Click on "Add custom connector"
- Call italby
- What is the endpoint URI:https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL(see above for instructions)
Add this to your claude_desktop_config.json:
{ "mcpServers": { "nwc": { "command": "npx", "args": ["-y", "@getalby/mcp"], "env": { "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE" } } } }
- Open Goose Desktop
- Go To Settings -> Advanced Settings
- Click on "Add custom Extension"
- Call italby, and change the type toHTTP Streamable
- What is the SSE endpoint URI:https://mcp.getalby.com/mcp
- Timeout: 30
- Description: no
- environment variables: no
- Typegoose configure
- Add extension -> Remote Extension (HTTP Streamable)
- Call italby
- What is the HTTP Streamable endpoint URI:https://mcp.getalby.com/mcp
- Timeout: 30
- Description: no
- environment variables: no
- add custom headers: yes
- header name:Authorization
- header value:Bearer nostr+walletconnect://...(replace with your connection secret)
- Typegoose configure
- Add extension -> Command Line Extension
- Call italby
- What command should be run:npx -y @getalby/mcp
- Timeout: 30
- Description: no
- environment variables: yes
- environment variable name:NWC_CONNECTION_STRING
- environment variable value:nostr+walletconnect://...(your NWC connection secret here)
Copy the below and paste it into a cline prompt. It should prompt you to update the connection string.
Add the following to my MCP servers list: "nwc": { "command": "npx", "args": ["-y", "@getalby/mcp"], "env": { "NWC_CONNECTION_STRING": "nostr+walletconnect://..." }, "disabled": false, "autoApprove": [] }
claude mcp add --transport http alby https://mcp.getalby.com/mcp --header "Authorization: Bearer nostr+walletconnect://..."
You can use the native N8N MCP Client tool connected to an AI agent. Enter your SSE endpoint, set authentication to "Bearer" and paste your NWC connection secret.
Tested with OpenRouter + anthropic/claude-3.7-sonnet
See theN8N workflowfor a simple example
Currently this MCP server only works via command line (STDIO).
You can install then8n-nodes-mcpcommunity node and run n8n with tools enabled e.g.
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n
Create a blank workflow and add an AI agent node. Configure your LLM model and add a new tool "MCP Client" (which will have a cube next to it showing it's a community node).
Configure the MCP Client by adding a credential with Command Line (STDIO) selected.
command:npxarguments:-y @getalby/mcpenvironmentsNWC_CONNECTION_STRING=nostr+walletconnect://your_key_here(create the whole line in a text editor and paste it in, since the password field cannot be switched to plaintext)
{ "mcpServers": { "alby": { "serverUrl": "https://mcp.getalby.com/sse?nwc=ENCODED_NWC_URL" } } }
- Replace "ENCODED_NWC_URL" as descripted above. Click "Save" and restart the Windsurf editor.
By default NWC MCP Server runs locally inSTDIOmode.
You can set the following environment variable:MODE=HTTPwhich will enable Streamable HTTP (http://localhost:3000/mcp) and SSE (http://localhost:3000/sseNote: SSE is deprecated).
HTTP requires bearer authorization, where the token is a wallet's NWC connection secret. See the authentication section further above in the README.
- Node.js 20+
- Yarn
- A connection string from a lightning wallet that supports NWC
Copy.env.exampleto.envand update your connection string
Inspect the tools (use/test without an LLM)
Make sure you use a decent model (e.g. Claude Sonnet 3.7) otherwise the MCP server will not work.
Failure to connect to wallet, secret missing
Make sure you copied the entire NWC connection secret, without spaces
Visitsupport.getalby.comand we're happy to help you get the MCP server working.
MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for multiple tunnel providers (ngrok, zrok, manual).
Give AI agents a Bitcoin wallet with Lightning Network payments
Self Hosted Payment gateway for agents, openclaw, hermes and more
Zen7 Payment Agent is the first implementation project of DePA (Decentralized Payment Agent), pioneers next-generation intelligent payment infrastructure.
Trustless AI task verification and XRPL escrow management — post jobs, verify completions, and release XRP payments automatically via MCP.
Remote MCP discovery for real-time crypto, FX, and metals market data, with x402-paid HTTP endpoints settled in USDC on Solana and Base.
Trust layer for AI agent commerce: escrow payments, verifiable reputation, and bounty marketplace with USDC/USDT/BTC Lightning support.
Crypto Market Pulse & Base USDC Stats
x402-paid MCP server: live crypto market pulse ($0.001) and Base USDC on-chain stats ($0.005), settled in USDC on Base mainnet.
Crypto Market Pulse & Base USDC Stats (cryptopulse)
Pay-per-call crypto market data on Base via x402 USDC micropayments: BTC/ETH/SOL/USDC prices, Base chain stats, USDC analytics, DNS, JSON repair.
AI intelligence oracle + cross-border settlement rail. 10-layer Stability Oracle (climate, macro, FX, ESG) with x402 pay-per-call API. USDC/EURC settlement on Base at 1.385% all-in.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
