sats4ai

Bitcoin-powered tools marketplace. Image, text, video, music, speech, 3D, file conversion, SMS — all via Lightning micropayments. No signup required.

GitHub

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

ToolDescriptionPrice
imageGenerate images from text prompts100-200 sats
videoGenerate videos from text prompts50 sats/unit
video_from_imageAnimate a still image into video100 sats/sec
textChat with AI language models (262K context)~1 sat/100 chars
translate_textTranslate text across 119 languages~1 sat/1000 chars
musicGenerate songs with AI vocals100 sats
3dConvert a photo to a 3D GLB model350 sats

Audio & Speech

ToolDescriptionPrice
ttsText-to-speech with 3 tiers: OmniVoice Global (602+ langs), Inworld Premium (#1 ranked TTS ELO 1217), Minimax Studio (voice cloning)10-100 chars/sat
transcriptionSpeech to text (13 languages)10 sats/min
voice_cloneClone a voice from an audio sample7,500 sats
epub_to_audiobookConvert books (EPUB/PDF/TXT) to full audiobooks with chapter markers, optional translation. Same 3 TTS tiers.500+ sats

Image Processing

ToolDescriptionPrice
remove_backgroundRemove background from any image (BiRefNet, SOTA)5 sats
upscale_imageUpscale images 2x/4x with Real-ESRGAN5 sats
restore_faceRestore blurry/damaged faces (CodeFormer)5 sats
colorize_imageColorize B&W photos (DDColor, ICCV 2023)5 sats
deblur_imageRemove camera-shake blur (NAFNet, ECCV 2022)20 sats
detect_nsfwClassify image safety (normal/suggestive/explicit)2 sats
detect_objectsDetect objects with bounding boxes (Grounding DINO)5 sats
remove_objectRemove objects by description — no mask needed15 sats
image_editEdit images with AI instructionsDynamic

Vision & Documents

ToolDescriptionPrice
visionAnalyze and describe image content21 sats
ocrExtract text from PDFs and images10 sats/page
extract_receiptReceipt to structured JSON50 sats
file_convertConvert between 200+ file formats100 sats
pdf_mergeMerge multiple PDFs into one100 sats
convert_html_to_pdfHTML/Markdown to PDF50 sats

Communication

ToolDescriptionPrice
emailSend email to any address200 sats
smsSend SMS worldwideDynamic
callPlace automated phone callsDynamic
ai_callAI voice agent phone calls (async)Dynamic

Helper Tools

ToolDescription
list_modelsBrowse available AI models and pricing
get_model_pricingGet pricing for a specific model
create_paymentCreate a Lightning invoice for a service
check_payment_statusCheck if payment was received
check_job_statusPoll async jobs (video, 3D, audiobook)
get_job_resultGet completed job results
request_refundRequest a refund for a failed service
vote_on_serviceUpvote or downvote a planned service
list_planned_servicesSee 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 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

CodeMeaningAction
TIMEOUTService timed outRetry later or try different model
CONTENT_FILTEREDSafety filter triggeredRephrase prompt
RATE_LIMITEDToo many requestsWait and retry
INVALID_INPUTBad parametersFix request parameters
SERVICE_ERRORService failureTry different model

Refund Fields

FieldDescription
charge_idThe original payment charge ID
refund_amountAmount in sats being refunded
lnurl_withdrawLNURL-withdraw string to claim the refund
statusRefund 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: "..." } } }

Links

License

MIT

Serveurs connexes