polymarket-mcp

AI 에이전트를 위한 예측 시장 인텔리전스. 195개 이상의 엄선된 온체인 지갑에서 제공하는 독점 데이터를 기반으로 Polymarket의 지갑 점수, 차익 거래 탐지, 유동성 분석 및 실시간 가격 피드를 제공합니다.

기능

AI 에이전트에게 다음과 같이 질문하세요:

• "YES + NO 가격 합계가 100%가 되지 않는 모든 Polymarket 시장을 찾아줘"

• "비트코인 $100k 시장에서 YES를 $500어치 매수할 때 슬리피지는 얼마인가요?"

• "Polymarket에서 점수와 PnL 기준 상위 20개 지갑을 보여줘"

• "이 고래 지갑과 함께 거래하는 지갑들은 무엇인가요? 그림자 네트워크를 찾아줘."

• "이 시장의 유동성 등급은 어떻게 되나요? 진입해도 안전한가요?"

• "이 5개 포지션에 대한 내 포트폴리오 위험을 계산해줘"

• "비트코인이 6월까지 $150k에 도달할 확률은 얼마인가요?"

• "오늘의 암호화폐 뉴스를 스캔하고 열려 있는 Polymarket 시장과 매칭해줘"

설치

pip install polymarket-trading-mcp

또는 직접 실행:

uvx --python 3.11 polymarket-trading-mcp

MCP 설정

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "polymarket": {
      "command": "polymarket-mcp",
      "args": ["--stdio"]
    }
  }
}

SSE 서버로 실행:

polymarket-mcp
# Starts on http://127.0.0.1:8000/sse

스트리밍 가능한 HTTP로 실행:

polymarket-mcp --http
# Starts on http://127.0.0.1:8000/mcp

그런 다음 클라이언트를 http://127.0.0.1:8000/sse 또는 http://127.0.0.1:8000/mcp로 지정하세요.

비교

도구

무료 도구

CLOB 오더북을 탐색하여 특정 포지션 규모에 대한 평균 체결 가격을 계산합니다.

estimate_slippage(
    market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328",
    side="BUY",
    position_size_usd=500.0
)

반환값: best_price, avg_fill_price, slippage_pct, liquidity_available, recommendation (진행/주의/진행 불가).

중간 가격 대비 1%/2%/5% 지점의 스프레드와 깊이를 포함하여 시장의 유동성 깊이를 스캔합니다.

scan_market_liquidity(market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328")

반환값: best_bid, best_ask, spread_pct, 깊이 버킷, liquidity_grade (A/B/C).

모든 활성 Polymarket 시장을 스캔하여 YES + NO 가격 합계가 1.00이 아닌 경우를 찾습니다.

find_arbitrage_gaps(min_gap_pct=2.0)

반환값: 격차가 있는 시장, 격차 크기, 활용 방향 (BUY_BOTH 또는 SELL_BOTH).

Binance 및/또는 CoinGecko에서 실시간 암호화폐 가격을 병렬로 가져오며, 지연 시간 메타데이터를 포함합니다.

get_crypto_price(symbol="BTC", sources="binance,coingecko")

반환값: 소스별 가격, 평균, 소스 간 최대 편차.

활성 Polymarket 계약의 남은 시간 및 해결 상태를 확인합니다. BTC 5분/15분 계약은 정확한 만료를 위해 슬러그 타임스탬프 파싱을 사용합니다.

get_contract_status(market_id="btc-updown-5m-1711234567")
get_contract_status(category="crypto")  # scan all short-duration contracts

반환값: time_remaining_seconds, time_remaining_human, current_odds.

구조화된 추론을 사용하여 모든 이벤트의 확률을 추정합니다. 기본 비율, 주요 요인, 기간 분석을 하나의 구조화된 JSON 응답으로 제공합니다.

estimate_probability(question="Will Bitcoin reach $150k before end of 2025?")

반환값: estimated_probability (0-1), confidence_level, factors_for, factors_against, base_rate_note, reasoning.

예측 시장 포지션 포트폴리오에 대한 순수 수학적 위험 지표입니다. 외부 API 호출이 없습니다.

calculate_portfolio_risk(positions='[{"market_id": "abc123", "side": "YES", "size": 200, "entry_price": 0.65}]')

반환값: total_exposure, max_loss, max_gain, diversification_score, kelly_warnings, rebalancing_suggestions.

채점 방법론, 현재 데이터셋 통계 및 가격을 반환합니다. 유료 데이터가 가치가 있는지 평가하기 위해 먼저 이 도구를 호출하세요. API 키가 필요하지 않습니다.

유료 도구 (API 키 필요)

가입 시 7일 무료 체험 제공. 체험 후: Polygon에서 USDC로 요청당 결제. 대량 할인: 하루 1000회 요청 초과 시 50% 할인.

동일한 Polymarket 카테고리에서 시드 지갑과 함께 거래하는 지갑을 찾습니다.

get_shadow_wallets(seed_wallet="0xabc...", api_key="your-key")

반환값: 공동 거래 강도, 공유 카테고리, 승률에 따라 순위가 매겨진 최대 20개의 그림자 지갑.

MoonMirror의 채점 엔진(PnL + 일관성 + 전문성 - 손실 페널티)에 따른 상위 Polymarket 지갑입니다.

get_top_wallets(api_key="your-key", limit=50, min_score=0.5)

특정 지갑 주소에 대한 전체 채점 분석입니다.

get_wallet_score(address="0xabc...", api_key="your-key")

반환값: 점수 구성 요소, 승률, 거래 횟수, 데이터 신선도.

카테고리별 분석을 포함한 지갑의 실현 PnL입니다. Goldsky 서브그래프에서 미리 계산되었습니다.

get_wallet_pnl(address="0xabc...", api_key="your-key")

3개 이상의 서로 다른 상위 점수 지갑과 독립적으로 함께 나타나는 지갑들입니다. 단일 그림자 매칭보다 더 강력한 신호입니다.

get_wallet_clusters(api_key="your-key", min_co_trades=3)

토큰 ID와 현재 중간 가격을 포함한 활성 BTC 5분 및 15분 Polymarket 계약입니다. 캐시되며 60초마다 새로 고쳐집니다.

get_btc_short_markets(api_key="your-key")

Claude의 추론을 사용하여 예측 시장 질문에 대한 구조화된 확률적 분석을 수행합니다.

analyze_market_sentiment(question="Will Ethereum ETF hit $10B AUM by Q3 2025?", api_key="your-key")

가격

독립형 패키지도 사용 가능: polymarket-slippage, polymarket-liquidity, polymarket-arb-detector, polymarket-price-feed, polymarket-sentiment, polymarket-timer, polymarket-news, polymarket-onchain

이 서버를 선택해야 하는 이유

다른 모든 Polymarket MCP 서버는 공개 API를 쿼리합니다. 우리는 독점적인 지갑 인텔리전스(엄선된 점수, Goldsky의 실제 PnL 데이터, 상대방 마이닝을 통해 발견된 그림자 지갑 네트워크)를 보유하고 있습니다. 다른 곳에서는 얻을 수 없는 데이터입니다.

유료 지갑 도구는 Polymarket 지갑 인텔리전스 엔진인 MoonMirror를 기반으로 합니다. MoonMirror는 온체인 지갑을 지속적으로 모니터링하고, PnL, 일관성, 시장 전문성을 기준으로 점수를 매기며, 그림자 지갑 관계를 미리 계산합니다.

모든 것이 미리 계산되어 있으므로 모든 지갑 쿼리는 100ms 이내에 반환됩니다. 차단되는 서브그래프 호출이 없습니다.

구성

모든 설정은 환경 변수를 통해 이루어집니다:

# Server
HOST=127.0.0.1
PORT=8000

# DB paths (for self-hosted wallet intelligence)
MOONMIRROR_DB_PATH=/path/to/moonmirror.db
SERVICES_DB_PATH=/path/to/services.db

# Pricing
PRICE_WALLET_INTEL=0.05
PRICE_MARKET_DATA=0.01
TRIAL_DAYS=7

# Rate limiting
RATE_PER_KEY=5
RATE_GLOBAL=20

# Create an API key
polymarket-mcp --create-key "customer-name"

# Top up a key's USDC balance
polymarket-mcp --top-up YOUR_KEY 10.0

github.com/whitmorelabs/polymarket-mcp — 이슈, PR 및 스타는 언제나 환영합니다.