Przejdź do treści

Praktyczne zastosowania

ToolRouter: ile tokenów oszczędza agentowi brama narzędzi AI?

Zaktualizowano: Autor: Andrzej Niemiec7 min czytania

ToolRouter udostępnia narzędzia AI przez MCP, CLI i REST, a agent odkrywa je na żądanie. Producent podaje około 9 000 tokenów powierzchni routingu wobec…

ToolRouter: ile tokenów oszczędza agentowi brama narzędzi AI?
Spis treści
  1. Czym jest ToolRouter?
  2. Ile tokenów zajmują schematy narzędzi w kontekście agenta?
  3. Jak działa odkrywanie narzędzi na żądanie?
  4. ToolRouter, lokalny router czy pełny katalog w prompcie?
  5. Kiedy routing narzędzi się opłaca, a kiedy to zbędna warstwa?
  6. Jakie ryzyko wiąże się z pośrednikiem wykonującym narzędzia?
  7. Najczęstsze pytania
  8. Źródła

Czym jest ToolRouter?

ToolRouter to zunifikowana brama i marketplace narzędzi AI. Normalizuje uwierzytelnianie, billing i format odpowiedzi, a agent korzysta z niego przez MCP, CLI, REST API lub interfejs webowy [1][2].

Oficjalny zdalny endpoint MCP działa pod adresem https://api.toolrouter.com/mcp, a obok niego dostępny jest lokalny mostek toolrouter-mcp [3]. Mostek pełni rolę klienta: wywołania przechodzą przez infrastrukturę ToolRouter i nie wykonują się na maszynie użytkownika [3]. To warstwa pośrednia między modelem a dostawcami narzędzi, a nie model ani framework agentowy. Sposób, w jaki agenci AI i automatyzacja dobierają narzędzia do zadania, opisujemy w hubie tematycznym.

Skala katalogu zależy od daty i definicji. Materiały producenta podają kolejno „220+”, „225+” i „250+” narzędzi, katalog MCPMarket wymienia 226 narzędzi oraz 1208 umiejętności, a repozytorium pluginu mówi o 254 hostowanych narzędziach rozliczanych za wywołanie [1][4][5]. Narzędzie i umiejętność to nie ten sam obiekt, więc te liczby nie są wymienne.

Ile tokenów zajmują schematy narzędzi w kontekście agenta?

Publiczne materiały ToolRouter podają około 257 000 tokenów przy załadowaniu całego katalogu umiejętności i około 9 000 tokenów dla kompaktowej powierzchni routingu. Pomiar datowano na 3 września 2026 r. [3]

Przy podejściu statycznym schematy narzędzi są częścią promptu w każdej turze rozmowy. W dyskusji deweloperskiej opisano agenta MCP, który wysyła około 7000 tokenów samych schematów przy każdym obrocie [6]. Ten narzut sumuje się szybciej niż treść zadania, bo rośnie z liczbą tur, a nie z liczbą pytań. Koszt bywa większy niż sam wybór narzędzia, o czym piszemy w tekście o architekturze multi-agent, która kosztuje 5000 PLN miesięcznie na tokenach.

Liczby zależą od tokenizera, formatu serializacji i wersji katalogu. Szacunek polegający na podzieleniu liczby znaków przez cztery nie zastępuje tokenizera konkretnego modelu [3]. Pomiar warto więc powtarzać na własnym zestawie narzędzi, a nie przenosić cudzego wyniku do swojego systemu. Przegląd siedmiu technik ograniczania kosztu wywołań narzędzi pokazuje, jak zestawić taki pomiar z realnym rachunkiem [7]. Kontekst doboru narzędzi opisujemy szerzej w hubie agenci AI i automatyzacja.

Jak działa odkrywanie narzędzi na żądanie?

Agent nie musi otrzymywać w kontekście pełnych schematów wszystkich umiejętności. Przez MCP korzysta z meta-narzędzi discover i use_tool, a właściwe narzędzie odkrywa dopiero wtedy, gdy jest potrzebne [3]. Do promptu trafia powierzchnia routingu, nie cały katalog.

Taki układ zmienia kolejność pracy agenta. Najpierw powstaje opis zadania, potem wybór narzędzia, a na końcu wywołanie u dostawcy. Routing dodaje więc jeden etap, którego nie ma przy statycznym ładowaniu schematów. Ten etap jest jednocześnie miejscem, w którym powstają błędy: przy niejasnym opisie zadania discovery może wskazać niewłaściwe narzędzie albo je pominąć [3][8].

ToolRouter, lokalny router czy pełny katalog w prompcie?

KryteriumPełny katalog w prompcieToolRouter (brama hostowana)Lokalny router discovery
Co trafia do kontekstu w każdej turzeSchematy całego kataloguKompaktowa powierzchnia routingu, około 9 000 tokenów według producenta [3]Schematy narzędzi po lokalnym wyszukaniu [8]
Gdzie wykonuje się wywołanie narzędziaU dostawcy, po decyzji agentaW infrastrukturze ToolRouter [3]Zależnie od implementacji, bez pośrednika
RozliczanieOsobne klucze i umowy u każdego dostawcyCzęść bezpłatna, część pay-per-call, część na kredyty lub BYOK [2][3]Koszt własnej infrastruktury
Utrzymanie kataloguRęczna aktualizacja w kodzie agentaPo stronie operatora bramyWłasny proces i własne aktualizacje [8]

Porównanie pokazuje, że wybór nie sprowadza się do liczby tokenów. Brama hostowana przenosi utrzymanie katalogu i rozliczeń na operatora, ale wprowadza pośrednika i zależność od jego cennika. Lokalny router zostawia kontrolę po stronie zespołu i wymaga własnego procesu oraz własnego katalogu. Pełny katalog w prompcie jest najprostszy technicznie i najdroższy w tokenach przy dużej liczbie narzędzi.

Kiedy routing narzędzi się opłaca, a kiedy to zbędna warstwa?

Routing opłaca się wtedy, gdy katalog jest duży i rzadko potrzebny w całości, a koszt tokenów albo czas wyboru narzędzia ma znaczenie. Przy kilkunastu narzędziach stały prompt jest prostszy w utrzymaniu i nie wymaga dodatkowego etapu. Decyzję warto oprzeć na pomiarze recall i opóźnienia na własnym zestawie, nie na ogólnym szacunku [3][7].

Po stronie kosztów dochodzą zależności rozliczeniowe. Część narzędzi w bramie jest bezpłatna, część działa w modelu pay-per-call, a niektóre wymagają kredytów albo własnych kluczy dostawców w modelu BYOK [2][3]. To oznacza, że oszczędność na tokenach nie musi przełożyć się na niższy rachunek: przy dużej liczbie wywołań dominować zaczyna opłata za samo wywołanie. Sensowny punkt wyjścia to porównanie obu pozycji na tym samym zestawie zadań i w tym samym okresie rozliczeniowym [7].

Jakie ryzyko wiąże się z pośrednikiem wykonującym narzędzia?

Pośrednik otrzymuje opisy zadań i wykonuje wywołania wobec zewnętrznych dostawców. Dochodzi więc warstwa, której trzeba zaufać zarówno w zakresie danych wysyłanych w opisie zadania, jak i w zakresie tego, które narzędzie faktycznie zostanie uruchomione. Publiczne routery MCP zalecają testowanie recall i zaznaczają, że szacunki tokenów oparte na znakach dzielonych przez cztery nie zastępują tokenizera modelu [3]. Ryzyko dotyczy też bezpieczeństwa samego pośrednika [7].

Alternatywą jest trzymanie discovery lokalnie. Repozytoria mcp-tool-router i stackline-tool-router opisują lokalne wyszukiwanie narzędzi dla katalogów MCP, OpenAI, Anthropic i Gemini, bez zależności od zdalnej bramy [8][9]. Warto też sprawdzić datę projektu: repozytorium pluginu ToolRouter aktualizowano 4 września 2026 r., a wpis o zdalnym endpointcie dodano do listy serwerów MCP 3 października 2026 r. [5][11]. Szybko zmieniające się repozytorium to argument za wersjonowaniem własnej konfiguracji. O tym, jak agent z dostępem do narzędzi może zostać wykorzystany, piszemy w tekście o agencie, który przelał pieniądze na konto hakera.

Najczęstsze pytania

Czy ToolRouter jest bezpłatny?

Nie ma jednego modelu rozliczeń. Część narzędzi w katalogu jest bezpłatna, część działa w modelu pay-per-call, a niektóre wymagają kredytów albo własnych kluczy dostawców w modelu BYOK [2][3]. Przed wdrożeniem warto sprawdzić cennik konkretnych narzędzi, których agent będzie używał najczęściej, bo to one decydują o rachunku przy dużej liczbie wywołań.

Ile narzędzi udostępnia ToolRouter?

Liczba zależy od daty i definicji. Materiały producenta podają „220+”, „225+” i „250+” narzędzi, katalog MCPMarket wymienia 226 narzędzi oraz 1208 umiejętności, a repozytorium pluginu mówi o 254 hostowanych narzędziach [1][4][5]. Narzędzie i umiejętność to różne obiekty, więc liczb nie należy porównywać bez sprawdzenia, co dokładnie zliczono.

Czy ToolRouter wykonuje narzędzia lokalnie?

Nie. Dokumentacja wskazuje, że wywołania przechodzą przez infrastrukturę ToolRouter, a lokalny pakiet toolrouter-mcp jest mostkiem i klientem, nie lokalnym wykonawcą narzędzi [3]. Kto potrzebuje wykonania po swojej stronie, ten szuka rozwiązań lokalnych, takich jak mcp-tool-router lub stackline-tool-router [8][9].

Jak zmierzyć oszczędność tokenów po wdrożeniu routingu?

Pomiar trzeba wykonać tokenizerem modelu, którego faktycznie używa agent, na własnym zestawie narzędzi i własnych zadaniach. Szacunek przez dzielenie liczby znaków przez cztery nie jest wystarczający [3]. Warto zapisać wersję katalogu i wersję schematów, żeby wynik dało się powtórzyć po aktualizacji narzędzi [7].

Czym różni się ToolRouter od własnego routera narzędzi?

Własny router zostawia kontrolę nad katalogiem, discovery i danymi wysyłanymi do dostawców, ale wymaga utrzymania procesu i aktualizacji. ToolRouter przenosi tę warstwę na operatora i dodaje rozliczanie za wywołanie, a także pośrednika, który przyjmuje opisy zadań [2][3][8].

Źródła

  1. ToolRouter — Give Your AI Superpowers (toolrouter.com, 2026)
  2. Overview (ToolRouter Docs, 2026)
  3. ToolRouter MCP Server (MCPServers, 2026)
  4. ToolRouter: Unified AI Agent & Terminal Tool Gateway (MCPMarket, 2026)
  5. Humanleap/toolrouter-agent-plugin (GitHub, 2026)
  6. Your MCP agent re-sends 7,000 tokens of tool schemas on every turn (DEV Community, 2026)
  7. Agent Tool Call Token Costs: 7 Ways to Cut Them (Compresr, 2026)
  8. alexandroit/stackline-tool-router (GitHub, 2026)
  9. dhruv1n30/mcp-tool-router (GitHub, 2026)
  10. tool-router · GitHub Topics (GitHub, 2026)
  11. Add ToolRouter remote MCP server — PR #1038 (punkpeye/awesome-remote-mcp-servers, 2026)
AN
O autorze
Andrzej Niemiec

Fanatyk nowych technologii i specjalista w zakresie sztucznej inteligencji.

Jak powstają teksty: Polityka AI · O redakcji

Analiza i dane

Trend rynkowy

Trend rynkowy

Trend rynkowy