에이전트에게 열려 있는 플랫폼

GADUIN은 Model Context Protocol 서버를 운영합니다. LLM 에이전트와 트레이딩 봇이 사용자의 권한으로 실시간 마켓·포지션·잔액을 조회할 수 있습니다.

MCP란?

Model Context Protocol은 LLM 클라이언트를 외부 데이터·도구와 연결하기 위한 개방형 표준입니다. GADUIN은 MCP 엔드포인트를 공개하므로 Claude Desktop, Claude.ai, 커스텀 에이전트 등 어떤 MCP 호환 클라이언트든 사용자 API 키로 연결할 수 있습니다. 모든 호출은 키를 발급한 사용자 범위로 인증·제한됩니다.

사용 가능한 도구

v1 도구 카탈로그는 읽기 전용입니다. 각 도구가 입력 스키마를 직접 게시하므로 LLM 클라이언트가 자동으로 연결합니다 — JSON을 직접 작성할 필요가 없습니다.

list_markets
실세계 운송 결과(항공 지연, 철도 취소, 해상 초크포인트 처리량)에 대한 열린 예측 마켓을 나열합니다. 선택 입력: category (FLIGHT, TRAIN, SHIP), status (기본값 OPEN), limit (1–100). 마켓 id, 카테고리, 질문, 현재 가격이 포함된 결과, 누적 거래량, 마감 시각을 반환합니다.
get_market
id로 단일 마켓을 조회합니다. 현재 가격과 결과 포함. 입력: id (마켓 UUID).
get_my_positions
인증된 사용자의 모든 마켓 열린 포지션을 나열합니다. 입력 없음. market_id, outcome_idx, 보유 지분, 총 매입 단가를 반환합니다.
get_balance
인증된 사용자의 현재 달러 잔액을 문자열로 반환합니다. 입력 없음.

현재 거래는 REST 전용

거래·입금·출금은 의도적으로 아직 MCP에 노출되지 않았습니다 — MCP가 주도하는 거래는 읽기보다 영향 범위가 크기 때문에, UX가 검증될 때까지 사람을 루프에 두려 합니다. 프로그래매틱 거래는 권한이 제한된 API 키를 사용해 REST API로 가능합니다.

클라이언트 연결

1.회원가입하고 계정을 인증하세요.
2.계정 설정에서 API 키를 생성하세요 — MCP에는 read 스코프로 충분합니다.
3.아래 스니펫을 MCP 호환 클라이언트에 붙여넣고 본인의 키로 교체하세요.

엔드포인트

https://gaduin.com/mcp

Authorization

Bearer YOUR_API_KEY

Claude Desktop 설정

{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 에 붙여넣고 API 키를 교체한 뒤 Claude를 재시작하세요.

Endpoint reference

직접 연동하고 싶으신가요? 아래에 Model Context Protocol 엔드포인트와 익명·읽기 전용 REST API가 정리되어 있습니다. 사이트와 MCP 서버가 제공하는 것과 동일한 시장, 호가창, 가격을 제공합니다.

MCP endpoint

https://gaduin.com/mcp

REST read API (base URL)

https://gaduin.com/api/v1

GET /markets
열려 있는 시장 목록을 조회합니다. 카테고리(FLIGHT, TRAIN, SHIP)와 상태로 필터링하고, limit과 cursor로 결과를 페이지 단위로 넘겨볼 수 있습니다.
GET /markets/{id}
id로 개별 시장을 조회합니다. 정산 규칙과 근거 자료가 함께 제공됩니다.
GET /markets/{id}/book
시장의 호가창 스냅샷입니다.
GET /markets/{id}/trades
시장의 최근 체결 내역입니다.
GET /markets/{id}/price-history
시장의 과거 가격 스냅샷입니다.
GET /markets/positions
모든 시장에 걸친 실시간 총 포지션입니다.
GET /markets/config
거래 한도 — 최소 및 최대 거래 금액입니다.
GET /healthz
Liveness probe.

기계 판독 가능한 탐색

에이전트가 이 페이지를 스크래핑할 필요는 없습니다. 위의 모든 기능은 사이트 루트에서 제공되는 표준 기반 문서에도 기술되어 있어, MCP나 OpenAPI를 지원하는 클라이언트라면 시장과 API, 인증 방법을 스스로 탐색할 수 있습니다.

/.well-known/mcp/server-card.json
MCP Server Card(SEP-1649) — Model Context Protocol 엔드포인트와 전송 방식, 인증 방법입니다.
/.well-known/openapi.json
익명·읽기 전용 REST API에 대한 OpenAPI 3.1 명세입니다.
/.well-known/api-catalog
API Catalog(RFC 9727) — 기계 판독 가능한 모든 인터페이스를 하나로 묶어 주는 링크셋입니다.
/.well-known/oauth-protected-resource
OAuth 2.0 Protected Resource Metadata(RFC 9728) — 어떤 인가 서버가 API 토큰을 발급하는지와 그 토큰이 갖는 스코프입니다.
/.well-known/oauth-authorization-server
OAuth 2.0 Authorization Server Metadata(RFC 8414) — 발급자, 토큰 엔드포인트, 그리고 API 키를 토큰으로 교환하는 그랜트입니다.
/.well-known/agent-skills/index.json
Agent Skills 색인 — 에이전트가 플랫폼 사용법을 익히기 위해 내려받을 수 있는 SKILL.md 가이드 목록이며, 각 항목은 다이제스트로 고정되어 있습니다.
/api/md
콘텐츠 협상을 통해 모든 공개 페이지를 마크다운으로 렌더링합니다(Accept: text/markdown 헤더 전송).
/auth.md
사람과 에이전트가 모두 읽을 수 있도록 정리한, 인증 절차와 스코프가 지정된 API 키 발급 안내입니다.

시작하기 API 키 관리