llms.txt Content
# Sats4AI
> The tools layer of the sovereign AI stack — the hands, eyes and ears no LLM has on its own. 40+ services — AI phone calls, voice synthesis in 602 languages, translation across 119, fax, SMS, transcription, audiobooks, image generation, music, document extraction, and more. Payment is the only credential — there isn't even a login endpoint. No signup, no API keys, no KYC. Pay per request over Bitcoin Lightning.
## 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, await_result, get_cost_estimate, get_error_codes, list_planned_services, confirm_ai_call. (vote_on_service costs 1 sat.)
## Available tools and pricing
> Prices below are INDICATIVE and BTC-pegged — they drift with the Bitcoin exchan
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Sats4AI","version":"0.3.0","description":"The tools layer of the sovereign AI stack — the hands, eyes and ears no LLM has on its own. 40+ services callable via L402 — AI phone calls, voice synthesis in 602 languages, translation across 119, fax, SMS, transcription, audiobooks, image generation, music, document extraction, and more. Payment is the only credential — there isn't even a login endpoint. No signup, no API keys, no KYC. Pay per request over Bit