Herramientas del MCP

​

Tu key decide lo que ve el asistente

• tools/list sólo devuelve las herramientas que los scopes de la key permiten. Con una key de sólo lectura, el asistente ni siquiera sabe que existe create_call.
• Cada tools/call vuelve a comprobar el scope. Un cliente que llama a una herramienta que no se le mostró recibe un error insufficient_scope, no el resultado.

​

Catálogo de herramientas

​

Pide resúmenes, no páginas

• Las herramientas de lista devuelven 50 elementos por omisión, hasta 100 por llamada, aceptan los filtros de la tabla y devuelven un next_cursor para la página siguiente.
• Las listas dejan fuera los campos pesados: list_calls no incluye transcripciones. Pide una llamada con get_call cuando necesites lo que se dijo.
• get_call_stats contesta preguntas agregadas («¿cuántas llamadas fallaron ayer?», «¿qué agente gastó más esta semana?») en una sola llamada, en vez de paginar cientos de llamadas. Cuenta hasta 1,000 llamadas por rango; si había más, lo dice con truncated: true y el total real en calls_in_range, para que el asistente acote el rango.

​

Límites de peticiones

• Cada llamada a una herramienta cuenta como una petición contra el límite por minuto de tu plan, una vez, nunca más.
• initialize, tools/list y el resto del protocolo no cuentan.
• En las tres herramientas que piden confirmación sólo cuenta la llamada que se ejecuta. El paso de confirmación no.
• El tope por IP de la API aplica a toda petición, también a initialize y tools/list.

​

Errores

{
  "error": "insufficient_scope",
  "message": "This API key is missing the `calls:write` scope. Create a key with that permission from Settings › API keys.",
  "request_id": "f0c0a9d2-8b1e-4d8a-9c2f-6e5b7a1d2c3b"
}