# Agentes y MCP

Leer el gasto y el ahorro por agente, llamar a herramientas a través de la pasarela MCP gobernada y ejecutar las herramientas de lectura del asistente.

[Toda la referencia de la API](https://www.azothos.ai/es/docs/api)

> Los resúmenes de las rutas y los nombres de los campos están en inglés, aquí y en el archivo.

## /api/v1/agents

### GET /api/v1/agents

Spend and savings per agent

- **Autenticación** — Clave API
- **Ámbito de la clave** — `agents:read`
- **Parámetros** — `days`
- **Respuestas** — `200` · `400` [validation_failed](https://www.azothos.ai/es/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/es/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/es/docs/errors#plan_required) · `429`

## /api/v1/mcp

### GET /api/v1/mcp

Not used — the MCP gateway opens no stream (405)

- **Autenticación** — Clave API
- **Ámbito de la clave** — `agents:write`
- **Módulo** — Disponible donde el despliegue ejecuta `FEATURE_MCP_GATEWAY`.
- **Respuestas** — `405`

### POST /api/v1/mcp

The governed MCP gateway (Streamable HTTP, tools only)

- **Autenticación** — Clave API
- **Ámbito de la clave** — `agents:write`
- **Módulo** — Disponible donde el despliegue ejecuta `FEATURE_MCP_GATEWAY`.
- **Cuerpo** — `application/json`
- **Respuestas** — `200` · `202` · `400` · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [key_not_bound_to_agent](https://www.azothos.ai/es/docs/errors#key_not_bound_to_agent), [origin_not_allowed](https://www.azothos.ai/es/docs/errors#origin_not_allowed), [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [plan_required](https://www.azothos.ai/es/docs/errors#plan_required) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/es/docs/errors#feature_disabled) · `503` [feature_disabled](https://www.azothos.ai/es/docs/errors#feature_disabled), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### DELETE /api/v1/mcp

Not used — the MCP gateway keeps no session (405)

- **Autenticación** — Clave API
- **Ámbito de la clave** — `agents:write`
- **Módulo** — Disponible donde el despliegue ejecuta `FEATURE_MCP_GATEWAY`.
- **Respuestas** — `405`

## /api/v1/insights

### POST /api/v1/insights/{tool}

Run one of the assistant's read tools

- **Autenticación** — Clave API
- **Ámbito de la clave** — `insights:read`
- **Módulo** — Disponible donde el despliegue ejecuta `FEATURE_ASSISTANT`.
- **Parámetros** — `tool` (obligatorio)
- **Cuerpo** — `input` · `locale`
- **Respuestas** — `200` · `400` [validation_failed](https://www.azothos.ai/es/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [assistant_disabled](https://www.azothos.ai/es/docs/errors#assistant_disabled), [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [plan_required](https://www.azothos.ai/es/docs/errors#plan_required) · `404` [unknown_tool](https://www.azothos.ai/es/docs/errors#unknown_tool) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/es/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)
