변경 이력
/mcp에 있는 MCP 서버의 모든 변경 사항(도구, 입력, 결과, 키, 한도)을 최신순으로 정리했습니다. 무엇이 호환성을 깨는 변경인지는 정책에 나와 있습니다.
/mcp의 401 응답은 이제 Bearer realm="mcp", error="invalid_token" 대신 WWW-Authenticate: ApiKey realm="mcp"를 담습니다. 이전 값 때문에 일부 클라이언트가 OAuth 서버를 찾아 나섰습니다. 키는 여전히 Authorization: Bearer 또는 X-API-Key로 받습니다.
성공한 도구 호출은 변경되지 않은 JSON 텍스트와 함께 structuredContent를 반환하며, tools/list는 응답이 OpenAPI 계약에 문서화된 각 도구에 대해 outputSchema를 공개합니다. 오류는 여전히 단순한 isError 텍스트입니다.
tools/list는 페이지당 도구 15개를 nextCursor와 함께 반환했기 때문에, 커서를 무시하는 클라이언트는 get_coin_markets, get_coin_technicals, get_liquidations_summary, calculate_dca를 볼 수 없었습니다. 이제 19개 도구 전체가 한 페이지로 반환됩니다.
get_exchange와 get_exchange_trust_score는 출시 이후 모든 거래소에 대해 내부 오류를 반환해 왔습니다. 이제 둘 다 응답하며, 입력과 결과 필드는 바뀌지 않았습니다.
9월 6일부터 비활성화된 도구는 server_error (HTTP 500)을 반환했습니다. 이제 다시 endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable.을 반환합니다.
days는 기본값과 최솟값이 0으로 안내되었지만, 0은 항상 거부되었습니다. 이제 범위는 1-365이고 기본값은 없습니다. 현재 값을 조회하려면 생략하세요. get_global_history 설명에는 이제 데이터 포인트 형태({time, marketcap} 또는 {time, volume})가 명시됩니다.
인증이 필요 없는 /.well-known/mcp/server-card.json이 새로 추가되었습니다. serverInfo와 전체 도구 정의를 담고 있으며 1시간 동안 캐시되고, 키가 필요한 서버를 스캔할 수 없는 레지스트리를 위한 것입니다. 이 파일과 /.well-known/mcp.json은 이제 교차 출처로도 읽을 수 있습니다.
/mcp는 이제 Authorization을 자체 로그인 전용으로 사용하는 클라이언트와 게이트웨이를 위해 MCP 키를 X-API-Key: YOUR_API_KEY로도 받습니다. 이 헤더를 보내면 이 헤더의 키만 확인하며, 붙여 넣은 Bearer 접두사도 허용됩니다.
인증 실패는 이전에 IP당 분당 30회로 제한되었고, 이를 넘으면 해당 IP 뒤에 있는 모든 키가 거부되었습니다. 이제 키 하나는 IP 하나에서 분당 30회까지, IP 하나는 300회까지 실패할 수 있으며, 대략 최근 15분 안에 인증에 성공한 키는 IP 한도로 차단되지 않습니다.
get_fear_greed(대표 값과 모든 구간)와 get_global_market(fear_greed)에 이제 원시 score와 함께 Bitculator에 표시되는 0-100 지수인 index가 포함되며, 도구 설명은 모델에게 index를 인용하라고 안내합니다.
get_coin은 최대 공급량 상한이 없는 코인에 대해 완전 희석 가치를 0으로 반환했습니다. 이제 총 공급량으로 대체하며, 둘 다 알 수 없으면 null입니다.
get_top_movers는 이제 변동률 자체를 기준으로 순위를 매기며(이전에는 사실상 시가총액 기준이었습니다), 하락 종목에서는 0.00으로 보합인 코인을 제외합니다. symbols를 지정한 get_prices는 심볼당 코인 하나, 즉 순위가 가장 높은 활성 코인을 반환하며, get_global_market은 시가총액이 없을 때 BTC와 ETH 도미넌스를 0이 아닌 null로 보고합니다.
initialize 안내문은 이제 시가총액과 거래량이 JSON 숫자라고 설명하고(이전에는 소수 문자열이라고 했습니다), list_exchanges의 sort 설명은 실제 기본값인 -volume을 제시하며, get_exchange_trust_score는 순위가 없는 거래소의 점수와 세부 내역이 null이라고 명시합니다.
서버가 /apis.json과 /.well-known/api-catalog에 등재되었고, /.well-known/mcp.json에는 status 및 changelog 링크가 추가되었으며, /status.json은 mcp 구성 요소를 보고합니다.
호환성을 깨는 변경: /mcp는 MCP 콘솔에서 만든 키만 받으며, Data API 키와 위젯 키에는 401이 반환됩니다. MCP는 자체 Free(월 2,500회 도구 호출), Starter(50,000회), Pro(250,000회) 요금제와 각각 2개, 5개, 10개의 키 슬롯, 자체 결제, 도구별 자체 요금제 게이트를 가지며, 모든 계정은 Free에서 시작합니다. 쿼터 오류와 요금제 오류에는 이제 MCP 요금제가 명시됩니다.
/mcp에 보내는 모든 JSON-RPC 요청(initialize, tools/list, ping, 도구 호출)이 이제 요금제의 분당 30, 60, 120회 버스트 한도에 포함되며, 이를 넘으면 HTTP 429가 반환됩니다. 월간 쿼터에 집계되는 것은 도구 호출뿐입니다.
도구의 서버 오류에는 내부 오류 메시지가 포함되어 있었습니다. 이제는 server_error (HTTP 500): Internal server error.로 표시됩니다.
출시부터 이 수정이 이루어지기 전까지 프로덕션의 모든 도구 호출은 server_error를 반환했습니다. 서버가 자체 내부 데이터 요청을 신뢰할 수 없는 호스트에서 온 것으로 판단해 거부했기 때문입니다.
/mcp가 Streamable HTTP(POST 전용)로 가동을 시작해, Claude, Cursor, VS Code를 비롯한 모든 MCP 클라이언트에 search_coins와 get_coin부터 calculate_dca까지 읽기 전용 도구 19개를 제공하고, REST API와 같은 데이터를 반환했습니다. Data API 키, 요금제, 쿼터를 사용했으며, 도구 호출 1회가 요청 1건으로 집계되었고, /.well-known/mcp.json이 서버를 설명했습니다.
도구나 입력의 제거 또는 이름 변경은 최소 6개월 전에 이곳에 공지됩니다 - 지원 종료 정책을 참고하세요. /.well-known/mcp.json의 서버 카드는 이 변경 이력으로 연결됩니다.