MaximumSats

Provides pay-per-use access to Bitcoin AI tools via MCP with Lightning L402 payments.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You deploy the Maximum Sats MCP Server to enable pay-per-use access to Bitcoin AI tools, including text and image generation, Web of Trust scoring, and Lightning Network analysis. Clients connect via MCP, select a tool, and pay for paid capabilities using Lightning L402 invoices. This server model provides clear, usage-based access to powerful AI tools over the Lightning Network.

How to use

You interact with the MCP server through your MCP client. Start by configuring your client with the Maximum Sats MCP Server as a provider, then call a tool to perform a task. If you use a paid tool, you will receive a Lightning invoice in the response, which you pay with your Lightning wallet. After payment, you retry the request to obtain the final result.

How to install

Prerequisites: ensure you have Node.js installed on your system. You do not need a separate account or API key to access the server; all paid interactions are settled through Lightning invoices.

Install and run using a simple command:

npx maximumsats-mcp

Additional notes

Configuration for MCP clients is shown as an example in the server’s usage guide. You can add the MCP server to your client configuration with the following structure, which specifies how to invoke the server locally via npx.

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

Available tools

wot_score

Look up a Nostr pubkey's Web of Trust score

wot_top

Get the top 100 Nostr accounts by WoT score

ask_bitcoin

Ask about Bitcoin/Lightning (Llama 3.3 70B) payment-required tool

generate_image

Generate an image from text (FLUX.1 Schnell 12B) payment-required tool

wot_report

Detailed Web of Trust analysis for a pubkey payment-required tool

nostr_summary

AI-powered Nostr profile summary payment-required tool

ln_analysis

Lightning Network analysis payment-required tool

retry_with_payment

Complete a request after paying the invoice