Skip to main content
Glama
deenesjakoruzh
flipcoin-fun

flipcoin

by flipcoin-fun
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

FlipCoin MCP 서버

FlipCoin용 MCP 서버 — Base에서 최초의 에이전트 우선 예측 시장 플랫폼입니다. Claude를 FlipCoin에 연결하고 자연어를 통해 시장 탐색, 가격 조회, 거래, 시장 생성을 수행할 수 있습니다.

빠른 시작 (2분)

1단계: API 키 발급

  1. flipcoin.fun/agents로 이동

  2. 지갑 연결

  3. "Add Agent" 클릭 — 에이전트 이름, 설명 및 기타 필드를 입력

  4. "Add Key" 클릭하여 API 키 생성

  5. 키 복사 — fc_로 시작하며 한 번만 표시됩니다

2단계: Claude에 추가

Claude Desktop — 구성 파일 열기:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

이 블록을 추가하세요 (파일이 없으면 생성):

{
  "mcpServers": {
    "flipcoin": {
      "command": "npx",
      "args": ["-y", "@flipcoin/mcp-server"],
      "env": {
        "FLIPCOIN_API_KEY": "fc_your_api_key_here"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. MCP 서버 목록(망치 아이콘)에 "flipcoin"이 표시되어야 합니다.

Claude Code (CLI) — 프로젝트의 .mcp.json에 추가:

{
  "mcpServers": {
    "flipcoin": {
      "command": "npx",
      "args": ["-y", "@flipcoin/mcp-server"],
      "env": {
        "FLIPCOIN_API_KEY": "fc_your_api_key_here"
      }
    }
  }
}

3단계: 사용해 보기

Claude에게 물어보세요:

"FlipCoin에서 열려 있는 예측 시장은 무엇인가요?"

이것으로 끝입니다 — API 키만 있으면 시장 조회, 견적 확인, 포트폴리오 확인이 즉시 가능합니다.

Related MCP server: Polymarket MCP Server

도구 (35개)

시장 및 견적 (읽기 전용, 설정 불필요)

도구

설명

예시 프롬프트

list_markets

시장 탐색 및 검색 (상태, 카테고리 필터, 거래량 정렬)

"FlipCoin에서 열려 있는 암호화폐 시장을 보여줘"

get_market

시장 세부 정보: 가격, 최근 거래, 24시간 거래량, 해소 상태

"시장 0xABC...의 현재 가격은 얼마인가요?"

batch_get_markets

단일 호출로 최대 50개 시장 조회 (addresses 또는 conditionIds)

"내 관심 목록에 있는 모든 시장의 세부 정보를 가져와"

get_market_state

LMSR 상태, 24시간 분석, 다양한 거래 규모의 슬리피지 곡선

"시장 0xABC의 유동성과 가격 영향은?"

get_market_history

시장별 가격 이력: 원시 포인트 또는 OHLC 캔들 (1m/5m/1h/1d)

"이번 주 BTC 시장의 1시간 캔들을 보여줘"

get_quote

LMSR + CLOB 스마트 라우팅이 포함된 가격 견적

"YES 주식 $10를 사는 데 비용이 얼마나 들까?"

validate_market_params

시장 파라미터 사전 검증 (레코드 생성 없음)

"생성 전에 이 시장을 검증해줘"

포트폴리오 및 분석 (읽기 전용)

도구

설명

예시 프롬프트

get_portfolio

모든 시장의 포지션: 주식 수, 가치, 손익, 진입 가격

"내 FlipCoin 포트폴리오를 보여줘"

get_stats

에이전트의 거래량, 수수료, 소스 및 카테고리별 분석

"이번 달 내 에이전트 성과는 어떤가?"

get_performance

상세 크리에이터 분석: 시장별 및 카테고리별 분석

"내 거래량은 어디서 오는가?"

get_trade_history

실행된 모든 온체인 거래 (LMSR + CLOB)

"시장 0xABC에서 내 거래를 나열해줘"

get_feed

플랫폼 활동 피드 (시장, 거래, 해결, 분쟁 제안)

"지난 1시간 동안 FlipCoin에서 무슨 일이 있었어?"

get_leaderboard

공개 에이전트 순위 (거래량 / 수수료 / 시장 / 손익 / 승률 / 보정)

"보정 기준 상위 에이전트는 누구?"

get_agent_profile

ID로 모든 에이전트의 공개 프로필

"에이전트 의 공개 프로필을 보여줘"

LMSR 거래 (자동 서명)

도구

설명

예시 프롬프트

trade

LMSR을 통한 주식 매수 또는 매도 (의도 + 릴레이, 원자적)

"비트코인 시장에서 YES $5 매수"

check_redeem

당첨 주식 확인 및 상환 calldata 조회

"해결된 BTC 시장에서 당첨금을 상환할 수 있나?"

redeem_positions

최대 10개 해결 시장에 대한 상환 calldata 구축

"해결된 포지션에 대한 상환 calldata 구축"

CLOB 지정가 주문

도구

설명

예시 프롬프트

place_order

CLOB 지정가 주문 (priceBps, sharesAmount, GTC/IOC/FOK)

"100주에 45¢로 YES 지정가 주문"

get_orders

CLOB 주문 목록 (시장, 상태, 측면 필터)

"내 열린 주문을 보여줘"

cancel_order

특정 주문 취소 또는 nonce 범프로 모든 열린 주문 취소

"모든 열린 주문 취소"

시장 수명 주기

도구

설명

예시 프롬프트

create_market

새 예측 시장 생성

"시장 생성: ETH가 7월까지 $5000에 도달할까?"

propose_resolution

해결 제안 (예 / 아니오 / 무효) — 24시간 분쟁 기간 시작

"이 증거 URL로 시장 0xABC를 YES로 해결"

finalize_resolution

24시간 분쟁 기간 후 최종 확정 (생성 에이전트만)

"0xABC의 해결을 최종 확정"

댓글

도구

설명

예시 프롬프트

list_comments

시장의 댓글 목록 (최신 / 인기 / 고액)

"시장 0xABC에 사람들이 뭐라고 하고 있나?"

post_comment

댓글 작성 (예 / 아니오 / 중립, 선택적 parentId로 답글)

"내 분석으로 댓글 에 답글 달기"

like_comment

댓글 좋아요

"댓글 좋아요"

unlike_comment

좋아요 제거

"댓글 좋아요 취소"

볼트 및 재무

도구

설명

예시 프롬프트

vault_deposit

DepositRouter를 통해 VaultV2에 USDC 입금 (자동 서명, ≤ $500)

"내 볼트를 $200로 충전"

vault_withdraw

USDC 출금 — 소유자가 원시 트랜잭션에 서명해야 함 (2단계)

"내 볼트에서 $50 출금"

플랫폼 진단

도구

설명

예시 프롬프트

get_config

계약 주소, 체인 ID, 기능, 수수료 일정

"내 에이전트가 사용하는 계약 주소는?"

ping

상태 확인 + 속도 제한 할당량 + 에이전트 수수료 등급 (할당량 비용 없음)

"내 상태는 건강하고 속도 제한은?"

get_audit_log

에이전트 감사 로그 읽기 (90일 보존)

"지난 24시간의 감사 이벤트 보여줘"

웹훅

도구

설명

예시 프롬프트

create_webhook

에이전트 이벤트 POST용 HTTPS 엔드포인트 등록 (HMAC 비밀 키 한 번 반환)

"웹훅 https://example.com/hook 등록"

list_webhooks

등록된 웹훅 목록 및 전달 상태 확인

"내 웹훅과 실패 횟수를 보여줘"

delete_webhook

ID로 웹훅 비활성화

"웹훅 삭제"

시장 생성 모드

FlipCoin은 시장 생성을 위한 두 가지 모드를 지원합니다:

자율 모드 (MCP에 권장)

API가 세션 키를 사용하여 트랜잭션을 자동으로 서명하고 제출합니다. API 호출 한 번 = 온체인 시장.

필요 조건: 세션 키 설정 + 볼트 입금 (아래 거래 설정 참조).

이것이 create_market 도구의 기본 모드입니다 (auto_sign: true).

수동 모드

API가 EIP-712 유형 데이터를 반환하며 지갑 소유자가 수동으로 서명합니다. 대화형 지갑 서명이 필요하므로 MCP에는 실용적이지 않습니다.

수동 모드를 사용하려면 create_market 도구에서 auto_sign: false로 설정하세요 — 응답에는 소유자가 서명하고 별도로 릴레이할 typedData가 포함됩니다.

거래 설정

자율 모드에서 trade 및 create_market을 사용하려면 지갑에서 다음 일회성 단계를 완료하세요:

1. 볼트에 USDC 입금

지갑의 USDC 잔액은 FlipCoin 볼트와 별개입니다. 자금을 명시적으로 입금해야 합니다:

  • flipcoin.fun/agents 또는 flipcoin.fun/settings로 이동

  • "Add Funds" 클릭 — USDC 승인 + 입금을 한 번에 처리

  • 최소 입금액은 유동성 등급에 따라 다름:

    • trial: $0 (일회성 테스트 시장, 제한된 기능)

    • low: $35

    • medium: $139

    • high: $693

2. Autopilot 활성화 (세션 키 + 위임)

세션 키를 사용하면 MCP 서버가 일일 지출 한도 내에서 대신 트랜잭션에 서명할 수 있습니다:

  • flipcoin.fun/agents로 이동

  • 에이전트 선택

  • Autopilot 활성화 — 세션 키를 생성하고 DelegationRegistry.setDelegation()을 통해 온체인 위임을 등록

  • 필요에 따라 일일 USDC 한도 및 만료일 설정

이 단계가 없으면 auto_sign: true는 DELEGATION_NOT_CONFIRMED로 실패합니다.

3. 주식 토큰 승인 (판매 전용)

주식을 판매하려면 거래 계약을 한 번 승인하세요:

  • LMSR 판매: ShareToken.setApprovalForAll(backstopRouter, true)

  • CLOB 판매: ShareToken.setApprovalForAll(exchange, true)

계약 주소는 GET /api/agent/config에서 확인할 수 있습니다. 승인이 없으면 오류 응답에 호출할 정확한 계약 및 함수가 포함됩니다.

작동 방식

이 MCP 서버는 FlipCoin Agent API를 래핑합니다. Claude가 도구를 호출하면 API 키를 사용하여 HTTP 요청을 API에 보냅니다.

Claude → MCP Server → FlipCoin Agent API → Base blockchain

거래 흐름 (trade 도구): 의도 → 릴레이 패턴 사용:

  1. POST /trade/intent — 서버가 견적을 계산하고 EIP-712 유형 데이터를 구축

  2. POST /trade/relay — 서버가 세션 키(auto_sign)로 서명하고 온체인에 제출

  3. 트랜잭션 해시 및 거래 세부 정보 반환

인텐트는 15초 후에 만료되므로 두 단계 모두 하나의 도구 호출에서 원자적으로 발생합니다. 인텐트 생성 후 릴레이가 실패하면 오류에 디버깅용 인텐트 ID가 포함됩니다. 인텐트는 안전하게 만료되며 자금 손실 위험이 없습니다.

환경 변수

변수

필수

설명

FLIPCOIN_API_KEY

예

본인의 FlipCoin 에이전트 API 키 (fc_...)

FLIPCOIN_BASE_URL

아니요

API 기본 URL (기본값: https://www.flipcoin.fun/api)

PORT

아니요

HTTP 포트. 설정 시 stdio 대신 HTTP 서버로 시작됨

REQUIRE_AUTH

아니요

true로 설정 시 HTTP 엔드포인트에 Authorization: Bearer 헤더 요구

소스에서 실행

git clone https://github.com/flipcoin-fun/flipcoin-mcp.git
cd flipcoin-mcp
npm install
npm run build
export FLIPCOIN_API_KEY=fc_your_api_key_here
npm start

호스팅 / 원격 설정

로컬 stdio 하위 프로세스 대신 호스팅된 HTTP 엔드포인트로 MCP 서버를 실행합니다.

Docker

docker build -t flipcoin-mcp .
docker run -p 3000:3000 \
  -e FLIPCOIN_API_KEY=fc_your_key \
  -e PORT=3000 \
  -e REQUIRE_AUTH=true \
  flipcoin-mcp

Claude Desktop (StreamableHTTP를 통한 원격)

{
  "mcpServers": {
    "flipcoin": {
      "type": "streamable-http",
      "url": "https://your-server.com/mcp"
    }
  }
}

Claude Desktop (레거시 SSE를 통한 원격)

{
  "mcpServers": {
    "flipcoin": {
      "type": "sse",
      "url": "https://your-server.com/sse"
    }
  }
}

엔드포인트

엔드포인트

메서드

설명

/mcp

POST/GET/DELETE

StreamableHTTP 전송 (권장)

/sse

GET

레거시 SSE 전송

/messages

POST

SSE 메시지 엔드포인트

/health

GET

상태 확인

리소스

라이선스

MIT

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Polymarket MCP Server

    aryankeluskar
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.
    15
    10
    MIT

  • Polymarket MCP Server

    rafael-pina
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.
    15
    5
    MIT

  • MCP Predictive Market

    EricGrill
    A
    license
    A
    quality
    F
    maintenance
    Aggregates prediction market data from 5 major platforms (Manifold, Polymarket, Metaculus, PredictIt, Kalshi), enabling users to search markets, compare odds across platforms, detect arbitrage opportunities, and track predictions through natural language.
    8
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • simplefunctions

    Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.

  • CoinRithm Agent Trading

    Keyless prediction-market data across 12 venues plus paper-trading of crypto spot, futures, and PM.

  • Foresea Forecasting

    Forecast future events and scan prediction-market edges.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/flipcoin-fun/flipcoin-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server