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

# OpenCode

> Add Parel to OpenCode in its config file: sign in in the browser, or use an API key from 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 OpenCode: use an API key

**Step 1.** Create an API key: in the dashboard open **Getting started**, pick **OpenCode**, 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.** Put the key in an environment variable: add this line to `~/.zshrc` (or `~/.bashrc`) and open a new terminal:

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

**Step 3.** Add Parel to `~/.config/opencode/opencode.json` (merge it with what is there):

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "parel": {
        "type": "remote",
        "url": "https://api.parel.si/mcp",
        "oauth": false,
        "headers": {
          "Authorization": "Bearer {env:PAREL_KEY}"
        }
      }
    }
  }
}
```

## Or: sign in, no key

**Step 1.** Add Parel to OpenCode's global config, `~/.config/opencode/opencode.json` (merge it with what is there). The fixed port keeps later sign-ins working:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "parel": {
        "type": "remote",
        "url": "https://api.parel.si/mcp",
        "oauth": {
          "callback_port": 47824
        }
      }
    }
  }
}
```

**Step 2.** Sign in once from a terminal (or with `/mcps` inside OpenCode):

```bash
opencode mcp auth parel
```

**Step 3.** Your browser opens 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**.

## Give it the operating guide

Paste this into OpenCode 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

- Older OpenCode versions list servers directly under `mcp` instead of `mcp.servers`; update OpenCode if the config is refused.

## 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 OpenCode 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.
