finance

Lightning Nostr▌

by abdelstark

Lightning Nostr makes decentralized social networking easy by integrating with Nostr for posting notes and relay interac

Integrates with Nostr to enable posting notes and interacting with relays, simplifying decentralized social network engagement and content publishing.

github stars

★ 6

GitHub npm

Direct Lightning Network integrationLNBits backend support

best for

/ AI applications needing micropayment functionality
/ Bitcoin Lightning Network developers
/ Automated payment systems

capabilities

/ Pay Lightning Network invoices
/ Connect to LNBits backends
/ Process Bitcoin micropayments
/ Integrate Lightning payments into AI workflows

what it does

Enables AI models to pay Lightning Network invoices through LNBits integration, providing Bitcoin micropayment capabilities.

about

Lightning Nostr is a community-built MCP server published by abdelstark that provides AI assistants with tools and capabilities via the Model Context Protocol. Lightning Nostr makes decentralized social networking easy by integrating with Nostr for posting notes and relay interac It is categorized under finance.

how to install

You can install Lightning Nostr in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Lightning Nostr is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

🌐 Lightning Network MCP Server

A Model Context Protocol (MCP) server that enables AI models to interact with Lightning Network, allowing them to pay invoices.

🚀 Features

📝 Pay invoices on Lightning Network
🤖 MCP-compliant API for AI integration

👷‍♂️ TODOs

Add support for multiple Lightning Network backends
Implement stdin transport mode (configurable via environment variable)

📋 Prerequisites

Node.js 18+

🛠️ Installation

Installing via Smithery

To install Lightning Network MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AbdelStark/lightning-mcp --client claude

Manual Installation

Clone the repository:

git clone https://github.com/AbdelStark/lightning-mcp
cd lightning-mcp

Install dependencies:

npm install

Create a .env file:

💡 You can copy the .env.example file and modify it as needed.

# Bitcoin Lightning Network
## lnbits information
BITCOIN_LNBITS_NODE_URL="https://demo.lnbits.com"
BITCOIN_LNBITS_ADMIN_KEY="..."
BITCOIN_LNBITS_READ_KEY="..."

🚦 Usage

Starting the Server

# Development mode with hot reload
npm run dev

# Production mode
npm start

Available Tools

`pay_invoice`

Pays an invoice on the Lightning Network.

Example input:

{
  "content": "lnbc20n1pneh8papp5x0syxmdqffcltfk8mqp00qc6j4kf5elkmr5pws9gm242mw9n0ejsdqqcqzzsxqyz5vqrzjqvueefmrckfdwyyu39m0lf24sqzcr9vcrmxrvgfn6empxz7phrjxvrttncqq0lcqqyqqqqlgqqqqqqgq2qsp563lg29qthfwgynluv7fvaq5d6y2hfdl383elgc6q68lccfzvpvfs9qxpqysgq2n6yhvs8aeugvrkcx8yjzdrqqmvp237500gxkrk0fe6d6crwpvlp96uvq9z2dfeetv5n23xpjlavgf0fgy4ch980mpv2rcsjasg2hqqpalykyc"
}

🔧 Development

Project Structure

lightning-mcp/
├── src/
│   ├── index.ts        # Main server entry point
│   ├── lnbits-client.ts # Lightning Network client implementation
│   └── types.ts        # TypeScript type definitions
├── .env               # Environment configuration
└── tsconfig.json     # TypeScript configuration

Running Tests

npm test

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

📬 Contact

Feel free to follow me if you’d like, using my public key:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

<p align="center"> Made with ❤️ for the Bitcoin community </p>