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

# VS Code (Copilot agent mode)

> Add Parel to Visual Studio Code for Copilot's agent mode in one click: sign in in the browser, or use an API key.

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

**Step 1.** Create an API key: in the dashboard open **Getting started**, pick **VS Code**, 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.** On the dashboard's Getting started page, click **Add to VS Code**: VS Code opens, shows the server and asks for the key once (it is stored by VS Code, not written to a file). Or run **MCP: Add Server** from the Command Palette, choose **HTTP**, paste the URL, name it `parel`, pick **Global**, and add the header to the file it opens:

```json
{
  "inputs": [
    {
      "id": "parel-key",
      "type": "promptString",
      "description": "Parel API key",
      "password": true
    }
  ],
  "servers": {
    "parel": {
      "type": "http",
      "url": "https://api.parel.si/mcp",
      "headers": {
        "Authorization": "Bearer ${input:parel-key}"
      }
    }
  }
}
```

**Step 3.** Open Chat, switch the mode to **Agent**, and click the tools icon: Parel's tools are listed. VS Code asks for the key the first time the server starts.

## Or: sign in, no key

**Step 1.** On the dashboard's Getting started page, click **Add to VS Code**: VS Code opens the server's page; click **Install**. If nothing opens, run **MCP: Add Server** from the Command Palette, choose **HTTP** and paste the address.

**Step 2.** VS Code asks to sign in to parel: click **Allow**. Your browser opens a Parel page: sign in with the account you use at app.parel.si if asked, check it names VS Code, and click **Approve**.

**Step 3.** Open Chat, switch the mode to **Agent**, and click the tools icon: Parel's tools are listed.

## Give it the operating guide

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

- VS Code Insiders: the install link starts with `vscode-insiders:` instead of `vscode:`.

## 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 VS Code 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.
