MCP Money

An MCP (Model Context Protocol) money implementation for Nostr using NDK (Nostr Development Kit) with Cashu ecash functionality.

Features

Cashu Wallet Integration: Full support for Cashu ecash mints and tokens
Lightning Network: Deposit via Lightning invoices and pay Lightning invoices
Nostr Zaps: Send zaps to users using npub or NIP-05 identifiers
Multi-mint Support: Manage multiple Cashu mints simultaneously
Persistent Storage: Wallet state saved to local file with mint info caching
MCP Server: Expose wallet functionality through Model Context Protocol
CLI Interface: Direct command-line usage for all wallet operations

Installation

npm install mcp-money

Usage

MCP Server Mode (Default)

Run without arguments to start the MCP server:

npx mcp-money

CLI Mode

Use specific commands for direct wallet operations:

# Get total balance
npx mcp-money get_balance

# Get balance per mint
npx mcp-money get_mint_balances

# Create deposit invoice
npx mcp-money deposit 1000 https://testnut.cashu.space

# Pay lightning invoice
npx mcp-money pay lnbc1...

# Send a zap
npx mcp-money zap npub1... 100 "Great post!"

# Add a new mint
npx mcp-money add_mint https://mint.example.com

Authentication

The wallet supports multiple ways to provide your Nostr private key:

Command line: --nsec nsec1...
Environment variable: NSEC=nsec1...
Config file: Automatically saved to .wallet.json
Auto-generate: Creates new key if none provided

MCP Tools

When running as an MCP server, the following tools are available:

get_balance: Get the total wallet balance
get_mint_balances: Get balance breakdown per mint
deposit: Create a deposit invoice for specified amount and mint
pay: Pay a Lightning invoice
zap: Send a zap to a user
add_mint: Add a mint to the wallet

Integration with AI Assistants

Claude Code Integration

To use this wallet with Claude Code, add it to your project's MCP configuration:

{
  "mcpServers": {
    "mcp-money": {
      "command": "npx",
      "args": ["mcp-money"]
    }
  }
}

Or install globally and reference the binary directly:

npm install -g mcp-money

{
  "mcpServers": {
    "mcp-money": {
      "command": "mcp-money"
    }
  }
}

Goose Integration

To use this wallet with Goose, add it to your ~/.config/goose/config.yaml:

If you have an nsec you want to use, you can set it by passing it as --nsec nsec1....

extensions:
  money:
    args:
    - -y
    - mcp-money
    bundled: null
    cmd: npx
    description: Money for agents
    enabled: true
    env_keys: []
    envs: {}
    name: money
    timeout: 300
    type: stdio

After adding the configuration, restart your AI assistant to begin using the wallet tools.

Configuration

The wallet automatically creates a .wallet.json file to store:

Private key (nsec)
Public key (npub)
Configured relays
Configured mints
Cached mint information

Architecture

Built on top of:

NDK: Nostr Development Kit for Nostr protocol interactions
NDK Wallet: Cashu wallet implementation
Nostr Tools: Low-level Nostr utilities
Bun: Fast JavaScript runtime and package manager

Security

Private keys are stored locally in .wallet.json
Mint information is cached for performance
All Nostr communications use standard NIP protocols
Lightning payments require explicit confirmation

License

MIT

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

Support

For issues and questions, please open an issue on the GitHub repository.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

An MCP server to provide AI agents money functionalities via Nostr and Cashu.

Related MCP Servers

Postman Tool Generation MCP Server
giovannicocco
A
security
A
license
A
quality
An MCP server that generates AI agent tools from Postman collections and requests. This server integrates with the Postman API to convert API endpoints into type-safe code that can be used with various AI frameworks.
Last updated -
1
7
JavaScript
MIT License
Nostr MCP Server
AbdelStark
-
security
A
license
-
quality
A Model Context Protocol (MCP) server enabling AI models to interact with the Nostr network, facilitating note posting and interaction with the freedom of speech protocol.
Last updated -
1
19
TypeScript
MIT License
lunchmoney-mcp
leafeye
A
security
A
license
A
quality
An MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.
Last updated -
4
3
8
TypeScript
MIT License
Fewsats MCP Serverofficial
Fewsats
A
security
F
license
A
quality
An MCP server that integrates with Fewsats allowing AI agents to securely purchase anything by retrieving balances, accessing payment methods, and processing payments.
Last updated -
4
13
Python

View all related MCP servers

MCP Money

MCP Money

Features

Installation

Usage

MCP Server Mode (Default)

CLI Mode

Authentication

MCP Tools

Integration with AI Assistants

Claude Code Integration

Goose Integration

Configuration

Architecture

Security

License

Contributing

Support

Related MCP Servers

Postman Tool Generation MCP Server

Nostr MCP Server

lunchmoney-mcp

Fewsats MCP Serverofficial

New MCP Servers

MCP directory API