CODASMS MCP Server

AI 에이전트에서 일회용 SMS/OTP 인증 코드를 수신하세요. CODASMS 리셀러 API 기반의 MCP 서버 — 번호를 받고, 코드를 기다리고, 해제하세요 — 700개 이상의 서비스와 180개 이상의 국가에서 지원하며, 수신 성공 시에만 결제됩니다.

이 서버는 AI 에이전트(Claude Desktop, Cursor 또는 MCP를 지원하는 모든 도구)가 전화번호를 구매하고 인증 코드를 프로그래밍 방식으로 읽을 수 있게 해줍니다. 공개 CODASMS 리셀러 API의 가벼운 래퍼(wrapper)로, 자체 로직을 포함하지 않으며 모든 결제와 환불은 API 서버 측에서 결정됩니다.

자신의 API 키를 사용합니다. 가입은 무료입니다: https://codasms.com/reseller.

도구

get_number는 선택적 max_price_cents(또는 CODASMS_MAX_PRICE_CENTS 설정)를 허용하므로 자율 에이전트가 설정한 상한선보다 비싼 번호를 구매할 수 없습니다.

Related MCP server: agentline-mcp

빠른 시작(로컬 / stdio)

export CODASMS_API_KEY=coda_live_xxxxxxxx   # from https://codasms.com/reseller
npx codasms-mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "codasms": {
      "command": "npx",
      "args": ["-y", "codasms-mcp"],
      "env": { "CODASMS_API_KEY": "coda_live_xxxxxxxx" }
    }
  }
}

그런 다음 요청하세요: "영국에서 Telegram 번호를 받고 코드를 읽어줘."

원격(HTTP) 모드

동일한 도구가 Streamable HTTP로 제공되므로 여러 사용자를 위해 하나의 인스턴스를 호스팅할 수 있습니다 — 각 사용자는 자신의 키를 Bearer 토큰으로 전송합니다(서버 측에 저장되는 것은 없음):

npm run build && npm run start:http     # listens on :8080, POST /mcp

POST /mcp
Authorization: Bearer coda_live_xxxxxxxx
Content-Type: application/json

src/http.ts는 이식 가능한 Node 서버입니다(Deno Deploy, Railway, Fly, 모든 컨테이너). Cloudflare Workers의 경우 Node http 핸들러를 fetch 핸들러로 교체하세요 — src/server.ts의 서버 팩토리는 전송 방식에 독립적이므로 변경할 필요가 없습니다.

구성

참고 사항

• 속도 제한: API는 키당 분당 60회 요청을 허용합니다. wait_for_otp는 기본적으로 5초에 한 번보다 빠르게 폴링하지 않아 이 제한을 충분히 준수합니다.

• 금전 안전: get_number는 호출 즉시 실제 잔액을 사용합니다. 코드가 도착하지 않으면 주문은 20분 후 자동 환불되며, release를 호출하여 즉시 환불할 수도 있습니다.

• 코드: 서비스와 국가는 API의 코드를 사용합니다(예: tg, wa, 국가 6) — list_services / list_countries를 사용하여 확인하세요.

개발

npm install
npm run build      # tsc -> dist/
npm start          # stdio

라이선스

MIT — LICENSE 참조.