xRocket Exchange MCP

MCP를 지원하는 AI 클라이언트를 통해 xRocket CEX 주문을 준비·검토·실행할 수 있습니다. 로컬 서버는 별도로 승인된 실행 전에 거래소 예상 견적, 수수료, 시장 규칙, 관련 잔액, 그리고 정확한 의도를 가져옵니다.

호스팅 엔드포인트는 공개 시장 데이터 데모이자 온보딩 경로로 유지됩니다. 계정 자격 증명을 받지 않으며 거래를 실행할 수 없습니다. 이 패키지는 xRocket과 제휴하거나 xRocket의 보증을 받지 않습니다. 거래 설정 또는 xRocket 열기를 확인하세요.

거래 빠른 시작

1. xRocket에 로그인하고 메뉴 → 설정 → 거래 설정 → API 토큰을 엽니다.

2. 테스트넷 우선, 주문 전용 MCP 구성을 생성합니다.

   npx -y xrocket-mcp@0.5.0 trading-config

3. 출력된 JSON을 로컬 MCP 클라이언트에 붙여넣습니다. SET_YOUR_XROCKET_API_TOKEN_LOCALLY는 로컬 클라이언트의 비밀 설정 또는 환경 설정에서만 교체하세요.

4. 클라이언트에게 주문을 준비하고 실행하지 않은 채 예상 견적, 수수료, 잔액, 규칙, 정확한 의도를 표시하도록 요청하세요. 해당 미리보기를 검토한 후에만 명시적으로 승인하세요.

npx -y xrocket-mcp@0.5.0 trading-config --mainnet는 테스트넷 검증 후에만 사용하세요. 이 명령은 별도의 메인넷 주문 게이트를 활성화하며, 전송과 출금은 계속 비활성화 상태로 유지됩니다.

업스트림 토큰은 문서화된 세분화된 권한 범위가 아닌 넓은 계정 접근 권한을 가집니다. 이 토큰을 채팅, 호스팅 엔드포인트, 커밋된 파일, 이슈 또는 로그에 절대 넣지 마세요.

Related MCP server: tossinvest-openapi-mcp

호스팅 시장 데모

연결 페이지를 사용하거나, 아무것도 설치하지 않고 자격 증명을 입력하지 않은 채 공개 메인넷 엔드포인트를 복사하세요.

https://xrocket-mcp-production.up.railway.app/mcp

이 엔드포인트는 10개의 공개 도구만 노출하며 계정 토큰을 읽거나 금융 쓰기 기능을 활성화할 수 없습니다. 거래 요청이 들어오면 온보딩 도구는 사용자를 위의 로컬 설정으로 안내합니다.

로컬 빠른 시작

npx -y xrocket-mcp@0.5.0 doctor
npx -y xrocket-mcp@0.5.0 config

Node.js 20 이상이 필요합니다. 공개 시장 읽기는 구성 없이도 동작합니다.

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

저장소 마켓플레이스에서 올인원 Codex 플러그인을 설치하세요.

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

MCP 클라이언트 예시:

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.5.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

소스 개발을 위해 이 디렉터리에서 npm ci, npm test, npm run build를 실행하세요.

프로필 및 쓰기 게이트

• public: 합성된 xrocket_market_snapshot을 포함한 10개의 인증 불필요 도구.

• private-read: 공개 도구에 더해 잔액, 계정 전체 개요, 주문, 전송, 출금, 할당량을 포함합니다. XROCKET_API_TOKEN이 있으면 자동으로 결정됩니다.

• full: 모든 도구를 포함하지만, 각 실행 계열(예: 거래, 전송, 출금)은 해당하는 게이트가 true로 설정되지 않는 한 계속 비활성화 상태로 유지됩니다.

쓰기 게이트는 XROCKET_ENABLE_TRADING, XROCKET_ENABLE_TRANSFERS, XROCKET_ENABLE_WITHDRAWALS이며 모두 기본값은 false입니다. 메인넷 쓰기를 위해서는 XROCKET_ALLOW_MAINNET_WRITES=true도 필요합니다.

모든 금융 쓰기는 정확히 준비된 의도를 서버 메모리에 저장하고, 수명이 짧고 요청에 바인딩된 일회용 승인 영수증을 반환합니다. 누락된 클라이언트 식별자는 준비 과정에서 생성되며 미리보기에 표시됩니다. Execute는 그 영수증만 수락합니다. 네트워크 결과가 모호한 후에는 쓰기가 자동으로 재시도되지 않으므로, 먼저 클라이언트 식별자로 조정하세요.

영수증은 페이로드를 바인딩할 뿐, 인간의 동의를 증명하지는 않습니다. MCP 클라이언트에 신뢰할 수 있는 승인 UI 또는 대역외(out-of-band) 운영자 정책이 없다면, 모든 실행 게이트를 비활성화 상태로 유지하세요.

경계

• 거래소 API에는 입금 주소 엔드포인트가 없습니다. 온보딩은 UI 안내일 뿐입니다.

• 거래소 전송은 내부 funding ↔ trading 사이의 전송이며, 사용자 간 결제가 아닙니다.

• xRocket Pay는 별도의 제품이며 포함되지 않습니다.

• WebSocket 채널은 감사되었지만 0.5.0에서는 제한된 REST 스냅샷만 사용합니다.

• 금융 값은 소수점 문자열로 유지하고, 현재 API가 요구하는 곳에서는 TONCOIN을 사용하세요.

전체 문서, 커버리지, 보안 정책, 개인정보 고지, 서비스 약관은 프로젝트 저장소에 있습니다.