Skip to content

cnghockey/sats4ai-mcp-server

Repository files navigation

sats4ai-mcp

30+ AI tools paid with Bitcoin Lightning. No signup, no API keys, no KYC.

A remote MCP (Model Context Protocol) server that gives AI agents access to image generation, video creation, text generation, speech, translation, image processing, OCR, audiobook conversion, email, SMS, voice cloning, and more — all paid per-use with Lightning Network micropayments.

Quick Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

Claude Code

claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

stdio proxy (legacy MCP clients)

For clients that don't support remote HTTP servers, use the bundled stdio proxy:

npx sats4ai-mcp

Or in your config:

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

Any MCP Client

The server URL is:

https://sats4ai.com/api/mcp

This is a remote HTTP server — no local process, no dependencies, no installation needed.

Available Tools

AI Generation

Tool Description Price
image Generate images from text prompts 100-200 sats
video Generate videos from text prompts 50 sats/unit
video_from_image Animate a still image into video 100 sats/sec
text Chat with AI language models (262K context) ~1 sat/100 chars
translate_text Translate text across 119 languages ~1 sat/1000 chars
music Generate songs with AI vocals 100 sats
3d Convert a photo to a 3D GLB model 350 sats

Audio & Speech

Tool Description Price
tts Text to speech (467 voices, 29 languages) 300 sats
transcription Speech to text (13 languages) 10 sats/min
voice_clone Clone a voice from an audio sample 7,500 sats
epub_to_audiobook Convert books (EPUB/PDF/TXT) to AI-narrated audiobooks 500+ sats

Image Processing

Tool Description Price
remove_background Remove background from any image (BiRefNet, SOTA) 5 sats
upscale_image Upscale images 2x/4x with Real-ESRGAN 5 sats
restore_face Restore blurry/damaged faces (CodeFormer) 5 sats
colorize_image Colorize B&W photos (DDColor, ICCV 2023) 5 sats
deblur_image Remove camera-shake blur (NAFNet, ECCV 2022) 20 sats
detect_nsfw Classify image safety (normal/suggestive/explicit) 2 sats
detect_objects Detect objects with bounding boxes (Grounding DINO) 5 sats
remove_object Remove objects by description — no mask needed 15 sats
image_edit Edit images with AI instructions Dynamic

Vision & Documents

Tool Description Price
vision Analyze and describe image content 21 sats
ocr Extract text from PDFs and images 10 sats/page
extract_receipt Receipt to structured JSON 50 sats
file_convert Convert between 200+ file formats 100 sats
pdf_merge Merge multiple PDFs into one 100 sats
convert_html_to_pdf HTML/Markdown to PDF 50 sats

Communication

Tool Description Price
email Send email to any address 200 sats
sms Send SMS worldwide Dynamic
call Place automated phone calls Dynamic
ai_call AI voice agent phone calls (async) Dynamic

Helper Tools

Tool Description
list_models Browse available AI models and pricing
get_model_pricing Get pricing for a specific model
create_payment Create a Lightning invoice for a service
check_payment_status Check if payment was received
check_job_status Poll async jobs (video, 3D, audiobook)
get_job_result Get completed job results
request_refund Request a refund for a failed service
vote_on_service Upvote or downvote a planned service
list_planned_services See upcoming services and vote

How It Works

  1. Agent calls list_models to discover available models and pricing
  2. Agent calls create_payment — gets a Lightning invoice
  3. Payment is made via the agent's Lightning wallet (e.g., lightning-wallet-mcp)
  4. Agent calls the tool (e.g., image, text) with the paymentId
  5. Result is returned — base64 image, text, URL, etc.

No API keys. No accounts. No rate limits tied to identity. Just Bitcoin and AI.

Error Handling & Refunds

When a paid tool fails after payment, the JSON-RPC error response includes refund information:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Image generation failed",
    "data": {
      "refund": {
        "charge_id": 12345,
        "refund_amount": 200,
        "lnurl_withdraw": "lnurl1dp68gurn8ghj7..."
      }
    }
  }
}

Claim the refund using any LNURL-compatible wallet or the claim_lnurl_withdraw tool from lightning-wallet.

Payment via Agent Wallets

Pair with a Lightning wallet MCP server so your agent can pay autonomously:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    },
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

The agent uses lightning-wallet to pay invoices from sats4ai, enabling fully autonomous AI tool usage.

L402 API

For direct HTTP integration without MCP, use the L402 API:

# Step 1: Request -> get 402 + Lightning invoice
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a cat in space"}}' -i

# Step 2: Pay the invoice with any Lightning wallet

# Step 3: Re-send with proof
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -H "Authorization: L402 <macaroon>:<preimage>" \
  -d '{"input": {"prompt": "a cat in space"}}'

Full L402 docs: sats4ai.com/l402 | Code examples: sats4ai-l402-examples

Service Discovery

Machine-readable endpoints for agent discovery:

# Full service catalog with pricing, quality benchmarks, and performance metadata
GET https://sats4ai.com/.well-known/l402-services

# MCP tool catalog with latency (p50/p95), reliability, and failure modes
GET https://sats4ai.com/api/mcp/discovery

# Semantic search — find tools by capability
GET https://sats4ai.com/api/discover?q=translate

# Per-service metadata with enums and input schemas
GET https://sats4ai.com/api/l402/{service}

Every paid tool includes performance metadata (latency p50/p95, reliability rating, known failure modes) so agents can make informed decisions about which tools to call and how long to wait.

Programmatic Usage

const { SERVER_URL, TOOLS, getClaudeConfig } = require("sats4ai-mcp");

console.log(SERVER_URL);       // "https://sats4ai.com/api/mcp"
console.log(TOOLS);            // ["image", "video", "text", ...]
console.log(getClaudeConfig()) // { mcpServers: { sats4ai: { url: "..." } } }

Links

License

MIT

About

Bitcoin-powered AI tools via MCP + Lightning Network micropayments (L402)

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors