Dữ liệu crypto trực tiếp cho trợ lý AI của bạn

Máy chủ MCP của Bitculator cung cấp Data API dưới dạng 19 công cụ chỉ đọc được tuyển chọn, qua chuẩn mở Model Context Protocol. Kết nối một lần và trợ lý của bạn sẽ trả lời bằng giá trực tiếp, lịch sử, tâm lý thị trường và thông tin chuyên sâu về sàn giao dịch.

MCP (Model Context Protocol) là chuẩn mở mà các AI client dùng để truy cập công cụ bên ngoài. Bất kỳ client nào hỗ trợ máy chủ từ xa qua Streamable HTTP đều có thể dùng Bitculator — các phần bên dưới đề cập những client phổ biến nhất. Mọi giá, tỷ giá, vốn hóa thị trường và nguồn cung đều được trả về dưới dạng decimal strings để giữ nguyên độ chính xác, giống hệt REST API.

Xác thực

Máy chủ xác thực bằng chính các key của Data API: tạo một key với quyền data-api trong bảng điều khiển nhà phát triển (gói miễn phí dùng được — không cần thẻ) và gửi nó dưới dạng header Bearer trong mọi yêu cầu. Embed key sẽ bị từ chối.

Authorization: Bearer YOUR_API_KEY

Yêu cầu không có key hợp lệ sẽ nhận 401 unauthenticated. Key là bí mật — hãy cấu hình chúng trong phần cài đặt của client hoặc một biến môi trường, đừng bao giờ để trong các tệp dùng chung mà bạn commit.

Claude Code

Một lệnh duy nhất đăng ký máy chủ cho dự án của bạn (hoặc thêm --scope user để dùng được ở mọi nơi). Claude tự động chọn đúng công cụ khi bạn hỏi về thị trường.

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

Cursor

Thêm máy chủ vào ~/.cursor/mcp.json (toàn cục) hoặc .cursor/mcp.json trong một dự án. Các công cụ sẽ xuất hiện trong agent của Cursor ngay khi tệp được lưu.

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

VS Code

Thêm máy chủ vào .vscode/mcp.json trong workspace của bạn. Chế độ agent của GitHub Copilot sẽ tự động liệt kê các công cụ Bitculator.

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

Claude API

Đang xây ứng dụng riêng trên Anthropic API? MCP connector truy cập máy chủ trực tiếp từ một lệnh gọi Messages API — truyền Bitculator key của bạn dưới dạng 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 kết nối với các máy chủ MCP từ xa thông qua chế độ developer:

1. Bật chế độ developer trong phần cài đặt của ChatGPT (Apps & Connectors → Advanced).
2. Thêm một connector với URL máy chủ https://bitculator.com/mcp.
3. Xác thực connector của ChatGPT dựa trên OAuth — header API key chưa được hỗ trợ ở đó, vì vậy hãy dùng một client hỗ trợ kết nối không cần xác thực hoặc các bề mặt Claude để truy cập bằng key.

Luồng OAuth (và cùng với nó là hỗ trợ đầy đủ danh mục ChatGPT + Claude) đã nằm trong lộ trình. Các client dùng key — Claude Code, Cursor, VS Code, Claude API — hoạt động ngay hôm nay.

Hạn ngạch & giới hạn

MCP là một bề mặt tiêu thụ của Data API — không có hóa đơn hay quỹ MCP riêng.

• Mỗi lệnh gọi công cụ được tính là một yêu cầu Data API trừ vào hạn ngạch hàng tháng của gói bạn dùng.
• Giới hạn burst mỗi phút của gói bạn dùng áp dụng cho từng lệnh gọi công cụ (Free 30, Starter 60, Pro 120).
• Khi vượt hạn ngạch, các công cụ trả về lỗi rate_limited cho trợ lý biết khi nào quỹ được đặt lại. Các endpoint bị khóa theo gói trả về plan_required.
• Bắt tay giao thức (initialize, tools/list) là miễn phí — chỉ các lệnh gọi công cụ mới trừ vào quỹ.

Framework cho agent

Bạn đang tự xây dựng agent? Mọi framework lớn đều có sẵn MCP client kết nối qua Streamable HTTP với header Bearer - các đoạn mã bên dưới nạp cả 19 công cụ như hàm gốc.

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)

Tài liệu tham khảo công cụ

Tất cả 19 công cụ đều chỉ đọc. Các tham số phản chiếu đúng các endpoint Data API tương ứng — cùng quy tắc kiểm tra dữ liệu, cùng cổng chặn theo gói, cùng độ chính xác chuỗi thập phân.