> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagents.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connect the UseAgents MCP server to OpenAI Codex CLI.

Connect UseAgents to OpenAI Codex so your AI assistant can discover verified developer tools from the registry.

<Note>
  UseAgents is **currently free** during our public beta. No API key is required. Requests are subject to [rate limits](/api-reference/rate-limit).
</Note>

## Option 1: CLI command

Run this in your terminal to register UseAgents:

```bash theme={null}
codex mcp add UseAgents -- npx mcp-remote https://mcp.useagents.site/mcp
```

<Tip>
  Codex uses stdio transport by default, so `mcp-remote` bridges the HTTP-based UseAgents server to the Codex CLI.
</Tip>

## Option 2: Edit config.toml

Codex stores its configuration in `~/.codex/config.toml` (global) or `.codex/config.toml` (project-scoped).

Add the UseAgents server to your config:

```toml theme={null}
[mcp_servers.UseAgents]
command = "npx"
args = ["mcp-remote", "https://mcp.useagents.site/mcp"]
```

Save the file and start a new Codex session.

## Verify the connection

1. Start a Codex CLI session.
2. Type `/mcp` to list all connected MCP servers and confirm `UseAgents` appears.
3. Ask Codex to search for a tool — for example: *"Use UseAgents to find a TypeScript SDK for Stripe."*
4. Confirm you receive structured tool results.

## Troubleshooting

* **Server not appearing**: Restart Codex after editing the config file.
* **`mcp-remote` not found**: Codex uses `npx` to resolve it automatically. Make sure Node.js is installed.
* **Permission errors**: If using a project-scoped config, ensure the project is trusted by Codex.

## Next steps

* [MCP Tools Reference](/mcp/tools-reference/introduction) to understand the available tools
* [Rate Limits](/api-reference/rate-limit) for request limits during the beta