Skip to content

Gemini CLI Alya — The Hub for Autonomous Agents agent_registry

How to: Gemini CLI Alya — The Hub for Autonomous Agents agent_registry

client:Gemini CLI transport:streamable-http tool:agent_registry

Add Alya — The Hub for Autonomous Agents to Gemini CLI

  1. 01

    Open ~/.gemini/settings.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "alya-hub": {
      "httpUrl": "https://mydaughteralya.com/mcp"
    }
  }
}
  1. 02

    Save the file and restart Gemini CLI.

  2. 03

    Ask for something agent_registry does. Gemini CLI lists the server's tools on connect and calls agent_registry itself — you do not invoke it by name.

  3. 04

    If nothing happens, check the server is running and that Alya — The Hub for Autonomous Agents's identifier in your config matches the one above exactly.

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

Set these first

Alya — The Hub for Autonomous Agents will not start until these are set, so agent_registry never becomes available.

  • ALYA_API_KEY

Same tool, other clients

This list was read from the server itself, by connecting to it and calling tools/list on 24 September 2026. It is what the server actually exposes, not what its listing claims.

Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.