sats4ai-mcp-server

# sats4ai-mcp

<a href="https://glama.ai/mcp/servers/@cnghockey/sats4ai">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@cnghockey/sats4ai/badge" />
</a>

**The permissionless communication supercharger for AI agents. 40+ tools paid with Bitcoin Lightning. No signup, no API keys, no KYC.**

A remote [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that gives AI agents access to AI phone calls in any language, voice in 602 languages, translation across 119, fax, SMS, transcription, audiobooks, image generation, music, document extraction, and more — all paid per-use with Lightning Network micropayments.

## Quick Setup

### Claude Desktop

Add to your `claude_desktop_config.json` (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}
```

### Claude Code

```bash
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 call `list_models` and return results. For agents that pay invoices autonomously, also add a Lightning wallet MCP (see [Payment via Agent Wallets](#payment-via-agent-wallets)).

### Cursor

Settings → MCP → Edit Config, then add:

```json
{
  "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 (see [Payment via Agent Wallets](#payment-via-agent-wallets)).

### Windsurf

Edit `~/.codeium/windsurf/mcp_config.json` (create it if missing). **Important**: Windsurf uses `serverUrl` (not `url`) for remote HTTP MCP servers:

```json
{
  "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 (see [Payment via Agent Wallets](#payment-via-agent-wallets)).

### stdio proxy (legacy MCP clients)

For clients that don't support remote HTTP servers, use the bundled stdio proxy:

```bash
npx sats4ai-mcp
```

Or in your config:

```json
{
  "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.

## What Can It Do?

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 poll `check_job_status` until 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."*

## Available Tools

### AI Generation
| Tool | Description | Price |
|------|-------------|-------|
| `image` | Generate images from text prompts | 100-200 sats |
| `video` | Generate videos from text prompts | ~250-400 sats/sec by resolution (768p 250 / 2K 400) |
| `video_from_image` | Animate a still image into video | ~250-400 sats/sec by resolution (768p 250 / 2K 400) |
| `text` | Chat with AI language models (Kimi K3, 1M context, vision) | ~1 sat/10 chars (best) · ~1 sat/1000 (standard) |
| `translate_text` | Translate text across 119 languages | from 1 sat/1000 chars |
| `translate_rare_language` | Translate into **452 languages frontier models don't serve** — Bhojpuri, Maithili, Magahi, Manipuri, Quechua, Shan… each with a measured quality score | from 50 sats |
| `music` | Generate songs with AI vocals, or an instrumental (structure tags, no words) | 5 sats/sec, 15-300s (75-1,500 sats) · written lyrics +25 |
| `3d` | Convert a photo to a 3D GLB model | 1,600 sats |

> **Translation price varies by language.** The target language picks the engine, so a language
> served by a stronger model costs more than the standard 1 sat/1000 characters. `GET /api/languages`
> returns the exact price, the model and its measured chrF score for every language, and the 402
> challenge always quotes the real amount before you pay.


### Audio & Speech
| Tool | Description | Price |
|------|-------------|-------|
| `tts` | Text to speech (3 tiers, 602+ languages) | per-char, from 1 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 AI-narrated audiobooks | 500+ sats |
| `translate_epub` | Translate a whole EPUB into another language — EPUB in, EPUB out, markup intact (async; `create_payment` needs `characterCount` + `targetLanguage`) | per character on the target language's engine rate, min 50 sats |

### Image Processing
| Tool | Description | Price |
|------|-------------|-------|
| `remove_background` | Remove background from any image (BiRefNet, SOTA) | 44 sats |
| `upscale_image` | Upscale images 2x/4x with Real-ESRGAN | 5 sats |
| `restore_face` | Restore blurry/damaged faces (CodeFormer) | 25 sats |
| `colorize_image` | Colorize B&W photos (DDColor, ICCV 2023) | 5 sats |
| `deblur_image` | Remove camera-shake blur (NAFNet, ECCV 2022) | 110 sats |
| `render_card` | Typographic title card (PNG/JPEG) — deterministic layout, the text you send is the text that appears | 5 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 | 130 sats |
| `image_edit` | Edit images with AI instructions | Dynamic (varies by model) — check `get_model_pricing` |

### 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 | 25 sats/page |
| `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 |
| `e_signature` | Sign a PDF with a typed or drawn signature | 1,000 sats |
| `boardingpass_wallet` | Airline boarding pass (PDF/screenshot) to a Google Wallet pass | 100 sats/pass |

### Communication
| Tool | Description | Price |
|------|-------------|-------|
| `send_email` | Send email to any address | 200 sats |
| `send_sms` | Send SMS worldwide | Dynamic (varies by destination) — `create_payment` returns the exact quote |
| `place_call` | Place automated phone calls | Dynamic (varies by destination) — `create_payment` returns the exact quote |
| `ai_call` | Send an AI voice agent to make a two-way call | Varies by destination and duration — `create_payment` returns the exact quote |
| `open_voice_bridge` | Open a phone call that YOUR agent drives, one turn at a time. We dial and transcribe. Your agent replies. Turn-based, not real-time: about 2 seconds of ours pass between the callee's last word and the start of your reply, plus your model's thinking time | A deposit, priced by destination — `create_payment` returns the exact quote |
| `voice_bridge_say` | Speak into the open call: text (602 languages) or your own audio. Keep each reply to one or two sentences (700 speech units at most). The callee cannot interrupt | Included in the deposit |
| `poll_voice_bridge` | Read what the callee said. Pass `waitMs` (up to 25000) to get the transcript as soon as they finish talking | Included in the deposit |
| `end_voice_bridge` | Hang up. Returns the final transcript and a refund link for the unused deposit time | Included in the deposit |
| `send_fax` | Send a fax worldwide (PDF URL or typed text) | 500 sats (≤10 pages), +50 sats/page after |
| `receive_fax` | Open a 24h window to receive a fax, delivered to email | 500 sats (+200 OCR add-on) |

### 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. With a cart id, it shows the state of each item |
| `create_cart` | Pay for 2 to 10 calls with ONE invoice (up to 2,000 sats in all). Each item then works as a normal payment. An item you do not use is refunded for its own price after about an hour |
| `check_job_status` | Poll async jobs (video, 3D, audiobook, EPUB translation) |
| `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

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](https://www.npmjs.com/package/lightning-wallet-mcp))
4. **Agent calls the tool** (e.g., `image`, `text`) with the `payme