# Install PeopleRouter in Codex

Two parts: a server entry that carries the connection, and a package that carries the
people-search skill. The key goes in the server's url — no environment variable, no browser,
nothing that expires.

1. Set the server in `~/.codex/config.toml` to exactly this, keeping every other server. If a
   `peoplerouter` entry is already there, replace it — there must be one:

   ```toml
   [mcp_servers.peoplerouter]
   url = "https://mcp.peoplerouter.ai/u/{{PEOPLEROUTER_API_KEY}}/mcp"
   ```

   If that is still the literal placeholder `{{PEOPLEROUTER_API_KEY}}`, you fetched this page
   yourself rather than being handed it: ask the user for their key from
   https://peoplerouter.ai/console, which creates one on a single click. Write the key only into
   this file; never echo it into the chat or any other file. Do not also run `codex mcp add` —
   that defines the same server a second time.

2. Download [the package](https://api.peoplerouter.ai/plugins/peoplerouter-codex.zip),
   extract it into a persistent directory, and install it:

   ```bash
   codex plugin marketplace add <absolute-path-to-extracted-peoplerouter-codex-directory>
   codex plugin add peoplerouter@peoplerouter
   ```

   If an older version is installed, this replaces it; older versions also defined the
   server, and this one does not. It installs the skill only; the connection is step 1. If it cannot be installed, the tools
   still work — read https://api.peoplerouter.ai/skill.md for the workflow it would have added.

3. **The user restarts Codex and starts a new conversation.** Codex reads its MCP configuration
   at startup and tools load when a session starts, so neither step 1 nor step 2 does anything
   in the session that made them. You cannot do this from inside Codex; say so plainly.

4. In the new conversation, call `capabilities` with no arguments. It is free, and returning the
   capability table means the whole chain works.

If a step fails, or the tools do not appear, read https://api.peoplerouter.ai/connect.md.