Nhật ký thay đổi
Mọi thay đổi đối với máy chủ MCP tại /mcp - công cụ, đầu vào, kết quả, key và giới hạn - mới nhất trước. Điều gì được tính là thay đổi phá vỡ tương thích được nêu trong chính sách của máy chủ.
Phản hồi 401 từ /mcp nay mang WWW-Authenticate: ApiKey realm="mcp" thay vì Bearer realm="mcp", error="invalid_token", vốn khiến một số client đi tìm máy chủ OAuth. Key vẫn được chấp nhận dưới dạng Authorization: Bearer hoặc X-API-Key.
Các lệnh gọi công cụ thành công trả về structuredContent bên cạnh văn bản JSON không đổi, và tools/list công bố một outputSchema cho mỗi công cụ có phản hồi được mô tả trong hợp đồng OpenAPI. Lỗi vẫn là văn bản isError thuần.
tools/list từng trả về 15 công cụ mỗi trang kèm nextCursor, nên các client bỏ qua con trỏ không bao giờ thấy get_coin_markets, get_coin_technicals, get_liquidations_summary hay calculate_dca. Giờ đây cả 19 công cụ đều nằm trên một trang.
get_exchange và get_exchange_trust_score đã trả về lỗi nội bộ cho mọi sàn giao dịch kể từ khi ra mắt. Giờ đây cả hai đều phản hồi; đầu vào và các trường kết quả không đổi.
Từ ngày 6 tháng 9, công cụ bị tắt trả lời server_error (HTTP 500). Giờ đây nó lại trả về endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable. như trước.
days từng được mô tả với giá trị mặc định và tối thiểu là 0, nhưng 0 luôn bị từ chối. Giờ đây nó là 1-365 và không có giá trị mặc định; hãy bỏ qua tham số này để lấy giá trị hiện tại. Mô tả của get_global_history nay nêu rõ cấu trúc điểm dữ liệu ({time, marketcap} hoặc {time, volume}).
Mới: /.well-known/mcp/server-card.json không cần xác thực, chứa serverInfo và đầy đủ định nghĩa công cụ, được lưu đệm một giờ, dành cho các registry không thể quét một máy chủ yêu cầu key. Tệp này và /.well-known/mcp.json nay có thể được đọc cross-origin.
/mcp nay cũng chấp nhận MCP key dưới dạng X-API-Key: YOUR_API_KEY, dành cho các client và gateway dành riêng Authorization cho việc đăng nhập của chính chúng. Khi header đó được gửi, đó là key duy nhất được kiểm tra, và tiền tố Bearer bị dán kèm vẫn được chấp nhận.
Trước đây, xác thực thất bại bị giới hạn ở 30 lần mỗi phút cho mỗi IP, sau đó mọi key phía sau IP đó đều bị từ chối. Giờ đây một key có thể thất bại 30 lần mỗi phút từ một IP và một IP có thể thất bại 300 lần, và các key đã xác thực trong khoảng 15 phút gần nhất không bị giới hạn IP chặn.
get_fear_greed (giá trị chính và mọi khoảng thời gian) và get_global_market (fear_greed) nay có thêm index - chỉ số 0-100 hiển thị trên Bitculator - bên cạnh score thô, và mô tả công cụ yêu cầu mô hình trích dẫn index.
get_coin từng trả về định giá pha loãng hoàn toàn là 0 cho các coin không có nguồn cung tối đa giới hạn. Giờ đây nó dùng tổng cung thay thế và là null khi không biết cả hai.
get_top_movers nay xếp hạng theo chính mức thay đổi (trước đây thực chất theo vốn hóa thị trường) và danh sách giảm giá của nó loại trừ các coin đứng yên ở 0,00. get_prices với symbols trả về một coin cho mỗi ký hiệu, là coin đang hoạt động có thứ hạng cao nhất, và get_global_market báo tỷ lệ thống trị của BTC và ETH là null thay vì 0 khi không có vốn hóa thị trường.
Hướng dẫn initialize nay cho biết vốn hóa thị trường và khối lượng là số JSON (trước đây ghi là chuỗi thập phân), mô tả sort của list_exchanges nêu đúng giá trị mặc định thực tế -volume, và get_exchange_trust_score ghi chú rằng sàn giao dịch chưa xếp hạng có điểm và bảng phân tích là null.
Máy chủ được liệt kê trong /apis.json và /.well-known/api-catalog, /.well-known/mcp.json có thêm liên kết status và changelog, và /status.json báo cáo thành phần mcp.
Phá vỡ tương thích: /mcp chỉ chấp nhận key được tạo trong bảng điều khiển MCP; Data API key và widget key nhận 401. MCP có các gói Free (2.500 lệnh gọi công cụ mỗi tháng), Starter (50.000) và Pro (250.000) riêng với 2, 5 và 10 suất key, hệ thống thanh toán riêng và giới hạn gói riêng cho từng công cụ, và mọi tài khoản bắt đầu ở gói Free. Lỗi hạn ngạch và lỗi gói nay nêu tên gói MCP.
Mọi request JSON-RPC tới /mcp - initialize, tools/list, ping và lệnh gọi công cụ - nay được tính vào giới hạn burst của gói là 30, 60 hoặc 120 mỗi phút, và vượt quá sẽ trả về HTTP 429. Chỉ lệnh gọi công cụ được tính vào hạn ngạch hàng tháng.
Lỗi máy chủ của công cụ từng kèm thông báo lỗi nội bộ. Giờ đây chúng có nội dung server_error (HTTP 500): Internal server error.
Từ khi ra mắt cho đến bản sửa này, mọi lệnh gọi công cụ trên production đều trả về server_error, vì máy chủ từ chối chính request dữ liệu nội bộ của nó như thể đến từ một host không đáng tin cậy.
/mcp đi vào hoạt động qua Streamable HTTP (chỉ POST) với 19 công cụ chỉ đọc cho Claude, Cursor, VS Code và bất kỳ MCP client nào, từ search_coins và get_coin đến calculate_dca, trả về cùng dữ liệu như REST API. Máy chủ dùng key, gói và hạn ngạch của Data API, mỗi lệnh gọi công cụ được tính là một request, và /.well-known/mcp.json mô tả máy chủ.
Việc gỡ bỏ hoặc đổi tên một công cụ hay một đầu vào được công bố tại đây ít nhất sáu tháng trước - xem chính sách ngừng hỗ trợ. Server card tại /.well-known/mcp.json liên kết tới nhật ký thay đổi này.