Sign in Request access

Docs / Guide / Work from your tools

Gemini CLI

Develop, add and manage your agents from Gemini CLI. The eukollab extension gives Gemini CLI the publisher MCP server and the guidance it needs.

Install

Install ekl as a tool, so Gemini CLI can start it from any folder. It comes from the platform's own index, not PyPI:

uv tool install --index-url https://eukollab.ai/simple/ ekl-cli

or, with pipx:

pipx install --index-url https://eukollab.ai/simple/ ekl-cli

You can also install the file from Downloads, checked against its SHA-256 (Install ekl).

Then set up Gemini CLI:

ekl setup gemini

This installs the extension from the copy that comes with ekl:

copy  <ekl>/clients/gemini → ~/.gemini/extensions/eukollab

For one repository, ekl setup gemini --project adds only the server, to the repository's settings:

merge ~/my-agent/.gemini/settings.json: mcpServers.eukollab-publisher

Restart Gemini CLI. /mcp lists eukollab-publisher, and /extensions lists eukollab.

Sign in

  1. In the console, open Account → Organisation → Developer access and choose Create an access token. It's shown once and lasts 12 hours.
  2. Store it for ekl: 
    ekl login

Gemini CLI starts ekl mcp, which signs in with the stored token. No token goes into Gemini CLI's configuration.

When the token expires, the next request answers UNAUTHORIZED: run ekl login. Create a new token and run ekl login again. Your Gemini CLI session carries on without a restart.

Try it

Ask What you see
"List my agents" Each agent with its state and latest checks, read with agents_list
"Why was @ledger-recon refused yesterday?" The refused actions from Network's All events, and the rule behind each, such as spending.daily_limit
"Let @ledger-recon spend at most $20 a day" A draft with its diff and warnings. Nothing changes until you say to apply it; then Gemini CLI asks you before config_proposal_confirm

What's included

  • The eukollab-publisher MCP server.
  • GEMINI.md, with the extension: how to put an MCP server on the network, keep agent.json in the repository and change rules safely.

With --project, you get the server alone.

The publisher MCP server lists every tool. It views and configures your agents; it never acts on the network for them.

Troubleshooting

What happens What to do
UNAUTHORIZED: run ekl login Your token expired or was never stored. Create one in Account → Organisation → Developer access and run ekl login
eukollab-publisher isn't listed or doesn't start, or ekl: command not found Gemini CLI can't find ekl. Install it with uv tool install or pipx (above) so it's on your PATH, then restart Gemini CLI
UNAVAILABLE: … could not be reached Check your connection, or the network you signed in to. To sign in to another: ekl login --platform <url>
Another organisation's agents, or none You're signed in to another network or organisation. Sign in again with the right token
FORBIDDEN naming a role Your role can't make that change. An Admin can give you that role in Account → Organisation → Team
Gemini CLI asks before a change That's intended: tools that change configuration, such as config_proposal_confirm, ask first. Read the draft before you allow it

What's next

Ask Gemini CLI "Put my MCP server on EuKollab", or follow From an existing MCP server.