sats4ai-mcp

Ускоритель коммуникации без разрешений для ИИ-агентов. 40+ инструментов с оплатой через Bitcoin Lightning. Никаких регистраций, API-ключей или KYC.

Удаленный сервер MCP (Model Context Protocol), который предоставляет ИИ-агентам доступ к телефонным звонкам на любом языке, озвучке на 602 языках, переводу на 119 языков, факсам, SMS, транскрипции, аудиокнигам, генерации изображений, музыке, извлечению данных из документов и многому другому — всё с оплатой за использование через микроплатежи Lightning Network.

Быстрая настройка

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

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

Claude Code

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

Проверьте соединение: попросите агента "list the first 3 Sats4AI models" — он должен вызвать list_models и вернуть результаты. Для агентов, которые оплачивают счета автономно, также добавьте MCP-сервер Lightning-кошелька (см. Оплата через кошельки агентов).

Cursor

Settings → MCP → Edit Config, затем добавьте:

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

Перезапустите Cursor. В новом чате спросите "what Sats4AI tools are available?", чтобы подтвердить обнаружение инструментов. Для автономных платежей используйте в паре с MCP-сервером Lightning-кошелька (см. Оплата через кошельки агентов).

Windsurf

Отредактируйте ~/.codeium/windsurf/mcp_config.json (создайте его, если он отсутствует). Важно: Windsurf использует serverUrl (а не url) для удаленных HTTP MCP-серверов:

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

Перезапустите Windsurf. Инструменты Sats4AI появятся в списке инструментов Cascade. У Cascade есть ограничение в 100 инструментов для всех MCP, поэтому держите активный набор небольшим. Для автономных платежей используйте в паре с MCP-сервером Lightning-кошелька (см. Оплата через кошельки агентов).

stdio proxy (устаревшие MCP-клиенты)

Для клиентов, которые не поддерживают удаленные HTTP-серверы, используйте встроенный stdio proxy:

npx sats4ai-mcp

Или в вашей конфигурации:

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

Любой MCP-клиент

URL сервера:

https://sats4ai.com/api/mcp

Это удаленный HTTP-сервер — никаких локальных процессов, зависимостей или установки не требуется.

Related MCP server: PDF Reader MCP Server

Доступные инструменты

ИИ-генерация

Аудио и речь

Обработка изображений

Зрение и документы

Коммуникация

Вспомогательные инструменты

Как это работает

1. Агент вызывает list_models для обнаружения доступных моделей и цен

2. Агент вызывает create_payment — получает Lightning-счет

3. Оплата производится через Lightning-кошелек агента (например, lightning-wallet-mcp)

4. Агент вызывает инструмент (например, image, text) с paymentId

5. Результат возвращается — base64 изображение, текст, URL и т.д.

Никаких API-ключей. Никаких аккаунтов. Никаких лимитов, привязанных к личности. Только Биткоин и ИИ.

Обработка ошибок и возвраты

Когда платный инструмент дает сбой после оплаты, JSON-RPC ответ об ошибке включает информацию о возврате:

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

Запросите возврат, используя любой LNURL-совместимый кошелек или инструмент claim_lnurl_withdraw из lightning-wallet.

Оплата через кошельки агентов

Используйте в паре с MCP-сервером Lightning-кошелька, чтобы ваш агент мог платить автономно:

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

Агент использует lightning-wallet для оплаты счетов от sats4ai, обеспечивая полностью автономное использование ИИ-инструментов.

L402 API

Для прямой HTTP-интеграции без MCP используйте 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"}}'

Полная документация L402: sats4ai.com/l402 | Примеры кода: sats4ai-l402-examples

Обнаружение сервисов

Машиночитаемые эндпоинты для обнаружения агентами:

# 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}

Каждый платный инструмент включает метаданные производительности (задержка p50/p95, рейтинг надежности, известные типы сбоев), чтобы агенты могли принимать обоснованные решения о том, какие инструменты вызывать и сколько ждать.

Программное использование

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

Безопасность

Нашли уязвимость? Не открывайте публичный issue. Напишите на sats4ai@gmail.com. См. SECURITY.md для ознакомления с политикой раскрытия информации и областью действия.

Ссылки

• Веб-сайт: sats4ai.com

• Документация MCP: sats4ai.com/mcp

• Документация L402 API: sats4ai.com/l402

• Примеры кода L402: github.com/cnghockey/sats4ai-l402-examples

• Обнаружение сервисов: sats4ai.com/.well-known/l402-services

• Семантический поиск: sats4ai.com/api/discover

• Политика безопасности: SECURITY.md

Лицензия

MIT