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.
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.