# Agents et MCP

Lire les dépenses et les économies par agent, appeler des outils par la passerelle MCP gouvernée, et exécuter les outils de lecture de l’assistant.

[Toute la référence de l’API](https://www.azothos.ai/fr/docs/api)

> Les résumés des routes et les noms des champs sont écrits en anglais, ici comme dans le fichier.

## /api/v1/agents

### GET /api/v1/agents

Spend and savings per agent

- **Authentification** — Clé API
- **Portée de la clé** — `agents:read`
- **Paramètres** — `days`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/fr/docs/errors#plan_required) · `429`

## /api/v1/mcp

### GET /api/v1/mcp

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

- **Authentification** — Clé API
- **Portée de la clé** — `agents:write`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_MCP_GATEWAY`.
- **Réponses** — `405`

### POST /api/v1/mcp

The governed MCP gateway (Streamable HTTP, tools only)

- **Authentification** — Clé API
- **Portée de la clé** — `agents:write`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_MCP_GATEWAY`.
- **Corps** — `application/json`
- **Réponses** — `200` · `202` · `400` · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [key_not_bound_to_agent](https://www.azothos.ai/fr/docs/errors#key_not_bound_to_agent), [origin_not_allowed](https://www.azothos.ai/fr/docs/errors#origin_not_allowed), [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [plan_required](https://www.azothos.ai/fr/docs/errors#plan_required) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled) · `503` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled), [service_unavailable](https://www.azothos.ai/fr/docs/errors#service_unavailable)

### DELETE /api/v1/mcp

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

- **Authentification** — Clé API
- **Portée de la clé** — `agents:write`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_MCP_GATEWAY`.
- **Réponses** — `405`

## /api/v1/insights

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

Run one of the assistant's read tools

- **Authentification** — Clé API
- **Portée de la clé** — `insights:read`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_ASSISTANT`.
- **Paramètres** — `tool` (obligatoire)
- **Corps** — `input` · `locale`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [assistant_disabled](https://www.azothos.ai/fr/docs/errors#assistant_disabled), [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [plan_required](https://www.azothos.ai/fr/docs/errors#plan_required) · `404` [unknown_tool](https://www.azothos.ai/fr/docs/errors#unknown_tool) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/fr/docs/errors#service_unavailable)
