Log inSubmit server
Sats4ai MCP Server logo

Sats4ai MCP Server

by cnghockey

Remote MCP access to 40+ pay-per-use AI, communication, media, document, and translation tools through Bitcoin Lightning.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Sats4ai MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cnghockey-sats4ai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sats4ai-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

cnghockey/sats4ai-mcp-server connects MCP clients to the Sats4AI remote HTTP API for pay-per-use AI and communication services. It covers phone calls, SMS, email, fax, translation, speech, media generation, vision, document processing, and file conversion, with Lightning invoices used to authorize individual operations. Most paid operations follow a discover, invoice, payment-status, and tool-call flow; asynchronous jobs can be monitored and retrieved separately. Reach for it when an agent needs external communication or multimodal processing without service-specific API keys or account setup.

Use cases

  • Send an SMS, email, fax, or automated phone call
  • Translate text, audio, or an EPUB into another language
  • Generate and edit images, video, music, speech, or 3D models
  • Extract text and structured data from documents and receipts
  • Convert, merge, render, or electronically sign files

Key features

  • Pay-per-request Lightning invoices
  • Communication tools for email, SMS, fax, and phone calls
  • 119-language translation and 452-language rare-language translation
  • Multimodal generation and analysis
  • Asynchronous job polling and result retrieval
  • Document extraction and file conversion

Tools57

What Sats4ai MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~33.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 72d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · sats4ai-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed57Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Sats4ai MCP Server works

What cnghockey/sats4ai-mcp-server does

cnghockey/sats4ai-mcp-server exposes the Sats4AI service through MCP. Its tool set spans communication, language, audio, images, video, music, 3D assets, documents, and file handling. Communication features include email, SMS, fax, automated calls, AI voice calls, and a turn-based voice bridge. Other tools can translate text or EPUB files, transcribe and translate audio, synthesize speech, clone an authorized voice, or create audiobooks.

The service also supports image generation and editing, image analysis, document OCR, receipt extraction, PDF operations, HTML-to-PDF conversion, e-signatures, boarding-pass wallet passes, format conversion, and deterministic typographic cards. Language tools cover 119 languages for mainstream translation and a separate rare-language path covering 452 languages with published quality tiers.

How it works

The production endpoint is a remote HTTP MCP server at https://sats4ai.com/api/mcp, so clients that support remote MCP connections do not need a local process or dependency installation. A legacy stdio proxy can be launched with npx sats4ai-mcp.

Paid operations use Bitcoin Lightning rather than API keys or signup. First use list_models when model selection or pricing matters, then call create_payment for exactly one operation. The response contains a BOLT11 invoice and payment details. After payment, check_payment_status confirms that the invoice is ready for use before the target tool is called. Pricing inputs such as text length, duration, resolution, destination, page count, or character count must match the eventual request where required.

Asynchronous tools return a request ID. Use check_job_status followed by get_job_result, or use await_result to combine waiting and retrieval. Result URLs are temporary and should be downloaded promptly.

Setup and configuration

For Claude Desktop, Cursor, and remote MCP clients, add the endpoint as the server URL. Claude Code can add it with an HTTP transport command. Windsurf uses serverUrl in its MCP configuration rather than url. A compatible Lightning wallet MCP can be paired with the server when the agent is expected to pay invoices autonomously.

The stdio fallback uses:

Terminal
npx sats4ai-mcp

No local environment variables are required for the remote configuration described above.

Tools and capabilities

  • Generate text, images, video, music, 3D GLB models, speech, and audiobooks.
  • Translate text, audio, and EPUB files, including rare-language translation paths.
  • Transcribe audio with word or segment timestamps and extract structured document data.
  • Send email, SMS, fax, and phone calls, including AI-driven or agent-driven voice calls.
  • Convert, merge, render, and sign documents, and create Google Wallet boarding passes.
  • Poll asynchronous jobs or wait for their final results through a single helper tool.

Limitations and notes

Each Lightning payment authorizes one paid tool call, and invoices expire after 10 minutes. Some operations require a payment-time quote based on the exact request parameters. Video, transcription, audiobook, EPUB translation, and voice operations may be asynchronous. Temporary output links expire, commonly after about one hour, while some services use different periods. Voice cloning requires consent and an eligible single-speaker audio sample. Audio transcription files and transcripts are processed ephemerally and discarded.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Sats4ai MCP Server

cnghockey/sats4ai-mcp-server is an MCP server that connects AI clients to the Sats4AI remote API and Bitcoin Lightning payments. Its main tools cover phone calls, SMS, email, fax, translation, speech, image and video generation, transcription, document extraction, file conversion, and asynchronous job handling without API keys or signup.

Use the remote MCP endpoint `https://sats4ai.com/api/mcp` in a client that supports remote HTTP MCP servers. No local installation is needed. For legacy clients, run `npx sats4ai-mcp` as a stdio proxy and register that command in the client's MCP configuration.

Payment uses Bitcoin Lightning invoices created by `create_payment`. Create one invoice for each paid operation, pay it, and call `check_payment_status` before invoking the target tool. Invoices expire after 10 minutes, and quote inputs such as duration or character count must match the operation.

Yes. Add `https://sats4ai.com/api/mcp` under Cursor's MCP settings, restart Cursor, and confirm tool discovery in a new chat. An additional Lightning wallet MCP can be paired with it when the agent needs to pay invoices autonomously.

Call `check_job_status` with the request ID, then call `get_job_result` after the status becomes `COMPLETED`. Alternatively, use `await_result` to wait and retrieve the output in one flow. Temporary result URLs should be downloaded before they expire.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSats4ai MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cnghockey-sats4ai-mcp-server?style=directory)](https://allmcps.com/mcp/cnghockey-sats4ai-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/cnghockey-sats4ai-mcp-server"><img src="https://allmcps.com/api/badge/cnghockey-sats4ai-mcp-server?style=directory" alt="Sats4ai MCP Server on AllMCPs" /></a>