llms.txt Content
# Sats4AI
> Bitcoin-powered AI tools. 40+ services — image, video, text, speech (602+ languages), transcription, translation, OCR, communication, file conversion. Pay per request with Lightning Network. No signup, no API keys, no KYC.
## How to connect
MCP server endpoint: https://sats4ai.com/api/mcp
### Option 1: MCP client (recommended for agents)
Add to your MCP settings JSON:
{
"mcpServers": {
"sats4ai": {
"url": "https://sats4ai.com/api/mcp"
}
}
}
Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.
The server handles tool discovery, schema, and invocation via JSON-RPC over HTTP.
### Option 2: L402 HTTP API (for direct HTTP callers)
GET https://sats4ai.com/api/l402/{service} — returns schema + 402 with Lightning invoice
POST https://sats4ai.com/api/l402/{service} — pay invoice, include Authorization: L402 {macaroon}:{preimage}
No MCP needed. Any HTTP client works. Full docs: https://sats4ai.com/docs
### Option 3: npm package (for Node.js / stdio transport)
npm install sats4ai-mcp
npx sats4ai-mcp
Runs locally, communicates via stdio. Same tools, same payment flow.
## How payments work
Every paid tool requires a Lightning Network micropayment. The flow:
1. Call create_payment(toolName="generate_image") → returns { paymentId, invoice, amountSats }
2. Pay the Lightning invoice (BOLT11)
3. Call generate_image(paymentId="...", prompt="...") → returns result
Free tools (no payment): list_models, get_model_pricing, check_payment_status, check_job_status, get_job_result, get_cost_estimate, get_error_codes, list_planned_services, vote_on_service, confirm_ai_call.
## Available tools and pricing
### Instant tools (result returned immediately)
- generate_image: Text to image. 100-200 sats.
- edit_image: Edit images with natural language. 200-450 sats.
- generate_text: Frontier LLMs. Per-character pricing (100-1000 chars/sat).
- translate_text: 119 languages. 1 sat per 1000 chars.
- generate_music: