# Serveur MCP DimaRouter

Serveur MCP distant, transport Streamable HTTP (JSON-RPC 2.0, sans état).

- **URL** : `https://api.dimarouter.ma/mcp`
- **Authentification** : `Authorization: Bearer $DIMA_API_KEY`. Sans clé, seuls les outils publics sont listés.
- **Versions du protocole** : 2025-06-18, 2025-03-26.

| Outil | Accès | Rôle |
|---|---|---|
| `list_models` | public | Catalogue des modèles, contexte, prix publics en MAD et paliers disponibles. |
| `get_docs` | public | Liens vers la documentation Markdown (quickstart, models, billing, integrations, mcp) et l’essentiel pour démarrer. |
| `create_account` | public | Crée un compte et une clé API ; la clé s’active quand le titulaire confirme le lien reçu par e-mail. |
| `chat` | clé API | Appelle un modèle du catalogue et renvoie la réponse, l’usage en tokens et le coût en MAD. |
| `get_balance` | clé API | Solde du compte en MAD. |
| `get_usage` | clé API | Consommation récente : requêtes, tokens et montant facturé par modèle. |
| `list_api_keys` | clé API | Clés API actives (préfixe seulement). |
| `create_api_key` | clé API | Crée une clé API ; le secret n’est renvoyé qu’une fois. |
| `revoke_api_key` | clé API | Révoque une clé API. |
| `create_topup_link` | clé API | Crée un lien de paiement par carte (YouCan Pay) que l’humain ouvre pour recharger le solde. |

## Parcours d’un agent

1. `list_models` pour choisir un modèle et connaître son prix.
2. Sans compte : `create_account` renvoie une clé API, active dès que le titulaire de l’adresse ouvre le lien reçu par e-mail et choisit son mot de passe.
3. `create_topup_link` renvoie un lien de paiement par carte ; l’humain paie, le solde est crédité automatiquement.
4. `get_balance` pour vérifier le crédit, puis `chat` pour appeler les modèles.

## Configuration

Voir https://dimarouter.ma/docs/integrations.md : Claude Code, Claude Desktop, Codex, OpenAI, Cursor, Kimi Code, DeepSeek Harness, OpenCode.
