Changelog
Každá zmena servera MCP na /mcp – nástroje, vstupy, výsledky, kľúče a limity – od najnovšej. Čo sa považuje za nekompatibilnú zmenu, stanovujú jeho zásady.
Odpoveď 401 z /mcp teraz nesie WWW-Authenticate: ApiKey realm="mcp" namiesto Bearer realm="mcp", error="invalid_token", kvôli čomu niektorí klienti hľadali server OAuth. Kľúče sa stále prijímajú ako Authorization: Bearer alebo X-API-Key.
Úspešné volania nástrojov vracajú structuredContent vedľa nezmeneného textu JSON a tools/list zverejňuje outputSchema pre každý nástroj, ktorého odpoveď je zdokumentovaná v kontrakte OpenAPI. Chyby zostávajú obyčajným textom isError.
tools/list vracal 15 nástrojov na stránku s nextCursor, takže klienti, ktorí kurzor ignorujú, nikdy nevideli get_coin_markets, get_coin_technicals, get_liquidations_summary ani calculate_dca. Všetkých 19 nástrojov teraz prichádza na jednej stránke.
get_exchange a get_exchange_trust_score od spustenia vracali pri každej burze internú chybu. Oba teraz odpovedajú; vstupy a polia výsledkov zostávajú bez zmeny.
Od 6. septembra vypnutý nástroj odpovedal server_error (HTTP 500). Teraz opäť vracia endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable.
days sa uvádzal s predvolenou a minimálnou hodnotou 0, ale hodnota 0 bola vždy odmietnutá. Teraz je to 1-365 bez predvolenej hodnoty; ak chcete aktuálnu hodnotu, parameter vynechajte. Popis get_global_history teraz uvádza tvar bodu ({time, marketcap} alebo {time, volume}).
Nový neautentifikovaný /.well-known/mcp/server-card.json so serverInfo a úplnými definíciami nástrojov, uložený vo vyrovnávacej pamäti na hodinu, pre registre, ktoré nedokážu preskenovať server vyžadujúci kľúč. Tento súbor aj /.well-known/mcp.json sa teraz dajú čítať cross-origin.
/mcp teraz prijíma kľúč MCP aj ako X-API-Key: YOUR_API_KEY, pre klientov a brány, ktoré si hlavičku Authorization vyhradzujú na vlastné prihlasovanie. Keď sa táto hlavička odošle, kontroluje sa iba kľúč v nej a vložená predpona Bearer sa toleruje.
Neúspešná autentifikácia bola predtým obmedzená na 30 pokusov za minútu na IP adresu, po ktorých bol odmietnutý každý kľúč za touto IP adresou. Teraz môže jeden kľúč zlyhať 30-krát za minútu z jednej IP adresy a jedna IP adresa 300-krát a kľúče, ktoré sa úspešne autentifikovali približne za posledných 15 minút, limit pre IP adresu neblokuje.
get_fear_greed (hlavná hodnota aj každý interval) a get_global_market (fear_greed) teraz obsahujú index – index 0-100 zobrazovaný na Bitculator – vedľa surového score a popisy nástrojov hovoria modelu, aby uvádzal index.
get_coin vracal plne zriedené ocenenie 0 pri kryptomenách bez obmedzenej maximálnej ponuky. Teraz sa použije celková ponuka a hodnota je null, ak nie je známa ani jedna.
get_top_movers teraz zoraďuje podľa samotnej zmeny (predtým fakticky podľa trhovej kapitalizácie) a medzi jeho stratovými kryptomenami sa nezobrazujú tie, ktoré stoja na 0,00. get_prices so symbols vracia jednu kryptomenu na symbol, a to najvyššie umiestnenú aktívnu, a get_global_market hlási dominanciu BTC a ETH ako null namiesto 0, keď trhová kapitalizácia chýba.
Inštrukcie initialize teraz uvádzajú, že trhové kapitalizácie a objemy sú čísla JSON (predtým uvádzali desatinné reťazce), popis sort pri list_exchanges uvádza skutočnú predvolenú hodnotu -volume a get_exchange_trust_score upozorňuje, že burza bez poradia má skóre a rozpis null.
Server je uvedený v /apis.json a /.well-known/api-catalog, /.well-known/mcp.json získal odkazy status a changelog a /status.json hlási komponent mcp.
Nekompatibilná zmena: /mcp prijíma iba kľúče vytvorené v konzole MCP; kľúče Data API a widgetov dostanú 401. MCP má vlastné plány Free (2 500 volaní nástrojov mesačne), Starter (50 000) a Pro (250 000) s 2, 5 a 10 slotmi na kľúče, vlastnú fakturáciu a vlastné obmedzenia jednotlivých nástrojov podľa plánu a každý účet začína na Free. Chyby kvóty a plánu teraz uvádzajú plán MCP.
Každá požiadavka JSON-RPC na /mcp – initialize, tools/list, ping aj volania nástrojov – sa teraz započítava do nárazového limitu plánu 30, 60 alebo 120 za minútu a jeho prekročenie vracia HTTP 429. Do mesačnej kvóty sa počítajú iba volania nástrojov.
Serverové chyby nástrojov obsahovali internú chybovú správu. Teraz znejú server_error (HTTP 500): Internal server error.
Od spustenia až do tejto opravy vracalo každé volanie nástroja v produkcii server_error, pretože server odmietal vlastnú internú dátovú požiadavku ako požiadavku z nedôveryhodného hostiteľa.
/mcp bol spustený cez Streamable HTTP (iba POST) s 19 nástrojmi len na čítanie pre Claude, Cursor, VS Code a ľubovoľného klienta MCP, od search_coins a get_coin po calculate_dca, ktoré vracali tie isté dáta ako REST API. Používal kľúče, plány a kvótu Data API, pričom jedno volanie nástroja sa počítalo ako jedna požiadavka, a opisoval ho /.well-known/mcp.json.
Odstránenie alebo premenovanie nástroja či vstupu oznamujeme tu aspoň šesť mesiacov vopred – pozrite si zásady ukončovania podpory. Karta servera na /.well-known/mcp.json odkazuje na tento changelog.