MCP
Referencia · tools

Tools de api

El dominio api es DynamoAPI, la API REST de datos de Dynamo para integraciones y Power BI. Estas 5 tools le dan a un agente el control de la API de un proyecto: qué formularios sirve, su esquema, la conciliación, el estado y la auditoría. Corren con tu propia sesión: tu token no sale del gateway; por cada llamada el gateway firma un vale de 60 segundos, de un solo uso, que dice quién sos, sobre qué proyecto y con qué tool, y el backend de la API decide si tenés acceso.

En producción estas tools no están todavía. DynamoAPI llega a producción con su lanzamiento; hasta entonces el gateway de producción (mcp.dynamotech.co) no monta el dominio api y estas 5 tools no aparecen en la lista del conector. En QA (mcp-qa.dynamotech.co) están montadas; si el backend de la API de QA no está configurado, cada una responde con un error que lo dice (API_BACKEND_URL), nunca con una respuesta vacía.

gateway remoto 5 lectura

Los registros y los adjuntos NO se leen por acá. La extracción masiva (/records, grupos repetibles y adjuntos) es de la API REST con la key del proyecto, para BI e integraciones. Un agente lee respuestas con forms_list_form_responses y adjuntos con las tools de forms.

Un proyecto ajeno devuelve lo mismo que uno que no existe. Sin acceso al proyecto, con el proyecto o la organización desactivados, o sin la app api, la respuesta es la misma, sin decir por qué: es deliberado, para no confirmar que existe.

Lectura (5)

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
api_list_forms Los formularios del proyecto que DynamoAPI sirve hoy (los que son del proyecto y tienen foto vigente), con su foto y su fecha de datos. Con form_id, uno solo. project_id (uuid) · form_id (uuid, opcional) Sesión con usuario de Dynamo activo, organización y proyecto activos, la app api habilitada en el proyecto y tu grant api en él. "¿Qué formularios del proyecto están disponibles por la API?"
api_get_form_schema El esquema de un formulario tal como sale por la API REST: tablas (principal y grupos repetibles), columnas con su nombre legible y su tipo. project_id (uuid) · form_id (uuid) El mismo de api_list_forms. "¿Qué columnas trae la tabla de inspecciones en la API?"
api_reconcile Conciliación por tabla de cada formulario: vivos, activos, anulados, borrados, inválidos y la paridad con la fuente; marca stale si la foto no está al día. project_id (uuid) El mismo de api_list_forms. "¿La API tiene todos los registros de este proyecto al día?"
api_get_status Estado y frescura de la API del proyecto y las corridas recientes que publicaron (o rechazaron) sus fotos. project_id (uuid) El mismo de api_list_forms. "¿Cuándo se actualizaron por última vez los datos de la API?"
api_list_audit_events Eventos de auditoría del proyecto (modificaciones, permisos, accesos y salidas) con huellas en vez de valores y su sello en el WORM, paginados. Leerlos también queda auditado. project_id (uuid) · after (cursor de la página anterior, opcional) · limit (1-1000, opcional) Además de lo de api_list_forms: ser admin del proyecto (is_admin) o global-admin. "Mostrame los últimos accesos a los datos del proyecto por la API."

Para errores concretos de estas tools: Troubleshooting. Para correr los MCPs en stdio localmente en vez del gateway: Para desarrolladores.