sats4ai-mcp

AI 에이전트를 위한 허가 없는 통신 슈퍼차저. 비트코인 라이트닝으로 결제하는 40개 이상의 도구. 회원가입, API 키, KYC가 필요 없습니다.

AI 에이전트가 모든 언어의 AI 전화 통화, 602개 언어의 음성, 119개 언어 번역, 팩스, SMS, 전사, 오디오북, 이미지 생성, 음악, 문서 추출 등을 이용할 수 있게 해주는 원격 MCP (Model Context Protocol) 서버입니다. 모든 서비스는 라이트닝 네트워크 소액 결제를 통해 사용량만큼 지불됩니다.

빠른 설정

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도 추가하세요(에이전트 지갑을 통한 결제 참조).

Cursor

Settings → MCP → Edit Config로 이동한 후 다음을 추가하세요:

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

Cursor를 재시작하세요. 새로운 채팅에서 *"what Sats4AI tools are available?"*라고 물어 도구 검색을 확인하세요. 자율 결제를 위해서는 라이트닝 지갑 MCP와 페어링하세요(에이전트 지갑을 통한 결제 참조).

Windsurf

~/.codeium/windsurf/mcp_config.json을 편집하세요(없으면 생성). 중요: Windsurf는 원격 HTTP MCP 서버에 대해 url이 아닌 serverUrl을 사용합니다:

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

Windsurf를 재시작하세요. Sats4AI 도구가 Cascade 도구 목록에 나타납니다. Cascade는 모든 MCP를 통틀어 100개의 도구 제한이 있으므로 활성 세트를 간소하게 유지하세요. 자율 결제를 위해서는 라이트닝 지갑 MCP와 페어링하세요(에이전트 지갑을 통한 결제 참조).

stdio proxy (레거시 MCP 클라이언트)

원격 HTTP 서버를 지원하지 않는 클라이언트의 경우, 번들로 제공되는 stdio 프록시를 사용하세요:

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

사용 가능한 도구

AI 생성

도구	설명	가격
`image`	텍스트 프롬프트로 이미지 생성	100-200 sats
`video`	텍스트 프롬프트로 비디오 생성	50 sats/unit
`video_from_image`	정지 이미지를 비디오로 애니메이션화	100 sats/sec
`text`	AI 언어 모델과 채팅 (262K 컨텍스트)	~1 sat/100 chars
`translate_text`	119개 언어 텍스트 번역	~1 sat/1000 chars
`music`	AI 보컬이 포함된 노래 생성	100 sats
`3d`	사진을 3D GLB 모델로 변환	350 sats

오디오 및 음성

도구	설명	가격
`tts`	텍스트 음성 변환 (467개 음성, 29개 언어)	300 sats
`transcription`	음성 텍스트 변환 (13개 언어)	10 sats/min
`voice_clone`	오디오 샘플에서 음성 복제	7,500 sats
`epub_to_audiobook`	책(EPUB/PDF/TXT)을 AI 내레이션 오디오북으로 변환	500+ sats

이미지 처리

도구	설명	가격
`remove_background`	이미지 배경 제거 (BiRefNet, SOTA)	5 sats
`upscale_image`	Real-ESRGAN으로 이미지 2배/4배 확대	5 sats
`restore_face`	흐릿하거나 손상된 얼굴 복원 (CodeFormer)	5 sats
`colorize_image`	흑백 사진 컬러화 (DDColor, ICCV 2023)	5 sats
`deblur_image`	카메라 흔들림 제거 (NAFNet, ECCV 2022)	20 sats
`detect_nsfw`	이미지 안전성 분류 (정상/선정적/부적절)	2 sats
`detect_objects`	경계 상자로 객체 감지 (Grounding DINO)	5 sats
`remove_object`	설명으로 객체 제거 — 마스크 불필요	15 sats
`image_edit`	AI 지시사항으로 이미지 편집	동적

비전 및 문서

도구	설명	가격
`vision`	이미지 콘텐츠 분석 및 설명	21 sats
`ocr`	PDF 및 이미지에서 텍스트 추출	10 sats/page
`extract_receipt`	영수증을 구조화된 JSON으로 변환	50 sats
`file_convert`	200개 이상의 파일 형식 간 변환	100 sats
`pdf_merge`	여러 PDF를 하나로 병합	100 sats
`convert_html_to_pdf`	HTML/Markdown을 PDF로 변환	50 sats

통신

도구	설명	가격
`send_email`	모든 주소로 이메일 전송	200 sats
`send_sms`	전 세계 SMS 전송	동적
`place_call`	자동 전화 걸기	동적
`ai_call`	AI 음성 에이전트를 통한 양방향 통화	동적 (~150-250 sats/call)
`send_fax`	전 세계 팩스 전송 (PDF URL 또는 텍스트)	500 sats (10페이지 이하), 이후 페이지당 +50 sats
`receive_fax`	24시간 팩스 수신 창 열기, 이메일로 전달	500 sats (+200 OCR 추가 기능)

보조 도구

도구	설명
`list_models`	사용 가능한 AI 모델 및 가격 탐색
`get_model_pricing`	특정 모델의 가격 확인
`create_payment`	서비스에 대한 라이트닝 인보이스 생성
`check_payment_status`	결제 수신 여부 확인
`check_job_status`	비동기 작업 상태 확인 (비디오, 3D, 오디오북)
`get_job_result`	완료된 작업 결과 가져오기
`request_refund`	실패한 서비스에 대한 환불 요청
`vote_on_service`	계획된 서비스에 찬성/반대 투표
`list_planned_services`	예정된 서비스 확인 및 투표

작동 방식

에이전트가 list_models를 호출하여 사용 가능한 모델과 가격을 확인합니다.
에이전트가 create_payment를 호출하여 라이트닝 인보이스를 받습니다.
에이전트의 라이트닝 지갑(lightning-wallet-mcp 등)을 통해 결제가 이루어집니다.
에이전트가 paymentId와 함께 도구(image, text 등)를 호출합니다.
결과가 반환됩니다(base64 이미지, 텍스트, URL 등).

API 키가 없습니다. 계정이 없습니다. 신원에 묶인 속도 제한이 없습니다. 오직 비트코인과 AI뿐입니다.

오류 처리 및 환불

결제 후 유료 도구가 실패하면 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 호환 지갑이나 lightning-wallet의 claim_lnurl_withdraw 도구를 사용하여 환불을 청구하세요.

에이전트 지갑을 통한 결제

에이전트가 자율적으로 결제할 수 있도록 라이트닝 지갑 MCP 서버와 페어링하세요:

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

에이전트는 lightning-wallet을 사용하여 sats4ai의 인보이스를 결제함으로써 완전 자율적인 AI 도구 사용이 가능해집니다.

L402 API

MCP 없이 직접 HTTP 통합을 하려면 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: "..." } } }

보안

취약점을 발견하셨나요? 공개 이슈를 열지 마세요. 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

Sats4AI