The API reference moved here from eksis.io/developers.
Clients

Codex

Connect Codex to an eksis workspace over MCP.

Authentication: OAuth sign-in, API key

Server URL

https://api.eksis.io/mcp

Set it up

codex mcp add registers the server and codex mcp login runs the OAuth flow. To use an API key instead, write the server into ~/.codex/config.toml and point bearer_token_env_var at an environment variable that holds the key.

Configuration

codex mcp add eksis --url https://api.eksis.io/mcp
codex mcp login eksis

Set it up with an AI agent

Paste this prompt into Codex, or into any other AI agent that can run commands and edit files on the same computer. It stops and hands back to you when eksis asks you to sign in.

Prompt
Connect the eksis MCP server to Codex on this computer.

Server URL: https://api.eksis.io/mcp
Setup guide: https://docs.eksis.io/en/mcp/clients/codex

Use OAuth sign-in. Follow the API key steps only if I give you a key that starts with eksis_sk_. Then use my key wherever the steps show eksis_sk_..., or set it as EKSIS_API_KEY where they read that variable.

OAuth:
```bash
codex mcp add eksis --url https://api.eksis.io/mcp
codex mcp login eksis
```

API key:
Write this to `~/.codex/config.toml`. If the file already exists, merge it in and keep the other servers.
```toml
[mcp_servers.eksis]
url = "https://api.eksis.io/mcp"
bearer_token_env_var = "EKSIS_API_KEY"
```

From the setup guide:
`codex mcp add` registers the server and `codex mcp login` runs the OAuth flow. To use an API key instead, write the server into `~/.codex/config.toml` and point `bearer_token_env_var` at an environment variable that holds the key.

Rules:
- If Codex already has a server named eksis, show me its entry and ask before you change it.
- Never put an API key in a file that is committed to git. Keep it in an environment variable or the client's own secret store, as the steps show.
- If a command asks a question interactively, show me the question and wait for my answer.
- When eksis opens a sign-in page in the browser, stop and ask me to pick the workspace and approve it. Do not approve it for me.

When you are done, check the connection and list the eksis tools Codex can see. If it fails, show me the error.

How the two ways of signing in differ, and what each permission allows, is on the MCP overview. The tool list shows what the assistant can ask eksis to do.

On this page