Polymarket MCP 서버

Claude Code 또는 모든 MCP 호환 클라이언트를 통해 Polymarket 예측 시장을 거래, 분석 및 자동화하기 위한 MCP 서버입니다.

주요 기능

직접 거래 — 시장가 또는 지정가 주문으로 모든 Polymarket 시장에서 매수 및 매도
시장 검색 — 키워드, 카테고리 또는 종료 날짜별로 시장 검색
카피 트레이딩 — 상위 트레이더를 관찰하고 자동으로 거래 복사
스마트 머니 흐름 — 여러 상위 트레이더가 동일한 시장에 집중하는 시점 감지
백테스트 — 자본을 투입하기 전에 트레이더의 과거 거래를 복사하는 시뮬레이션 수행
확신 점수(Conviction Scoring) — 승률, 일관성, 경험 및 다양성을 기반으로 0-100점 산출
시장 품질 필터 — 스프레드, 깊이 및 가격 범위를 기반으로 유동성이 낮은 시장 자동 제외
손절매 / 익절(Stop-Loss / Take-Profit) — 모든 포지션에 자동 종료 규칙 설정
자동 리밸런싱 — 실적이 저조한 트레이더를 관심 목록에서 제거
가격 기록 — 스파크라인 차트가 포함된 과거 가격 데이터
34개의 MCP 도구 — Claude Code를 통해 자연어로 완벽하게 제어

빠른 시작

사전 요구 사항

Node.js 18+
Claude Code CLI (또는 모든 MCP 클라이언트)

설치

npm install -g polymarket-trader-mcp

또는 Claude Code 설정(~/.claude/settings.json)에 추가:

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

구성

.env.example을 .env로 복사하고 구성하세요:

cp .env.example .env

변수	필수 여부	기본값	설명
`COPY_MODE`	아니요	`preview`	`preview` (시뮬레이션) 또는 `live` (실제 주문)
`DAILY_BUDGET`	아니요	`20`	일일 최대 지출액 (USDC)
`MIN_CONVICTION`	아니요	`3`	복사할 최소 거래 규모 ($)
`POLY_PRIVATE_KEY`	라이브 전용	-	Polymarket 지갑 개인 키
`POLY_API_KEY`	라이브 전용	-	CLOB API 키
`POLY_API_SECRET`	라이브 전용	-	CLOB API 비밀 키
`POLY_API_PASSPHRASE`	라이브 전용	-	CLOB API 암호
`MCP_LICENSE_KEY`	Pro 전용	-	마켓플레이스 라이선스 키

도구

탐색

도구	설명
`search_markets`	키워드별 시장 검색 (비트코인, 선거, UFC 등)
`discover_traders`	PnL 및 거래량 기준 상위 트레이더 찾기
`discover_markets`	종료 날짜 및 카테고리별 시장 찾기
`discover_wta`	스팅크 비드(stink bid) 가격이 있는 WTA 테니스 시장 찾기
`discover_flow`	스마트 머니 신호 — 여러 상위 트레이더가 동일 시장 매수

거래

도구	설명
`buy`	모든 시장에서 주식 매수 — 직접 거래
`sell`	오픈 포지션 매도
`place_stink_bid`	할인된 가격에 지정가 주문 배치
`cancel_orders`	모든 오픈 주문 취소
`go_live`	미리보기 모드에서 라이브 모드로 전환

카피 트레이딩

도구	설명
`watch_wallet`	관심 목록에 트레이더 추가/제거
`start_monitor`	카피 트레이딩 루프 시작
`stop_monitor`	카피 트레이딩 루프 중지
`rebalance`	실적이 저조한 트레이더 제거

분석

도구	설명
`analyze_trader`	승률 및 P&L을 포함한 상세 트레이더 프로필
`score_trader`	5개 차원에 걸친 확신 점수(0-100)
`backtest_trader`	과거 거래 복사 시뮬레이션
`check_market`	시장 품질 확인 (스프레드, 깊이)
`get_price`	실시간 매수/매도/스프레드 가격
`get_price_history`	스파크라인이 포함된 과거 가격 (1시간-1분)

포트폴리오

도구	설명
`get_balance`	계정 잔액, 예산 및 P&L 요약
`get_portfolio`	트레이더별 P&L을 포함한 다중 지갑 개요
`get_positions`	오픈/종료된 포지션
`close_position`	수동으로 포지션 종료
`set_exit_rules`	손절매 및 익절 수준 설정
`check_exits`	해결을 위한 포지션 확인
`watch_market`	가격 알림이 포함된 시장 관심 목록

유틸리티

도구	설명
`get_dashboard`	터미널 형식의 대시보드
`get_trade_history`	필터가 포함된 거래 기록
`set_config`	봇 설정 업데이트
`list_watchlist`	관찰 중인 지갑 표시
`log_cycle`	대시보드 추적을 위한 에이전트 주기 기록

무료 vs Pro

기능	무료	Pro
시장 검색 및 탐색	전체	전체
매수 / 매도 (미리보기 모드)	전체	전체
매수 / 매도 (라이브 모드)	-	전체
가격 및 시장 품질	전체	전체
가격 기록	전체	전체
트레이더 탐색	1 페이지	전체
지갑 관찰	최대 3개	무제한
트레이더 분석 (기본)	전체	전체
트레이더 점수 산출	-	전체
트레이더 백테스트	-	전체
스마트 머니 흐름	-	전체
카피 트레이딩 모니터	-	전체
포트폴리오 개요	-	전체
시장 관심 목록 및 알림	-	전체
손절매 / 익절	-	전체
리밸런싱	-	전체
거래 기록	-	전체

mcp-marketplace.io에서 Pro 라이선스를 받으세요.

개발

git clone https://github.com/demwick/polymarket-trader-mcp.git
cd polymarket-trader-mcp
npm install
npm run build
npm test         # 200+ tests

라이선스

MIT

polymarket-trader-mcp

Polymarket MCP 서버

주요 기능

빠른 시작

사전 요구 사항

설치

구성

도구

탐색

거래

카피 트레이딩

분석

포트폴리오

유틸리티

무료 vs Pro

개발

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API