Skip to content
Client integrations

Codex

Recommended

Install the PeopleRouter plugin or configure MCP manually.

Configure this client in Quick Start.

Before you start

The dedicated Codex installation guide configures MCP first, then installs the people-search skill package. The new package provides the skill only; the MCP entry in config.toml provides the connection. Restart Codex and start a new conversation afterwards. The manual OAuth setup below remains an alternative.

Quick Start selects an API key from your account and generates a setup instruction for your agent.

See Authentication and API Keys for credential options. Merge only the peoplerouter entry into an existing configuration; do not overwrite other settings.

Set up the connection

Developer settings · API Key (optional)

Stored in this browser. It is only inserted into copied examples when you enable the checkbox above.

Copy this message to Codex to install the plugin, then complete browser authorization.

paste to your agent
Connect PeopleRouter for me, following https://api.peoplerouter.ai/plugins/codex-install.md.
My API key is {{PEOPLEROUTER_API_KEY}}; replace the placeholder in the guide with it.

Manual MCP-only setup (skip this if you installed the plugin):

codex mcp add peoplerouter --url https://mcp.peoplerouter.ai
codex mcp login peoplerouter

Official setup guide ↗

Check the connection

Once the client has loaded the PeopleRouter tools, send the request below. Inspect capabilities before running a people search.

paste to your agent
Use PeopleRouter to list the available capabilities and explain which tools can help find the contributors to a GitHub repository. Do not run a search yet.

After connecting, continue to Using tools. For authentication or tool errors, read Troubleshooting and inspect the client's actual error message.