Calculadora de sobrecarga de tokens de esquemas de herramientas MCP
Cada herramienta o servidor MCP que expones añade una definición (nombre, descripción y esquema de parámetros) que el modelo debe leer, normalmente en cada solicitud. Introduce cuántas herramientas tienes, los tokens medios por definición y la sobrecarga fija del protocolo para ver qué parte de la ventana de contexto ocupan, qué queda y cuánto cuestan a lo largo de las sesiones. También puedes pegar tus definiciones reales y medirlas en el navegador; nada de lo que pegues se sube.
Resultado
Estimación
Introduce las herramientas, los tokens, los turnos y la ventana de contexto para ver la sobrecarga.
Solo las definiciones ya son mayores que la ventana de contexto, así que no cabría ninguna solicitud.
- Tokens de definiciones de herramientas
- Sobrecarga total por solicitud
- Parte de la ventana de contexto
- Contexto que queda tras la sobrecarga
- Sobrecarga por sesión
- Tokens de sobrecarga por día
- Tokens de sobrecarga por mes
- Coste de la sobrecarga por solicitud
- Coste de la sobrecarga por sesión
- Coste de la sobrecarga por día
- Coste de la sobrecarga por mes
Aritmética exacta sobre tus recuentos. Los clientes y modelos reales pueden serializar y contar las herramientas de otra forma, así que trata las cifras como una estimación y compáralas con el uso de una solicitud real.
Ejemplos
Ejemplos resueltos (ventana de 128.000 tokens, 10 solicitudes por sesión, 200 sesiones al día, precio de ejemplo de 3 USD por millón de tokens de entrada):
| Configuración | Sobrecarga por solicitud | Parte de la ventana | Tokens por día | Coste por mes |
|---|---|---|---|---|
| Pequeña: 5 herramientas | 900 | 0,7% | 1.800.000 | 162,00 USD |
| Típica: 20 herramientas | 3.500 | 2,7% | 7.000.000 | 630,00 USD |
| Grande: 100 herramientas | 20.800 | 16,3% | 41.600.000 | 3.744,00 USD |
Fórmula y metodología
La aritmética es exacta para los números que introduces:
sobrecarga por solicitud = herramientas × tokens de esquema por herramienta + sobrecarga fija (o el total medido + sobrecarga fija)parte de la ventana = sobrecarga por solicitud ÷ ventana de contexto; restante = ventana − sobrecarga por solicitudsobrecarga por sesión = sobrecarga por solicitud × solicitudes por sesióncoste por solicitud = sobrecarga por solicitud × precio de entrada ÷ 1.000.000; por día = coste por solicitud × solicitudes por sesión × sesiones por díaConviene saber
- Los clientes difieren: algunos envían todas las definiciones en cada solicitud, otros cargan las herramientas bajo demanda o las guardan en caché. Esta herramienta supone que las definiciones se envían con cada solicitud, así que ajusta las solicitudes por sesión a tu cliente.
- La contabilidad específica de cada proveedor no es universal. Un proveedor puede añadir sus propios tokens de sistema para el uso de herramientas y los tokenizadores difieren, así que un recuento medido solo es exacto para la codificación indicada.
- El texto JSON medido se estima en unos 4,5 caracteres por token (rango de 2,5 a 5, según tokenizadores de OpenAI medidos sobre definiciones de herramientas) salvo que elijas una codificación exacta de OpenAI. Los tokenizadores reales varían.
- La caché de prompts puede abaratar las definiciones repetidas. Esta herramienta factura la sobrecarga al precio de entrada normal: consulta la calculadora de caché de prompts.
- Menos herramientas, mejor descritas, suelen costar menos contexto y ayudan al modelo a elegir. Mide antes y después.
Método y referencias
Estas fuentes primarias respaldan los métodos en los que se basa esta herramienta. Haberlas leído no verifica cada resultado de la calculadora, y las cifras que figuran como supuestos son propias de ToolQuarter.
La estructura de la definición de una herramienta procede de la especificación MCP. Cuántos tokens cuesta depende del cliente, del modelo y del tokenizador.
- MCP specification: Tools (2026-07-28): Define qué contiene la definición de una herramienta: un nombre, un título opcional, una descripción, un inputSchema escrito en JSON Schema y un outputSchema opcional. Describe la estructura, no un recuento de tokens. ()
- OpenAI API: Function calling: Indica que las definiciones de funciones cuentan para el límite de contexto del modelo y se facturan como tokens de entrada, y sugiere cargar menos funciones y acortar las descripciones. ()
- Anthropic: Pricing, tool use: Muestra que otro proveedor también factura el parámetro tools como tokens de entrada y añade sus propios tokens de prompt de sistema para el uso de herramientas según el modelo, por eso la sobrecarga difiere entre proveedores. ()
Supuestos de ToolQuarter (sin fuente primaria):
- El JSON medido se estima en unos 4,5 caracteres por token (rango de 2,5 a 5) salvo que elijas una codificación exacta de OpenAI. Ese rango es una medición propia de ToolQuarter sobre definiciones de herramientas, no una cifra de ningún proveedor.
- La calculadora supone que el cliente envía todas las definiciones en cada solicitud. Las fuentes consultadas no dicen con qué frecuencia lo hace un cliente y los clientes difieren (algunos cargan las herramientas bajo demanda), así que ajusta las solicitudes por sesión.
Cómo usar
- Introduce el número de herramientas, los tokens medios de esquema por herramienta y la sobrecarga fija si la hay.
- Si quieres, pega tus definiciones de herramientas para medirlas en local y usar el total medido.
- Introduce las solicitudes por sesión, las sesiones por día, tu ventana de contexto y, si quieres, tu precio de entrada.
- Lee la sobrecarga, la parte de la ventana de contexto, lo que queda y el coste.
Preguntas frecuentes
¿Cuántos tokens usan las definiciones de herramientas MCP?
Depende de las herramientas. Una definición con nombre, descripción y esquema de parámetros suele rondar entre 100 y unos cientos de tokens, así que veinte herramientas pueden ocupar unos miles de tokens. Pega tus definiciones para medirlas en lugar de fiarte de un promedio.
¿Las definiciones de herramientas se envían en cada solicitud?
En muchos clientes sí: el modelo debe verlas cada vez. Algunos clientes cargan las herramientas bajo demanda o las guardan en caché. Esta calculadora supone que se envían con cada solicitud, algo que puedes ajustar con el número de solicitudes por sesión.
¿Se sube a algún sitio el texto que pego?
No. Se mide en tu navegador y nunca se sube, se interpreta como código ni se envía a analítica. Si eliges una codificación exacta, solo se descargan los datos del tokenizador.
¿El recuento es exacto para mi modelo?
Solo para la codificación de OpenAI que elijas y solo para el texto tal como lo pegaste. Otros modelos tokenizan de forma distinta y los clientes pueden serializar las herramientas en su propio formato, así que trátalo como una estimación.
¿Cómo puedo reducir la sobrecarga?
Expón menos herramientas, acorta las descripciones y los esquemas, carga las herramientas solo cuando haga falta y usa la caché de prompts para las definiciones que se repiten. Después vuelve a medir.
Última actualización: