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…
Spis treści
- Czym jest ToolRouter?
- Ile tokenów zajmują schematy narzędzi w kontekście agenta?
- Jak działa odkrywanie narzędzi na żądanie?
- ToolRouter, lokalny router czy pełny katalog w prompcie?
- Kiedy routing narzędzi się opłaca, a kiedy to zbędna warstwa?
- Jakie ryzyko wiąże się z pośrednikiem wykonującym narzędzia?
- Najczęstsze pytania
- Ź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?
| Kryterium | Pełny katalog w prompcie | ToolRouter (brama hostowana) | Lokalny router discovery |
|---|---|---|---|
| Co trafia do kontekstu w każdej turze | Schematy całego katalogu | Kompaktowa 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ędzia | U dostawcy, po decyzji agenta | W infrastrukturze ToolRouter [3] | Zależnie od implementacji, bez pośrednika |
| Rozliczanie | Osobne klucze i umowy u każdego dostawcy | Część bezpłatna, część pay-per-call, część na kredyty lub BYOK [2][3] | Koszt własnej infrastruktury |
| Utrzymanie katalogu | Ręczna aktualizacja w kodzie agenta | Po stronie operatora bramy | Wł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
- ToolRouter — Give Your AI Superpowers (toolrouter.com, 2026)
- Overview (ToolRouter Docs, 2026)
- ToolRouter MCP Server (MCPServers, 2026)
- ToolRouter: Unified AI Agent & Terminal Tool Gateway (MCPMarket, 2026)
- Humanleap/toolrouter-agent-plugin (GitHub, 2026)
- Your MCP agent re-sends 7,000 tokens of tool schemas on every turn (DEV Community, 2026)
- Agent Tool Call Token Costs: 7 Ways to Cut Them (Compresr, 2026)
- alexandroit/stackline-tool-router (GitHub, 2026)
- dhruv1n30/mcp-tool-router (GitHub, 2026)
- tool-router · GitHub Topics (GitHub, 2026)
- Add ToolRouter remote MCP server — PR #1038 (punkpeye/awesome-remote-mcp-servers, 2026)
Fanatyk nowych technologii i specjalista w zakresie sztucznej inteligencji.
Jak powstają teksty: Polityka AI · O redakcji