# Percia for AI agents

> Point it at a camera, describe the moment, get a signed webhook. Markdown twin of /coding-agents.

Percia is built so a coding agent can use it end to end, without a person clicking through a browser.

## How an agent starts

- [/llms.txt](/llms.txt): the index of the integrator docs. Start here.
- [/docs/quickstart.md](/docs/quickstart.md): create a webhook watch with five curl commands.
- [/api/openapi.json](/api/openapi.json): every public route as OpenAPI 3.1.
- `/mcp`: the MCP server for your account. Six tools: `search`, `execute`, `docs`, `whoami`, `view_image`, `show_link`.
- `/mcp/docs`: the docs as an MCP server, no key needed. Two tools: `search_docs`, `get_page`.

Every docs page and this page also come as markdown: send `Accept: text/markdown`, or fetch [/coding-agents.md](/coding-agents.md) and `/docs/<page>.md`.

## Connect your agent

Create an API key in the app under Settings > API keys and give it only the permissions the job needs. Put it in `PERCIA_API_KEY`; never paste it into a repository.

### Claude Code

```
claude mcp add --transport http percia https://playground.percia.ai/mcp --header "Authorization: Bearer $PERCIA_API_KEY"
```

Without a key, sign in with OAuth instead. Run this, then `/mcp` inside Claude Code and choose Authenticate:

```
claude mcp add --transport http percia https://playground.percia.ai/mcp
```

### Claude.ai

Settings > Connectors > Add custom connector. Name it Percia and use this URL. You sign in and choose what to allow:

```
https://playground.percia.ai/mcp
```

### Cursor

Add this to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (all projects):

```json
{
  "mcpServers": {
    "percia": {
      "url": "https://playground.percia.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:PERCIA_API_KEY}" }
    }
  }
}
```

### Docs only (no key)

```
claude mcp add --transport http percia-docs https://playground.percia.ai/mcp/docs
```

Cursor and Claude.ai take the same URL. It also offers the task skills as `skill://<name>/SKILL.md` resources.

## Skills

Short task skills for coding agents: connect a camera, create a watch, build an agent, set up a webhook, debug a delivery, review events, plus the integrator rules in `percia`. Each is a plain file at `/skills/<name>/SKILL.md`, for example [/skills/percia/SKILL.md](/skills/percia/SKILL.md).

```
npx skills add <owner>/percia-cf --skill percia
```

Published pass rates for real coding agents against the public docs are on the [HTML page](/coding-agents).