Codex
Add Parel to OpenAI's Codex with one command: sign in in the browser, or use an API key in an environment variable.
<!-- Generated from packages/core/src/clients.ts by npm run docs:quickstarts. Edit the client there, not this file. -->
Before you start
Create an account at app.parel.si/signup. ₹100 of welcome credit is on the balance at once; no card is asked for.
Set up Codex: use an API key
Step 1. Create an API key: in the dashboard open Getting started, pick Codex, choose Use an API key and create the key there, so it is filled into these steps (or create one under API keys). It is shown once. Keep the default permissions and set a daily cap in rupees.
Step 2. Codex reads the key from an environment variable. Add this line to ~/.zshrc (or ~/.bashrc) and open a new terminal:
export PAREL_KEY="$PAREL_KEY"
Step 3. Register the server once:
codex mcp add parel --url https://api.parel.si/mcp --bearer-token-env-var PAREL_KEY
Step 4. codex mcp list shows parel. The same thing by hand lives in ~/.codex/config.toml:
[mcp_servers.parel]
url = "https://api.parel.si/mcp"
bearer_token_env_var = "PAREL_KEY"
Or: sign in, no key
Step 1. Run this once in a terminal:
codex mcp add parel --url https://api.parel.si/mcp
Step 2. Codex opens your browser on a Parel page: sign in with the account you use at app.parel.si if asked, check it names an app on your own computer, and click Approve.
Step 3. codex mcp list shows parel. If Codex ever asks you to sign in again: codex mcp login parel.
Give it the operating guide
Paste this into Codex so it reads the operating guide: the rules about money (quote first above ₹200, retry with the same idempotency key, stop on insufficient_balance) live in skill.md, and tool descriptions carry today's price.
Set up Parel: https://parel.si/skill.md
Check it works
Ask for the balance first: it is a free call, and a balance in rupees means you are connected.
Check my Parel balance.
Then try a paid call:
Using Parel, what are the latest 10 news articles about D2C brands in India? Title, source, date and link.
That runs search_news for ₹0.20; an empty result list is ₹0. Every call shows up in the dashboard's Usage page with its price.
Good to know
- The Codex IDE extension and desktop app share
~/.codex/config.tomlwith the CLI, so one setup serves all three.
Next
- Examples: a prompt for each tool and what it costs.
- Playbooks: six ready-made jobs with the tools they use and a typical run's cost.
- MCP reference: every tool Codex now sees, with inputs and results.
- Errors: every code, what you pay (₹0 in every row but one), whether to retry.
This page as Markdown: /docs/quickstart-codex.md. Something wrong or missing: hello@parel.si.