sats4ai-mcp

Über 30 KI-Tools, bezahlt mit Bitcoin Lightning. Keine Registrierung, keine API-Schlüssel, kein KYC.

Ein Remote-MCP (Model Context Protocol)-Server, der KI-Agenten Zugriff auf Bildgenerierung, Videoerstellung, Textgenerierung, Sprache, Übersetzung, Bildverarbeitung, OCR, Hörbuchkonvertierung, E-Mail, SMS, Voice-Cloning 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

Cursor

Fügen Sie dies zu Ihren MCP-Einstellungen hinzu:

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

stdio-Proxy (Legacy MCP-Clients)

Für Clients, die keine Remote-HTTP-Server unterstützen, verwenden Sie den gebündelten 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 Remote-HTTP-Server — kein lokaler Prozess, keine Abhängigkeiten, keine Installation erforderlich.

Verfügbare Tools

KI-Generierung

Audio & Sprache

Bildverarbeitung

Vision & Dokumente

Kommunikation

Hilfsprogramme

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 die 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 usw.

Keine API-Schlüssel. Keine Konten. Keine Ratenbegrenzungen, die an eine Identität gebunden sind. Nur Bitcoin und KI.

Fehlerbehandlung & Rückerstattungen

Wenn ein kostenpflichtiges 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 einer beliebigen LNURL-kompatiblen Wallet oder dem Tool claim_lnurl_withdraw aus lightning-wallet an.

Zahlung via Agent-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-Erkennung:

# 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 kostenpflichtige Tool enthält Leistungsmetadaten (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: "..." } } }

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

Lizenz

MIT