Skip to main content
Connect UseAgents to OpenAI Codex so your AI assistant can discover verified developer tools from the registry.
UseAgents is currently free during our public beta. No API key is required. Requests are subject to rate limits.

Option 1: CLI command

Run this in your terminal to register UseAgents:
Codex uses stdio transport by default, so mcp-remote bridges the HTTP-based UseAgents server to the Codex CLI.

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:
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