sats4ai-mcp

Der erlaubnisfreie Kommunikations-Supercharger für KI-Agenten. Über 40 Tools, bezahlt mit Bitcoin Lightning. Keine Registrierung, keine API-Schlüssel, kein KYC.

Ein entfernter MCP (Model Context Protocol)-Server, der KI-Agenten Zugriff auf KI-Telefonanrufe in jeder Sprache, Sprachausgabe in 602 Sprachen, Übersetzung in 119 Sprachen, Fax, SMS, Transkription, Hörbücher, Bildgenerierung, Musik, Dokumentenextraktion und mehr bietet — alles pro Nutzung bezahlt mit Lightning Network-Mikrozahlungen.

Schnelleinrichtung

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Claude Code

claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp

Überprüfen Sie die Verbindung: Fragen Sie den Agenten "list the first 3 Sats4AI models" — er sollte list_models aufrufen und Ergebnisse zurückgeben. Für Agenten, die Rechnungen autonom bezahlen, fügen Sie zusätzlich ein Lightning-Wallet-MCP hinzu (siehe Zahlung via Agenten-Wallets).

Cursor

Einstellungen → MCP → Konfiguration bearbeiten, dann hinzufügen:

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

Starten Sie Cursor neu. Fragen Sie in einem neuen Chat "what Sats4AI tools are available?", um die Tool-Erkennung zu bestätigen. Für autonome Zahlungen koppeln Sie dies mit einem Lightning-Wallet-MCP (siehe Zahlung via Agenten-Wallets).

Windsurf

Bearbeiten Sie ~/.codeium/windsurf/mcp_config.json (erstellen Sie die Datei, falls sie fehlt). Wichtig: Windsurf verwendet serverUrl (nicht url) für entfernte HTTP-MCP-Server:

{
  "mcpServers": {
    "sats4ai": {
      "serverUrl": "https://sats4ai.com/api/mcp"
    }
  }
}

Starten Sie Windsurf neu. Sats4AI-Tools erscheinen in der Cascade-Tool-Liste. Cascade hat ein Limit von 100 Tools über alle MCPs hinweg, halten Sie das aktive Set also klein. Für autonome Zahlungen koppeln Sie dies mit einem Lightning-Wallet-MCP (siehe Zahlung via Agenten-Wallets).

stdio-Proxy (Legacy-MCP-Clients)

Für Clients, die keine entfernten HTTP-Server unterstützen, verwenden Sie den mitgelieferten stdio-Proxy:

npx sats4ai-mcp

Oder in Ihrer Konfiguration:

{
  "mcpServers": {
    "sats4ai": {
      "command": "npx",
      "args": ["sats4ai-mcp"]
    }
  }
}

Jeder MCP-Client

Die Server-URL lautet:

https://sats4ai.com/api/mcp

Dies ist ein entfernter HTTP-Server — kein lokaler Prozess, keine Abhängigkeiten, keine Installation erforderlich.

Related MCP server: PDF Reader MCP Server

Verfügbare Tools

KI-Generierung

Audio & Sprache

Bildverarbeitung

Vision & Dokumente

Kommunikation

Hilfs-Tools

Funktionsweise

1. Agent ruft list_models auf, um verfügbare Modelle und Preise zu entdecken

2. Agent ruft create_payment auf — erhält eine Lightning-Rechnung

3. Zahlung erfolgt über das Lightning-Wallet des Agenten (z. B. lightning-wallet-mcp)

4. Agent ruft das Tool auf (z. B. image, text) mit der paymentId

5. Ergebnis wird zurückgegeben — Base64-Bild, Text, URL, etc.

Keine API-Schlüssel. Keine Konten. Keine an Identität gebundenen Ratenbegrenzungen. Nur Bitcoin und KI.

Fehlerbehandlung & Rückerstattungen

Wenn ein bezahltes Tool nach der Zahlung fehlschlägt, enthält die JSON-RPC-Fehlerantwort Informationen zur Rückerstattung:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Image generation failed",
    "data": {
      "refund": {
        "charge_id": 12345,
        "refund_amount": 200,
        "lnurl_withdraw": "lnurl1dp68gurn8ghj7..."
      }
    }
  }
}

Fordern Sie die Rückerstattung mit einem LNURL-kompatiblen Wallet oder dem claim_lnurl_withdraw-Tool von lightning-wallet an.

Zahlung via Agenten-Wallets

Koppeln Sie dies mit einem Lightning-Wallet-MCP-Server, damit Ihr Agent autonom bezahlen kann:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    },
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

Der Agent verwendet lightning-wallet, um Rechnungen von sats4ai zu bezahlen, was eine vollkommen autonome Nutzung von KI-Tools ermöglicht.

L402-API

Für eine direkte HTTP-Integration ohne MCP verwenden Sie die 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"}}'

Vollständige L402-Dokumentation: sats4ai.com/l402 | Code-Beispiele: sats4ai-l402-examples

Service-Discovery

Maschinenlesbare Endpunkte für die Agenten-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}

Jedes bezahlte Tool enthält Leistungs-Metadaten (Latenz p50/p95, Zuverlässigkeitsbewertung, bekannte Fehlermodi), damit Agenten fundierte Entscheidungen darüber treffen können, welche Tools sie aufrufen und wie lange sie warten sollen.

Programmatische Nutzung

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: "..." } } }

Sicherheit

Eine Schwachstelle gefunden? Öffnen Sie kein öffentliches Issue. Senden Sie eine E-Mail an sats4ai@gmail.com. Siehe SECURITY.md für die vollständige Offenlegungsrichtlinie und den Geltungsbereich.

Links

• Website: sats4ai.com

• MCP-Dokumentation: sats4ai.com/mcp

• L402-API-Dokumentation: sats4ai.com/l402

• L402-Code-Beispiele: github.com/cnghockey/sats4ai-l402-examples

• Service-Discovery: sats4ai.com/.well-known/l402-services

• Semantische Suche: sats4ai.com/api/discover

• Sicherheitsrichtlinie: SECURITY.md

Lizenz

MIT