Változásnapló
A /mcp címen elérhető MCP-szerver minden változása – eszközök, bemenetek, eredmények, kulcsok és korlátok –, a legújabbal kezdve. Azt, hogy mi számít kompatibilitástörő változásnak, a szabályzatai rögzítik.
A /mcp 401 válasza mostantól a WWW-Authenticate: ApiKey realm="mcp" fejlécet tartalmazza a Bearer realm="mcp", error="invalid_token" helyett, amely miatt egyes kliensek OAuth-szervert kezdtek keresni. A kulcsokat továbbra is Authorization: Bearer vagy X-API-Key fejlécben fogadjuk el.
A sikeres eszközhívások a változatlan JSON-szöveg mellett structuredContent mezőt is visszaadnak, a tools/list pedig outputSchema sémát tesz közzé minden olyan eszközhöz, amelynek válasza dokumentálva van az OpenAPI-szerződésben. A hibák továbbra is egyszerű isError szövegek.
A tools/list oldalanként 15 eszközt adott vissza egy nextCursor értékkel, így a kurzort figyelmen kívül hagyó kliensek soha nem látták a get_coin_markets, a get_coin_technicals, a get_liquidations_summary és a calculate_dca eszközt. Mostantól mind a 19 eszköz egyetlen oldalon érkezik.
A get_exchange és a get_exchange_trust_score az indulás óta minden tőzsdénél belső hibát adott vissza. Most már mindkettő válaszol; a bemenetek és az eredménymezők nem változtak.
Szeptember 6. óta a kikapcsolt eszköz server_error (HTTP 500) választ adott. Mostantól ismét az endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable. választ adja.
A days paramétert 0 alapértékkel és 0 minimummal hirdettük, de a 0 értéket az eszköz mindig elutasította. Mostantól 1–365 közötti, alapérték nélkül; az aktuális értékhez hagyd el. A get_global_history leírása mostantól megadja a pontok szerkezetét ({time, marketcap} vagy {time, volume}).
Új, hitelesítés nélkül elérhető /.well-known/mcp/server-card.json a serverInfo adatokkal és a teljes eszközdefiníciókkal, egy órára gyorsítótárazva, azoknak a jegyzékeknek, amelyek nem tudnak kulcsos szervert átvizsgálni. Ez és a /.well-known/mcp.json mostantól más originről is olvasható.
A /mcp mostantól X-API-Key: YOUR_API_KEY fejlécként is elfogadja az MCP-kulcsot azon kliensek és átjárók kedvéért, amelyek az Authorization fejlécet a saját bejelentkezésükhöz foglalják le. Ha ez a fejléc meg van adva, csak az abban szereplő kulcsot ellenőrizzük, és a bemásolt Bearer előtagot is eltűrjük.
A sikertelen hitelesítési kísérleteket korábban IP-címenként percenként 30-ra korlátoztuk, ezután az adott IP-cím mögötti minden kulcsot elutasítottunk. Mostantól egy kulcs egy IP-címről percenként 30-szor, egy IP-cím pedig 300-szor hiúsulhat meg, és a nagyjából az elmúlt 15 percben sikeresen hitelesített kulcsokat nem blokkolja az IP-korlát.
A get_fear_greed (a fő érték és minden intervallum) és a get_global_market (fear_greed) mostantól a nyers score mellett az index mezőt is tartalmazza – a Bitculatoron megjelenített 0–100-as indexet –, az eszközleírások pedig arra utasítják a modellt, hogy az index értéket idézze.
A get_coin 0 teljesen hígított értékelést adott vissza azoknál az érméknél, amelyeknek nincs korlátozott maximális kínálata. Mostantól ilyenkor a teljes kínálatot használja, és null, ha egyik sem ismert.
A get_top_movers mostantól magára a változásra rendez (korábban gyakorlatilag piaci kapitalizációra), a vesztesek közül pedig kimaradnak a 0,00 értéken álló érmék. A symbols paraméterrel hívott get_prices szimbólumonként egy érmét ad vissza, a legmagasabban rangsorolt aktívat, a get_global_market pedig a BTC- és ETH-dominanciát 0 helyett null értékkel adja vissza, ha nincs piaci kapitalizáció.
Az initialize utasításai mostantól azt írják, hogy a piaci kapitalizáció és a forgalom JSON-szám (korábban decimális sztringet írtak), a list_exchanges sort leírása a valódi -volume alapértéket adja meg, a get_exchange_trust_score pedig jelzi, hogy a rangsorolatlan tőzsde pontszáma és lebontása null.
A szerver szerepel a /apis.json és a /.well-known/api-catalog dokumentumban, a /.well-known/mcp.json status és changelog linkeket kapott, a /status.json pedig egy mcp komponenst is jelent.
Kompatibilitástörő változás: a /mcp csak az MCP-konzolban létrehozott kulcsokat fogadja el; a Data API- és widgetkulcsok 401 választ kapnak. Az MCP-nek saját Free (havi 2500 eszközhívás), Starter (50 000) és Pro (250 000) csomagja van 2, 5, illetve 10 kulcshellyel, saját számlázással és saját eszközönkénti csomagkorlátokkal, és minden fiók a Free csomaggal indul. A kvóta- és csomaghibák mostantól az MCP-csomagot nevezik meg.
A /mcp felé irányuló minden JSON-RPC-kérés – initialize, tools/list, ping és az eszközhívások – mostantól beleszámít a csomag percenként 30, 60 vagy 120 kéréses löketkorlátjába, a túllépés pedig HTTP 429 választ ad. A havi kvótába csak az eszközhívások számítanak bele.
Az eszközök szerverhibái tartalmazták a belső hibaüzenetet. Mostantól így szólnak: server_error (HTTP 500): Internal server error.
Az indulástól e javításig éles környezetben minden eszközhívás server_error választ adott, mert a szerver a saját belső adatkérését nem megbízható hosztról érkezőként utasította el.
A /mcp Streamable HTTP felett (csak POST) indult el 19 csak olvasható eszközzel a Claude, a Cursor, a VS Code és bármely MCP-kliens számára, a search_coins és a get_coin eszköztől a calculate_dca eszközig, ugyanazokat az adatokat visszaadva, mint a REST API. Data API-kulcsokat, -csomagokat és -kvótát használt, egy eszközhívás egy kérésnek számított, és a /.well-known/mcp.json írta le.
Egy eszköz vagy bemenet eltávolítását vagy átnevezését itt, legalább hat hónappal előre jelentjük be – lásd a megszüntetési szabályzatot. A /.well-known/mcp.json címen elérhető szerverkártya erre a változásnaplóra hivatkozik.