---
name: humiris
description: Use when integrating Humiris managed models, routing or MCP into an application.
---

# Humiris integration

1. Inspect the repository, runtime, package manager and existing AI client before editing.
2. Read `HUMIRIS_API_KEY` only from the server environment. Never hardcode, print or expose it to browser code.
3. Reuse the official OpenAI SDK when present and set `baseURL` to `https://api.humiris.ai/api/v1`.
4. Default to `humiris/auto`, but keep the model route configurable.
5. Put Humiris behind one typed adapter so the rest of the application is provider-independent.
6. Preserve existing behavior and add useful timeout and error handling.
7. Add and run one smoke or integration test.
8. Report changed files, exact checks and setup instructions. Do not claim success unless tests pass.

The public developer MCP is `https://humiris.ai/api/mcp`.

References: https://humiris.ai/developers and https://humiris.ai/get-started