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

# Kiro

> Add Parel to Kiro in one click and sign in in the browser, or use an API key in mcp.json.

<!-- 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 Kiro: use an API key

**Step 1.** Create an API key: in the dashboard open **Getting started**, pick **Kiro**, 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.** Add this to `~/.kiro/settings/mcp.json` (every workspace) or `.kiro/settings/mcp.json` (one workspace):

```json
{
  "mcpServers": {
    "parel": {
      "url": "https://api.parel.si/mcp",
      "headers": {
        "Authorization": "Bearer sk_…"
      }
    }
  }
}
```

**Step 3.** Kiro's MCP panel lists parel with its tools.

## Or: sign in, no key

**Step 1.** On the dashboard's Getting started page, click **Add to Kiro**: Kiro opens and asks you to confirm the server. Or add this to `~/.kiro/settings/mcp.json`:

```json
{
  "mcpServers": {
    "parel": {
      "url": "https://api.parel.si/mcp"
    }
  }
}
```

**Step 2.** When Kiro connects, 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**.

**Step 3.** Kiro's MCP panel lists parel with its tools.

## Give it the operating guide

Paste this into Kiro's chat 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

- A key in a workspace's `.kiro/settings/mcp.json` must stay out of version control.

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