How do I install the cnghockey/sats4ai-mcp-server MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "sats4ai-mcp-server": { "command": "npx", "args": ["-y", "cnghockey/sats4ai-mcp-server"] } }

What does cnghockey/sats4ai-mcp-server do?

[](https://glama.ai/mcp/servers/@cnghockey/sats4ai) 📇 ☁️ - Permissionless communication supercharger for AI agents — phone calls, SMS, fax, translation (119 languages), text-to-speech, audiobook generation, plus image/video/music/text generation and document extraction. Pay per request via Lightning (L402) — no signup or API keys.

sats4ai-mcp

33+ 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 with 3 tiers: OmniVoice Global (602+ langs), Inworld Premium (#1 ranked TTS ELO 1217), Minimax Studio (voice cloning)	10-100 chars/sat
`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 full audiobooks with chapter markers, optional translation. Same 3 TTS tiers.	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

Agent calls list_models to discover available models and pricing
Agent calls create_payment — gets a Lightning invoice
Payment is made via the agent's Lightning wallet (e.g., lightning-wallet-mcp)
Agent calls the tool (e.g., image, text) with the paymentId
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 an error_code and refund information:

{
  "jsonrpc": "2.0",
  "id": 3,
  "error": {
    "code": -32603,
    "message": "Image generation timed out",
    "data": {
      "error_code": "TIMEOUT",
      "refund": {
        "charge_id": 12345,
        "refund_amount": 200,
        "lnurl_withdraw": "lnurl1dp68gurn8ghj7...",
        "status": "pending"
      }
    }
  }
}

Error Codes

Code	Meaning	Action
`TIMEOUT`	Service timed out	Retry later or try different model
`CONTENT_FILTERED`	Safety filter triggered	Rephrase prompt
`RATE_LIMITED`	Too many requests	Wait and retry
`INVALID_INPUT`	Bad parameters	Fix request parameters
`SERVICE_ERROR`	Service failure	Try different model

Refund Fields

Field	Description
`charge_id`	The original payment charge ID
`refund_amount`	Amount in sats being refunded
`lnurl_withdraw`	LNURL-withdraw string to claim the refund
`status`	Refund status (e.g., `pending`, `claimed`)

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: "..." } } }

License

MIT

cnghockey/sats4ai-mcp-server

Quick Install

Documentation Overview