Polymarket Scan MCP

PolymarketScan MCP 서버

AI 어시스턴트를 위한 Polymarket.com 예측 시장의 읽기 전용 데이터입니다. ChatGPT, Claude, Grok, Cursor, Claude Code 또는 모든 MCP 클라이언트를 연결하여 시장 내재 확률(배당률), 가격 이력, 최대 변동, 트렌딩 마켓, 대형 거래, 매수·매도 흐름, 공개 트레이더 통계 및 관련 뉴스를 확인할 수 있습니다.

• 계정, API 키 또는 OAuth 불필요. 모든 도구는 공개 및 읽기 전용입니다.
• 읽기 전용. 도구는 주문을 체결, 변경 또는 취소하거나, 자금을 이동하거나, 계정에 접근할 수 없습니다.
• 버전: 2.0.0 (2026년 10월). 프로토콜: Streamable HTTP를 통한 MCP (무상태, JSON 응답).

엔드포인트

https://mcp.polymarketscan.org/mcp

기존 주소도 계속 작동하며 동일한 서버를 제공합니다:

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

도구 (11개)

MCP 클라이언트는 서버(tools/list)에서 각 도구의 전체 입력 및 출력 스키마를 읽습니다. 필수로 표시된 입력을 제외한 모든 입력은 선택 사항입니다.

search_markets (예측 시장 검색)

공개된 Polymarket.com 시장을 검색하여 가장 가까운 일치 항목을 반환하며, 각 항목에는 최대 6개 결과의 시장 내재 확률, 24시간 변동 및 거래량이 포함됩니다.

• 입력: query (필수): 이벤트, 인물, 팀, 자산 또는 질문을 일반 언어로 최대 200자. limit: 1~10, 기본값 5.
• 참고: 공개 시장만 해당. 쿼리가 지정한 결과가 먼저 나오고, 그 다음 선두 결과(또는 50%에 가장 가까운 가격 사다리 단계)가 나옵니다. 한 시장의 전체 결과 목록, 규칙 및 상태를 보려면 get_market_odds를 사용하세요.
• 시도해 보세요: "연준의 다음 금리 결정에 대한 배당률은 얼마인가요?"

get_market_odds (시장 배당률 가져오기)

하나의 시장 또는 이벤트 전체: 각 결과의 확률 및 24시간 변동(최대 40개 결과 및 총 개수), 거래량, 유동성, 종료일, 상태, 해결 규칙 및 출처, 그리고 해결된 경우 결과.

• 입력: market (필수): 시장 또는 이벤트 슬러그, polymarket.com 또는 polymarketscan.org 링크, 조건 ID(0x + 64자리 16진수), 또는 일반 언어로 된 시장 이름.
• 참고: 공개, 종료 및 해결된 시장 모두에서 작동합니다. 상호 배타적 결과는 확률순으로 정렬됩니다. 일치하는 항목이 없으면 가장 가까운 공개 시장 최대 3개를 대신 반환합니다.
• 시도해 보세요: "2028년 대통령 선거에서 모든 후보의 확률을 보여주세요."

get_price_history (가격 이력 가져오기)

하나의 결과 확률이 시간 범위에 따라 어떻게 변했는지: 시작 및 종료, 퍼센트 포인트 변화, 최고 및 최저, 그리고 차트.

• 입력: market (필수): get_market_odds와 동일. outcome: 차트로 표시할 결과(예: "Yes" 또는 후보 이름); 기본값은 다중 결과 이벤트의 선두 공개 결과 또는 단일 시장의 첫 번째 결과입니다. range: 1d, 1w, 1m, 3m 또는 all, 기본값 1w.
• 참고: 가격은 Polymarket.com의 주문장 이력에서 가져옵니다. 거래가 적은 시장의 공백은 채우지 않습니다. 종료 또는 해결된 시장의 경우 범위는 거래가 종료된 시점에 끝납니다.
• 시도해 보세요: "미국 경기 침체 확률이 이번 달에 어떻게 변했나요?"

get_market_movers (최대 시장 변동 가져오기)

확률(퍼센트 포인트)의 24시간 변동이 가장 큰 공개 시장으로, 변동한 결과, 현재 확률 및 24시간 거래량을 포함하며 이벤트당 최대 2개입니다.

• 입력: direction: up, down 또는 both, 기본값 both. category: politics, elections, geopolitics, world, economy, finance, crypto, tech, culture, sports, esports, weather 또는 science 중 하나; 모든 카테고리를 보려면 생략. limit: 1~20, 기본값 10.
• 참고: 24시간 동안 최소 $10K가 거래된 가장 많이 거래된 300개 시장(카테고리가 지정된 경우 해당 카테고리 기준)을 다룹니다. 1% 이하 또는 99% 이상으로 가격이 형성된 시장은 사실상 결정된 것으로 간주하여 제외됩니다. 개별 스포츠 및 e스포츠 경기(단일 경기 및 포인트 마진·총점 라인, 예정 또는 진행 중)는 카테고리가 sports 또는 esports인 경우를 제외하고 제외됩니다. 시즌 또는 챔피언십 우승자와 같은 선물은 포함됩니다.
• 시도해 보세요: "오늘 가장 많이 움직인 예측 시장은 무엇인가요?"

get_trending_markets (트렌딩 시장 가져오기)

지난 24시간 동안 가장 많은 거래량을 기록한 공개 이벤트로, 각각 최대 4개 결과의 확률(선두 또는 50%에 가장 가까운 가격 사다리 단계), 24시간 변동 및 거래량을 포함합니다.

• 입력: category: get_market_movers과 동일한 값; 모든 카테고리를 보려면 생략. limit: 1~20, 기본값 8.
• 참고: 이미 결정된 것으로 보이는 이벤트(결과가 99% 이상)와 게임의 보조 속성 시트는 제외됩니다. 개별 스포츠 및 e스포츠 경기(단일 경기, 예정 또는 진행 중)는 카테고리가 sports 또는 esports인 경우를 제외하고 제외됩니다. 시즌 또는 챔피언십 우승자와 같은 선물은 포함됩니다.
• 시도해 보세요: "Polymarket에서 암호화폐 관련 트렌딩은 무엇인가요?"

get_whale_trades (대형 거래 가져오기)

Polymarket.com의 공개 거래 피드에서 가장 큰 최근 거래를 큰 순서대로 표시하며, 시간, 방향, 결과, 달러 규모, 주식 수, 가격, 시장 및 트레이더의 지갑과 공개 이름을 포함합니다.

• 입력: min_usd: 최소 거래 규모(미국 달러), 1,0001,000,000, 기본값 10,000. market: 하나의 시장 또는 이벤트로 제한(슬러그, polymarket.com 또는 polymarketscan.org 링크, 조건 ID 또는 몇 단어); 모든 시장을 보려면 생략. hours: 조회할 과거 기간, 1168, 기본값 24. limit: 1~50, 기본값 15.
• 참고: 모든 시장에서 99¢ 이상 또는 1¢ 이하의 체결(사실상 결정된 시장)은 제외됩니다. 각 체결은 한 번만 계산되며, 달러는 주식 수 × 가격입니다. 피드가 너무 바빠 전체 기간을 스캔할 수 없는 경우 결과에 적용 범위가 명시됩니다.
• 시도해 보세요: "지난 24시간 동안 $50K 이상의 Polymarket 거래를 보여주세요."

get_market_flow (시장 흐름 가져오기)

한 시장에서 누가 매수·매도하는지: 결과별 매수, 매도 및 순 달러, 거래 수, 최대 8개의 대형 거래 및 결과별 최대 5개의 상위 보유자.

• 입력: market (필수): get_market_odds와 동일. hours: 조회할 과거 기간, 1~168, 기본값 24.
• 참고: 다중 결과 이벤트의 경우 선두 공개 결과(가격 사다리의 경우 가장 많이 거래된 공개 단계)를 사용하며 이를 명시합니다. 달러 합계는 각 체결을 한 번만 계산하므로(테이커 측), Polymarket.com이 헤드라인으로 내세우는 양방향 거래량의 약 절반 수준입니다. 매우 바쁜 시장에서는 전체 기간을 맞추기 위해 소액 체결이 제외될 수 있으며, 결과에 이를 명시합니다.
• 시도해 보세요: "비트코인 $150K 시장을 누가 매수하고 있나요?"

get_leaderboard (트레이더 리더보드 가져오기)

Polymarket.com의 수익 또는 거래량 기준 트레이더 리더보드: 순위, 전체 지갑 주소, 공개 표시 이름, 수익 및 달러 거래량, 프로필 링크 포함.

• 입력: metric: profit 또는 volume, 기본값 profit. period: day (00:00 UTC 이후), week (7일), month (30일) 또는 all, 기본값 month. category: sports, politics, crypto, economics, finance, tech, culture, esports, weather 또는 mentions 중 하나; 모든 시장을 보려면 생략. limit: 1~25, 기본값 10.
• 참고: 일간, 주간 및 월간 수익에는 현재 가격의 공개 포지션이 포함되며, 전체 기간 수익은 실현 수익만 포함됩니다. Polymarket은 카테고리별 달러 거래량을 공개하지 않으므로 카테고리 보드에서는 해당 필드가 비어 있습니다.
• 시도해 보세요: "이번 달 수익 기준 상위 Polymarket 트레이더는 누구인가요?"

get_trader_profile (트레이더 프로필 가져오기)

한 트레이더의 공개 통계: 표시 이름, 전체 기간 실현 수익 및 거래량, 포트폴리오 가치, 공개 포지션, 거래한 시장, 최대 5개의 대형 포지션 및 최근 8개의 거래.

• 입력: trader (필수): 전체 0x 지갑 주소(42자), polymarket.com 프로필 링크, @사용자 이름 또는 사용자 이름.
• 참고: 사용자 이름은 가능한 경우 정확히 일치하며, 그렇지 않으면 가장 가까운 공개 프로필이 사용되고 결과에 이를 명시합니다. 최근 거래는 $1 이상의 거래입니다. 지갑을 누가 제어하는지는 알 수 없습니다.
• 시도해 보세요: "이 Polymarket 트레이더를 조회하세요: 0x…"

get_trader_positions (트레이더 포지션 가져오기)

트레이더의 공개 포지션 최대 50개를 주식 수, 평균 및 현재 가격, 가치 및 미실현 손익과 함께 표시하며, 총 개수 및 포트폴리오 가치도 포함합니다.

• 입력: trader (필수): get_trader_profile와 동일. sort: value (현재 가치가 큰 순서) 또는 pnl (미실현 이익이 큰 순서), 기본값 value. limit: 1~50, 기본값 20.
• 참고: $1 미만의 포지션과 상환 대기 중인 해결 포지션은 목록에서 제외됩니다.
• 시도해 보세요: "이 트레이더의 가장 큰 공개 포지션은 무엇인가요?"

get_market_news (시장 뉴스 가져오기)

지난 14일 동안 시장 또는 주제에 대한 최대 10개의 헤드라인을 매체, 게시 시간 및 링크와 함께 PolymarketScan의 주요 매체 뉴스 피드에서 제공합니다.

• 입력: market: 시장 또는 이벤트 슬러그, polymarket.com 또는 polymarketscan.org 링크 또는 조건 ID; 일반 언어는 주제로 처리됩니다. query: "bitcoin etf"와 같은 주제 단어; 시장과 함께 사용하면 해당 단어를 언급하는 해당 시장의 뉴스만 유지합니다. limit: 1~10, 기본값 5. 시장, 쿼리 또는 둘 다 제공하세요.
• 참고: 전체 웹 검색이 아닙니다: 기사 본문을 반환하지 않으며 틈새 시장의 경우 결과가 없을 수 있습니다.
• 시도해 보세요: "연준 결정 시장의 움직임 뒤에 뉴스가 있나요?"

결과

• 단위는 모든 도구에서 동일합니다: 확률은 0~1, 가격 변동은 퍼센트 포인트, 가격은 센트, 금액은 미국 달러, 주식 수는 주식으로 표시됩니다. null 값은 수치를 사용할 수 없음을 의미하며 0이 아닙니다. 지갑은 전체 소문자 주소이므로 결과를 트레이더 도구에 직접 전달할 수 있습니다.
• 바닥글. 각 결과의 텍스트는 "출처: Polymarket.com via PolymarketScan. 정보 제공용이며 투자 조언이 아닙니다."로 끝납니다. 거래 또는 포지션 관련 결과(get_whale_trades, get_market_flow, get_leaderboard, get_trader_profile, get_trader_positions)에는 "거래는 위험하며 100% 손실이 발생할 수 있습니다."가 추가됩니다. get_market_news은 대신 "출처: PolymarketScan의 뉴스 피드를 통한 뉴스 매체. 정보 제공용이며 투자 조언이 아닙니다."로 끝납니다.
• 링크. 시장 및 트레이더 링크는 PolymarketScan 분석 페이지를 열며 ?ref=mcp를 포함하여 AI 어시스턴트에서 방문했음을 표시합니다. 결과 링크 중 polymarket.com의 거래 페이지로 연결되는 것은 없습니다. 뉴스 헤드라인은 게시자의 기사로 연결됩니다.
• 오류. Polymarket의 데이터 서비스가 응답하지 않으면 도구는 다시 시도하라는 짧은 일반 영어 메시지를 반환합니다. 원시 업스트림 또는 데이터베이스 오류를 그대로 전달하지 않습니다.

카드

MCP 앱을 지원하는 호스트(예: ChatGPT)에서는 결과가 대화형 PolymarketScan 카드로 렌더링됩니다: 배당률, 가격 차트, 시장·거래·트레이더의 순위 목록. 카드는 네트워크에서 자체적으로 아무것도 로드하지 않습니다. 다른 클라이언트에서는 동일한 결과가 구조화된 데이터와 짧은 일반 영어 요약으로 제공됩니다.

어시스턴트에 추가하기

ChatGPT

• 플러그인 디렉토리: PolymarketScan이 등록되면 ChatGPT에서 플러그인 디렉토리를 열고 "PolymarketScan"을 검색하여 연결하세요.
• 개발자 모드(등록 전 또는 테스트용): 설정 → 보안 및 로그인 → 개발자 모드를 켜고 chatgpt.com/plugins로 이동하여 **+**를 클릭하고 https://mcp.polymarketscan.org/mcp을 입력한 후 인증 없음을 선택하세요.

Claude (claude.ai 및 Claude Desktop)

• 커넥터 디렉토리: PolymarketScan이 등록되면 설정 → 커넥터 → 커넥터 찾아보기에서 추가하세요.
• 사용자 지정 커넥터: 설정 → 커넥터 → 사용자 지정 커넥터 추가. 이름을 PolymarketScan으로 지정하고 URL https://mcp.polymarketscan.org/mcp을 사용하며 OAuth 필드는 비워 두세요.

Grok

URL https://mcp.polymarketscan.org/mcp와 인증 없이 사용자 지정 커넥터(MCP 서버)를 추가하세요.

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(단일 프로젝트)에 추가:

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

로컬(stdio) 서버만 실행하는 클라이언트

mcp-remote로 브리지하세요. 예: claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

모든 MCP 클라이언트 또는 일반 HTTP

Streamable HTTP 클라이언트를 엔드포인트에 연결하세요. 서버는 상태 비저장이며 POST /mcp를 통해 JSON으로 JSON-RPC에 응답합니다:

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

데이터 소스

배당률, 가격, 거래, 보유자, 리더보드 및 트레이더 통계는 도구가 호출될 때 Polymarket.com의 공개 API에서 가져옵니다. 뉴스 헤드라인은 주요 매체의 PolymarketScan 자체 뉴스 피드에서 제공됩니다. Polymarket.com 응답은 최대 1분 동안 캐시되며, 리더보드, 정산된 시장 및 공개 프로필 이름은 2분에서 1시간 동안 캐시됩니다.

개인정보 보호

서버는 어시스턴트가 만든 도구 호출만 수신하며, 대화 내용은 절대 수신하지 않습니다. 두 가지 유형의 요청을 기록합니다: 클라이언트 연결(initialize) 및 도구 사용(tools/call). 도구 목록 및 기타 프로토콜 메시지는 기록되지 않습니다. 각 레코드에는 작업(연결 또는 도구 이름), 사용자 에이전트에서 파악된 클라이언트 유형, 사용자 에이전트의 처음 300자, 연결 IP 주소의 키 해시(HMAC-SHA-256, 서버 비밀 키 사용, 단축됨) 및 시간이 포함됩니다. 도구 입력 및 결과는 저장되지 않습니다. 자세한 내용: 개인정보 처리방침, 섹션 3.

면책 조항

출처: Polymarket.com via PolymarketScan. 정보 제공 목적일 뿐, 재정적 조언이 아닙니다. 시장 내재 확률은 군중 예측일 뿐 확실성이 아닙니다. 데이터가 지연되거나 잘못될 수 있습니다. 중요한 수치는 연결된 페이지에서 확인하세요. 거래는 위험하며 100% 손실이 발생할 수 있습니다.

PolymarketScan은 Polymarket이 아닌 독립적인 분석 플랫폼입니다. 이용 약관 · 개인정보 처리방침 · 문의 · support@polymarketscan.org