sats4ai
About
Bitcoin-powered tools marketplace. Image, text, video, music, speech, 3D, file conversion, SMS — all via Lightning micropayments. No signup required.
Details
- Author
- cnghockey
- Categories
- Other, Media
Jump to
Setup
Install sats4ai in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/cnghockey/sats4ai-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
The permissionless communication supercharger for AI agents. 40+ tools paid with Bitcoin Lightning. No signup, no API keys, no KYC.
Add to yourclaude_desktop_config.json(~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS,%APPDATA%\Claude\claude_desktop_config.jsonon Windows):
{ "mcpServers": { "sats4ai": { "url": "https://sats4ai.com/api/mcp" } } }
claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp
Verify the connection: ask the agent"list the first 3 Sats4AI models"— it should calllist_modelsand return results. For agents that pay invoices autonomously, also add a Lightning wallet MCP (seePayment via Agent Wallets).
{ "mcpServers": { "sats4ai": { "url": "https://sats4ai.com/api/mcp" } } }
Restart Cursor. In a new chat, ask"what Sats4AI tools are available?"to confirm tool discovery. For autonomous payments, pair with a Lightning wallet MCP (seePayment via Agent Wallets).
Edit~/.codeium/windsurf/mcp_config.json(create it if missing).Important: Windsurf usesserverUrl(noturl) for remote HTTP MCP servers:
{ "mcpServers": { "sats4ai": { "serverUrl": "https://sats4ai.com/api/mcp" } } }
Restart Windsurf. Sats4AI tools appear in the Cascade tool list. Cascade has a 100-tool cap across all MCPs, so keep the active set lean. For autonomous payments, pair with a Lightning wallet MCP (seePayment via Agent Wallets).
For clients that don't support remote HTTP servers, use the bundled stdio proxy:
{ "mcpServers": { "sats4ai": { "command": "npx", "args": ["sats4ai-mcp"] } } }
This is a remote HTTP server — no local process, no dependencies, no installation needed.
Once connected, just ask your agent. These prompts exercise the full flow — discover, pay the Lightning invoice, get the result:
- "Translate this paragraph to Spanish with Sats4AI — create the payment, pay the invoice with my lightning wallet, then run the translation."
- "Check what an SMS to +33612345678 costs, then send it: 'Your appointment is confirmed for 3pm tomorrow.'"
- "Generate an image of a lighthouse in a thunderstorm — pay the invoice and show me the result."
- "Send an AI voice agent to call +14155551234 and reschedule my dentist appointment, then give me the transcript."
- "Turn this EPUB into an audiobook — create the payment, then pollcheck_job_statusuntil it's done."
- "Remove the background from this image."
- "Transcribe this audio file, then translate the transcript to English."
- "Get a quote for faxing this 3-page PDF to +4930123456, then send it."
- Agent callslist_modelsto discover available models and pricing
- Agent callscreate_payment— gets a Lightning invoice
- Payment is madevia the agent's Lightning wallet (e.g.,lightning-wallet-mcp)
- Agent calls the tool(e.g.,image,text) with thepaymentId
- Result is returned— base64 image, text, URL, etc.
No API keys. No accounts. No rate limits tied to identity. Just Bitcoin and AI.
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 theclaim_lnurl_withdrawtool fromlightning-wallet.
Errors also carry anerror_codeplus a recoverysuggestioninerror.data. Payment-lifecycle codes:PAYMENT_NOT_FOUND(wrong paymentId),PAYMENT_PENDING(invoice not paid yet),PAYMENT_ALREADY_USED(each payment covers one call). Full catalog:GET https://sats4ai.com/api/error-codes.
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 useslightning-walletto pay invoices fromsats4ai, enabling fully autonomous AI tool usage.
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"}}'
Or skip the manual steps entirely: our L402 endpoints speak the standard L402 protocol, solnget— Lightning Labs' own L402 client — pays them automatically. Point it at your Lightning node and call the endpoint:
lnget -X POST -d '{"text": "Hello", "targetLanguage": "Spanish"}' \ --content-type application/json --max-cost 50 \ https://sats4ai.com/api/l402/translate-text # Fetches the 402, pays the invoice, retries, prints the result.
Full L402 docs:sats4ai.com/l402| Code examples:sats4ai-l402-examples
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 includesperformance 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.
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: "..." } } }
Found a vulnerability?Do not open a public issue.Emailsats4ai@gmail.com. SeeSECURITY.mdfor full disclosure policy and scope.
- Website:sats4ai.com
- MCP Docs:sats4ai.com/mcp
- L402 API Docs:sats4ai.com/l402
- L402 Code Examples:github.com/cnghockey/sats4ai-l402-examples
- Service Discovery:sats4ai.com/.well-known/l402-services
- Semantic Search:sats4ai.com/api/discover
- Security Policy:SECURITY.md
An MCP server that lets AI agents discover, hire, and pay other AI agents — the exchange where agents are the customer.
AI agent API marketplace-discover, call, and pay for services with USDC payments. List your own AI services and earn money per call.
Marketplace for AI agents: buy goods and services under spending caps, with returns and disputes.
Open marketplace for AI services — LLMs, image/video generation, web scraping, model hosting, data extraction, and more. Agents pay per use with USDC micropayments on Polygon.
A Python package for media processing using FFmpeg and FastMCP.
Batch audio processing and optimization using FFmpeg. Modify sample rate, bitrate, volume, channels, and apply effects.
A server for media processing, offering powerful video and image manipulation using FFmpeg and ImageMagick.
A powerful video editing server using ffmpeg-python to process external video files.
AI agent commerce marketplace — register, list services, buy and sell capabilities with real payments via Stripe.
Enable AI agents to discover, launch tokens, pay for, and sell APIs and resources using x402
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
