AI 어시스턴트를 위한 실시간 크립토 데이터

Bitculator MCP 서버는 개방형 Model Context Protocol을 통해 크립토 시장을 엄선된 읽기 전용 도구 19개로 제공합니다. 한 번만 연결하면 어시스턴트가 실시간 가격, 이력, 센티먼트, 거래소 정보를 바탕으로 답변합니다.

MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구에 접근할 때 사용하는 개방형 표준입니다. Streamable HTTP로 원격 서버를 지원하는 클라이언트라면 모두 Bitculator를 사용할 수 있으며, 아래 섹션에서는 대표적인 클라이언트를 다룹니다. MCP는 독립된 제품입니다. 자체 요금제으로 과금되고, 키도 월간 도구 호출 할당량도 별도로 운영됩니다. 모든 가격과 환율, 공급량은 REST API와 똑같이 정밀도를 보존하기 위해 decimal strings(소수 문자열)로 반환됩니다. 시가총액과 거래량은 일반 JSON 숫자입니다.

인증

서버는 MCP 키로 인증합니다. mcp 권한을 가진 키를 MCP 콘솔에서 생성하고(무료 MCP 요금제으로도 가능하며 카드는 필요 없습니다) 모든 요청에 Bearer 헤더로 전달하세요. Data API 키와 위젯 키는 401 unauthenticated로 거부됩니다.

Authorization: Bearer YOUR_API_KEY

Smithery처럼 Authorization 헤더를 자체 로그인 전용으로 사용하는 클라이언트나 게이트웨이는 같은 키를 대신 X-API-Key: YOUR_API_KEY 헤더로 전달할 수 있습니다.

유효한 키가 없는 요청에는 401 unauthenticated 응답이 반환됩니다. 키는 비밀 정보이므로 클라이언트 설정이나 환경 변수에 보관하고, 커밋하는 공유 파일에는 절대 넣지 마세요.

Claude Code

명령어 하나로 프로젝트에 서버를 등록합니다(어디서나 사용하려면 --scope user 옵션을 추가하세요). 시장에 대해 질문하면 Claude가 알맞은 도구를 자동으로 선택합니다.

claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

Cursor

서버를 ~/.cursor/mcp.json(전역) 또는 프로젝트의 .cursor/mcp.json에 추가하세요. 파일을 저장하면 Cursor 에이전트에 도구가 나타납니다.

{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

워크스페이스의 .vscode/mcp.json에 서버를 추가하세요. GitHub Copilot 에이전트 모드가 Bitculator 도구를 자동으로 목록에 표시합니다.

{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude API

Anthropic API로 직접 앱을 만드시나요? MCP 커넥터는 Messages API 호출에서 서버에 바로 접근합니다. Bitculator MCP 키를 authorization_token 값으로 전달하세요.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

ChatGPT

ChatGPT는 개발자 모드를 통해 원격 MCP 서버에 연결합니다:

1. ChatGPT 설정에서 개발자 모드를 활성화하세요(Apps & Connectors → Advanced).
2. https://bitculator.com/mcp 주소를 서버 URL로 지정해 커넥터를 추가하세요.
3. ChatGPT의 커넥터 인증은 OAuth 기반이며 아직 API 키 헤더를 지원하지 않습니다. 따라서 인증 없이 동작하는 클라이언트를 사용하거나, 키 기반으로 접근하려면 Claude 제품군을 이용하세요.

OAuth 플로우(그리고 이를 통한 ChatGPT 및 Claude 디렉터리 완전 지원)는 로드맵에 있습니다. 키 기반 클라이언트인 Claude Code, Cursor, VS Code, Claude API는 지금 바로 사용할 수 있습니다.

쿼터 및 제한

MCP는 자체 요금제과 자체 월간 할당량, 자체 키 슬롯을 갖춘 독립 제품입니다. Data API나 위젯 쿼터는 전혀 차감하지 않습니다.

• 도구 호출은 모두 MCP 요금제의 월간 할당량에서 1회를 차감합니다(Free 2,500회, Starter 50,000회, Pro 250,000회).
• MCP 요금제의 분당 버스트 한도(Free 30, Starter 60, Pro 120)는 도구 호출에만 적용되는 것이 아니라 엔드포인트 전체에 적용됩니다. initialize, notifications/initialized, tools/list, resources/*, prompts/*, ping 모두 각각 슬롯 하나를 차지합니다. 도구 호출의 비용은 여전히 정확히 1회입니다. 호출이 내부적으로 보내는 Data API 요청은 자체 버스트 한도에서 제외됩니다.
• 할당량을 초과하면 도구가 rate_limited 오류를 반환하며, 이 오류에는 기간이 초기화되는 시점이 담겨 어시스턴트에 전달됩니다. 상위 등급에서만 제공되는 도구는 plan_required 오류를 반환합니다.
• 핸드셰이크와 디스커버리 호출은 월간 할당량을 전혀 차감하지 않습니다. 할당량을 차감하는 것은 도구 호출뿐입니다. 다만 버스트 슬롯은 소모합니다. 버스트 거부는 JSON-RPC 요청 자체에 대한 HTTP 429이므로, 클라이언트는 도구 오류가 아니라 전송 오류로 보고합니다.

에이전트 프레임워크

직접 에이전트를 만드시나요? 주요 프레임워크는 모두 Bearer MCP 키로 Streamable HTTP에 연결하는 MCP 클라이언트를 제공합니다. 아래 예제 코드는 19개 도구를 네이티브 함수로 모두 불러옵니다.

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

도구 레퍼런스

19개 도구는 모두 읽기 전용입니다. 파라미터는 대응하는 Data API 엔드포인트와 동일하며 검증 방식과 소수 문자열 정밀도도 같습니다. 다만 각 도구의 요금제 게이트는 MCP 요금제을 기준으로 적용됩니다.