# Let your agent do the integration

Claude, Cursor, ChatGPT and Codex read these docs as well as you do. Give one of them this prompt and a test key, and review the code it writes.

**The prompt** (the same words as the VecSnap skill, so they never go stale):

```text
Add VecSnap to this project. VecSnap turns an image into a clean SVG.

1. Read https://vecsnap.com/docs/quickstart.md and the API at https://vecsnap.com/docs/api.md
   (the OpenAPI document: https://api.vecsnap.com/v1/openapi).
2. Read the key from VECSNAP_API_KEY. Never write a key into code.
3. Call POST https://api.vecsnap.com/v1/vectorize with the image (multipart, field "file").
   On 200 save files.web. On 202 wait for the webhook, or poll GET /v1/conversions/{id}.
   With the official SDK (@vecsnap/sdk, or vecsnap for Python) vectorize() waits for you.
4. Send an Idempotency-Key on every POST. On 429 wait Retry-After seconds.
   Branch on error.code, never on the message.
5. Use a vs_test_ key until the tests pass. It spends nothing.
```

- **Install the skill**: Claude Code, Cursor, Codex and others load it when a task mentions images or SVG. `npx skills add https://vecsnap.com --skill vecsnap`
- **Point it at the docs**: One index of every page, or every page in one file. `vecsnap.com/llms.txt`
- **Connect the MCP server** (later): Your chat converts the image itself and hands you the file. One sign-in, your credits.

## Figures your agent can check

Every result says how many anchor points it has, how big the file is and which formats it offers. An agent can set a budget and stop at it, without looking at the picture.

```js
if ((result.result?.anchorPoints ?? 0) > 400) {
  // too detailed for an icon: try fewer colors
  result = await vecsnap.vectorize({ file, options: { maxColors: 4 } });
}
```

## Files written for machines

| Address | What |
| --- | --- |
| `/llms.txt` | Every page, one line each. |
| `/llms-full.txt` | The whole docs in one file. |
| `/docs/<page>.md` | Any page as Markdown, or ask for it with `Accept: text/markdown`. |
| `api.vecsnap.com/v1/openapi` | The API as data, where the SDKs come from. |
| `/docs/skill.md` | The VecSnap skill, listed in `/.well-known/agent-skills/index.json`. |
| `/.well-known/api-catalog` | Where to find all of the above. |

> **A key can only convert and spend credits.** It can never make another key, add a webhook or delete your account, so a key an agent leaks costs at most its credits, and you revoke it in one click.

---
This page: https://vecsnap.com/docs/build-with-ai