Skip to main content
Glama

askacharge.com — EV charging network

by com.askacharge
OverviewDiscussionsAdmin

Ver la traza de las API keys

askacharge_traza_de_actividad
Read-onlyIdempotent

Lista lo que han hecho las API keys de la marca, de lo más reciente a lo más antiguo: escrituras e intentos rechazados, con método, ruta, código de respuesta, IP y duración. Las lecturas correctas NO se registran, y la traza se borra a los 90 días. Solo lee, no cambia nada. Es la herramienta de auditoría de credenciales: para la actividad de carga usa askacharge_listar_sesiones.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoCuántas entradas devolver: 100 por defecto, 500 como máximo
key_idNoId de una API key concreta para ver solo la suya. Por defecto, todas las de la marca
solo_erroresNoSi es true, solo los intentos rechazados (código 400 o superior). Por defecto false

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / key_id
      Added value: +{
+  "description": "Id de una API key concreta para ver solo la suya. Por defecto, todas las de la marca",
+  "type": "string"
+}
    • addedInput schema / properties / limit / description
      Added value: +"Cuántas entradas devolver: 100 por defecto, 500 como máximo"
    • addedInput schema / properties / solo_errores / description
      Added value: +"Si es true, solo los intentos rechazados (código 400 o superior). Por defecto false"
  2. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Aunque las anotaciones ya declaran readOnlyHint=true e idempotentHint=true, la descripción añade contexto valioso: qué operaciones se registran, cuáles se omiten, orden temporal, retención de 90 días y los campos devueltos. Esto va más allá de lo que las anotaciones estructuradas proporcionan y no contradice ninguna de ellas.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tres oraciones que aportan toda la información relevante sin redundancia. La acción principal está al inicio, seguida de los matices de comportamiento, la naturaleza de solo lectura y la alternativa para el caso distinto. Cada frase cumple una función.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Para una herramienta de consulta con tres parámetros opcionales y sin esquema de salida, la descripción cubre lo esencial: qué devuelve, en qué orden, qué queda excluido, por cuánto tiempo se conservan los datos y cuándo recurrir a otra herramienta. No falta información crítica para invocarla correctamente.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La cobertura del esquema es del 100%, por lo que el esquema ya documenta los tres parámetros. La descripción añade contexto sobre el contenido de la traza y la exclusión de lecturas correctas, pero no aporta detalles nuevos esenciales sobre limit, key_id o solo_errores más allá del esquema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

La descripción usa un verbo específico ('Lista'), identifica claramente el recurso (traza de las API keys) y detalla qué información incluye (escrituras e intentos rechazados con método, ruta, código, IP y duración). Además, se diferencia explícitamente de askacharge_listar_sesiones al señalar que esa es la herramienta para actividad de carga.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Indica con claridad para qué sirve ('herramienta de auditoría de credenciales') y cuándo NO usarla: para ver actividad de carga indica explícitamente askacharge_listar_sesiones. También aclara que las lecturas correctas no se registran, evitando que el agente espere eventos que no estarán en la traza.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All askacharge.com — EV charging network toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources