Porticol with Codex
Codex reads MCP servers from its own TOML config. Add Porticol there and every Codex session on the machine can use your workspace.
Add the server to Codex
[mcp_servers.porticol]
command = "porticol-cli"
args = ["mcp"]On Windows the file is %USERPROFILE%\.codex\config.toml. To allow writes, use args = ["mcp", "--write"].
What it can do
- Search collections, requests and history for a query.
- Read a collection with its requests and examples, or one request of it.
- List the environments, or read one by id.
- Send a request and return what came back.
- Run a collection and wait for the finished run.
- Read recent sends and their results.
- Preview an OpenAPI document as a collection, without importing it.
- Create or change requests only when the server starts with --write.
- Secret values stay in Porticol: every result is masked, and a protected environment waits for a person in the app.
Try it
Ask it to read the request that returns a 500, send it again, and compare the two responses.
Questions
Where does Codex read MCP servers?
In ~/.codex/config.toml, or %USERPROFILE%\.codex\config.toml on Windows.
How do I let Codex change requests?
Add --write to the args list, so it reads args = ["mcp", "--write"].
Try it on your own APIs
Free for one seat, on macOS, Windows and Linux.