Hooshyar documentation
Hooshyar is the company AI gateway. Your applications and coding tools send their model calls to one OpenAI-compatible address. The gateway selects a model for each request, applies the company rules and records the usage.
What you need
Get a client key from an administrator. The key is shown one time only. Keep it in an environment variable. Do not write it in a file that you commit.
The addresses
| Service | Address | Credential |
|---|---|---|
| Gateway: models and company tools | https://gateway.example.com · https://gateway.example.com/mcp | Client key — HOOSHYAR_API_KEY |
| Admin MCP server | https://mcp.example.com/mcp | Admin token — HOOSHYAR_TOKEN |
| Admin API | https://console.example.com/api/v1 | Admin token — HOOSHYAR_TOKEN |
In the console, the page Set up a client shows the routes that your key can use.
Two different credentials
A client key calls models and company tools. An admin token reads and changes the gateway configuration. Do not use one in place of the other.
Continue
- Connect a client
Point an editor, an SDK or curl at the gateway.
- Gateway API
The endpoints that the gateway serves.
- Admin API
Read and change the configuration from a script.
- MCP servers
Mount the company tools or the admin server in an agent.