sats4ai-mcp

비트코인 라이트닝으로 결제하는 30개 이상의 AI 도구. 가입, API 키, KYC가 필요 없습니다.

AI 에이전트가 이미지 생성, 비디오 제작, 텍스트 생성, 음성, 번역, 이미지 처리, OCR, 오디오북 변환, 이메일, 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

Cursor

MCP 설정에 추가하세요:

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

stdio 프록시 (레거시 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/단위
`video_from_image`	정지 이미지를 비디오로 애니메이션화	100 sats/초
`text`	AI 언어 모델과 대화 (262K 컨텍스트)	~1 sat/100자
`translate_text`	119개 언어 간 텍스트 번역	~1 sat/1000자
`music`	AI 보컬이 포함된 노래 생성	100 sats
`3d`	사진을 3D GLB 모델로 변환	350 sats

오디오 및 음성

도구	설명	가격
`tts`	텍스트 음성 변환 (467개 음성, 29개 언어)	300 sats
`transcription`	음성 텍스트 변환 (13개 언어)	10 sats/분
`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/페이지
`extract_receipt`	영수증을 구조화된 JSON으로 변환	50 sats
`file_convert`	200개 이상의 파일 형식 간 변환	100 sats
`pdf_merge`	여러 PDF를 하나로 병합	100 sats
`convert_html_to_pdf`	HTML/Markdown을 PDF로 변환	50 sats

통신

도구	설명	가격
`email`	모든 주소로 이메일 전송	200 sats
`sms`	전 세계 SMS 전송	동적
`call`	자동 전화 걸기	동적
`ai_call`	AI 음성 에이전트 전화 (비동기)	동적

도우미 도구

도구	설명
`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.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

라이선스

MIT

Sats4AI