MCP: AI 어시스턴트의 RealmPulse 통계

RealmPulse는 MCP(Model Context Protocol)로 플레이어 통계를 공개합니다 — AI 어시스턴트가 직업, 레벨, 지역, 특정 플레이어에 대한 질문에 채팅 중 바로 답할 수 있습니다. 접근은 무료이며, 전체 도구 세트에는 무료 API 키가 필요합니다.

연결

서버는 세션 없는 HTTP 방식입니다 — 아무 MCP 클라이언트에나 URL을 지정하면 됩니다. 예: Claude Code:

claude mcp add --transport http realmpulse https://foragerstats.com/mcp

또는 범용 JSON 설정 (Claude Desktop, Cursor 등):

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp" } } }

게스트 접근 (키 없음)

가입 없이 하나의 도구를 사용할 수 있습니다 — get_class_distribution: 직업과 진영별 플레이어 분포, 게임 모드 필터 제공. 제한은 분당 30요청입니다.

무료 API 키

1. 가입하세요: 페이지 상단의 «가입» 버튼.
2. 프로필을 열고 API 키를 만드세요 — 한 번만 표시되니 저장하세요.
3. /mcp 요청에 Authorization: Bearer <키> 헤더를 추가하세요 (대부분의 클라이언트는 설정의 headers 필드).

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp", "headers": { "Authorization": "Bearer rp_..." } } } }

도구

• get_class_distribution — 직업·진영별 플레이어 (키 없이 사용 가능).
• search_players — 이름·직업·지역으로 플레이어 검색 — 가입 후.
• get_level_distribution — 레벨 1–60별 플레이어 수 — 가입 후.
• get_zone_stats — 가장 붐비는 지역 — 가입 후.
• upload_saved_variables — 자신의 NearbySpy.lua를 공유 데이터 수집에 업로드(API 키 필요)

mode 필터는 pve, pvp, hardcore 세 값만 허용합니다. 그 외 값은 허용 목록을 담은 명시적 오류로 처리됩니다. mode 없이는 모든 모드 데이터를 반환합니다.

요청 예시

POST /mcp MCP-Protocol-Version: 2026-07-28 Mcp-Method: tools/call Mcp-Name: get_class_distribution { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_class_distribution", "arguments": { "mode": "pve" } } }

제한: 키 없이 분당 30요청, 키 사용 시 분당 120요청. 초과 시 서버는 429를 반환합니다 — 잠시 후 재시도하세요.