AIBase
EN
Explore
Lightning Wallet MCP
L

Lightning Wallet MCP

Lightning Wallet MCP is an MCP server and CLI tool that provides Bitcoin Lightning Network wallet functionality for AI agents, supporting L402 and X402 payment protocols. It allows AI agents to make Lightning Network payments, receive funds, manage the budgets of multiple sub-agents, and interact with paid APIs.
FinanceDeveloper tools#Lightning Network#AI wallet#Payment protocol#Agent management.TypeScript
2.5 points
6.5K
Open Site

Overview

Installation

Content Details

Alternatives

What is Lightning Wallet MCP?

Lightning Wallet MCP is a Bitcoin wallet system designed for AI agents. Through the Model Context Protocol (MCP), AI assistants can use the Lightning Network to make payments, receive Bitcoin, access paid APIs, and manage the funds of multiple sub-agents. It's like equipping AI agents with digital wallets, enabling them to conduct autonomous transactions in the Bitcoin economy.

How to use Lightning Wallet MCP?

There are two main ways to use it: 1) Integrate it as an MCP server into AI development environments such as Claude Code and Cursor; 2) Use it as a command-line tool for AI agents that support Bash, like OpenClaw and Pi. You need to register an account first to obtain an API key, and then you can create agents, set budgets, make payments, and perform other operations.

Applicable scenarios

It is suitable for AI agents that require autonomous payment capabilities, such as: automatic research assistants (accessing paid data APIs), trading robots, content creation tools (paying for API services), multi-agent collaboration systems (internal fund transfers), AI game economic experiments, etc.

Main features

Lightning Network payments
Supports sending and receiving Bitcoin Lightning Network payments, with transaction confirmation times in the millisecond range
L402/X402 protocol support
Automatically accesses paid APIs that use the L402 (Lightning Network) or X402 (USDC on Base) protocols. Agents only need to pay in Bitcoin
Multi-agent management
Operators can create multiple sub-agents and set independent budgets and fund limits for each agent
Keysend payments
Allows direct payments to Lightning Network nodes without an invoice, supporting additional messages
Webhook notifications
Receives real-time notifications of events such as successful payments, failed payments, and insufficient balances
Invoice decoding
Checks the detailed information of Lightning Network invoices before payment, including the amount, destination, and validity period
Budget management
Sets spending limits for each agent, monitors expenditure, and prevents overspending
Account recovery
Recovers an account using a recovery code and supports API key rotation
Advantages
Instant payments: Lightning Network transactions are confirmed in milliseconds
Dual protocol support: Compatible with both L402 and X402 paid APIs
Secure isolation: Separation of operator and agent funds reduces risks
Production-ready: Infrastructure verified through real transactions
Real-time notifications: Webhooks provide instant payment status updates
Full observability: Provides analysis, export, and detailed status tracking
Limitations
Requires basic knowledge of the Bitcoin Lightning Network
The platform charges a 2% service fee (minimum 1 satoshi)
X402 payments involve USDC/BTC exchange rate conversion
Requires configuration of environment variables or MCP server settings
There is a certain learning curve for the initial setup

How to use

Installation and registration
Install the package globally via npm and register a new account to obtain an API key
Configure the API key
Set the API key as an environment variable or use it in the MCP configuration file
Top up the account
Generate a top-up invoice and pay with any Lightning Network wallet
Create an agent
As an operator, create a sub-agent and set a budget
Start making payments
Use the agent key to make payments or access paid APIs

Usage examples

AI research assistant accessing paid data
An AI research assistant needs to access a paid API to obtain professional data for analysis
Multi-agent collaboration system
An operator manages multiple AI agents, each with an independent budget and tasks
AI game economic experiment
Multiple AI agents conduct transactions and compete in a simulated economic environment

Frequently Asked Questions

What are the L402 and X402 protocols?
How to ensure fund security?
What are the fees?
Which AI development environments are supported?
How to recover a lost API key?
Is the promotion of free satoshis still valid?

Related resources

Official documentation
Complete API documentation and usage guide
GitHub repository
Source code and issue tracking
L402 API registry
Directory of testable L402 APIs
AI game theory experiment
AI economic experiment using this MCP
Demo page
Online demonstration and examples
npm package page
npm installation and version information

Installation

Copy the following command to your Client for configuration
{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"],
      "env": {
        "LIGHTNING_WALLET_API_KEY": "your-api-key-here"
      }
    }
  }
}
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
5.4K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
6.4K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
4.5K
5 points
S
Security Detections MCP
Security Detections MCP is a server based on the Model Context Protocol that allows LLMs to query a unified security detection rule database covering Sigma, Splunk ESCU, Elastic, and KQL formats. The latest version 3.0 is upgraded to an autonomous detection engineering platform that can automatically extract TTPs from threat intelligence, analyze coverage gaps, generate SIEM-native format detection rules, run tests, and verify. The project includes over 71 tools, 11 pre-built workflow prompts, and a knowledge graph system, supporting multiple SIEM platforms.
TypeScript
6.7K
4 points
P
Paperbanana
Python
6.9K
5 points
F
Finlab Ai
FinLab AI is a quantitative financial analysis platform that helps users discover excess returns (alpha) in investment strategies through AI technology. It provides a rich dataset, backtesting framework, and strategy examples, supporting automated installation and integration into mainstream AI programming assistants.
7.3K
4 points
B
Better Icons
An MCP server and CLI tool that provides search and retrieval of over 200,000 icons, supports more than 150 icon libraries, and helps AI assistants and developers quickly obtain and use icons.
TypeScript
7.7K
4.5 points
A
Assistant Ui
assistant - ui is an open - source TypeScript/React library for quickly building production - grade AI chat interfaces, providing composable UI components, streaming responses, accessibility, etc., and supporting multiple AI backends and models.
TypeScript
7.8K
5 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
21.8K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
35.1K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
26.1K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
72.7K
4.3 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
65.8K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
33.1K
5 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
22.3K
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
98.7K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
English简体中文繁體中文にほんご
© 2026AIBase