> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/quickstart-codex

# 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](https://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:

```bash
export PAREL_KEY="$PAREL_KEY"
```

**Step 3.** Register the server once:

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

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

```bash
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](https://parel.si/skill.md), and tool descriptions carry today's price.

```text
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.

```text
Check my Parel balance.
```

Then try a paid call:

```text
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.toml` with the CLI, so one setup serves all three.

## Next

- [Examples](https://parel.si/docs/examples.md): a prompt for each tool and what it costs.
- [Playbooks](https://parel.si/docs/playbooks.md): six ready-made jobs with the tools they use and a typical run's cost.
- [MCP reference](https://parel.si/docs/mcp.md): every tool Codex now sees, with inputs and results.
- [Errors](https://parel.si/docs/errors.md): every code, what you pay (₹0 in every row but one), whether to retry.
