MCP is not open yet. These pages are ready for when it opens. You can make an agent key now; it starts working when MCP opens. Until then the address below does not answer.
Use Adaver in VS Code
VS Code can use MCP tools in GitHub Copilot Chat, in agent mode. After this setup, the agent can turn a PNG, JPEG or WebP image into an SVG. Each trace spends 1 image from your Adaver account.
1. Make an agent key
Account page (/account on adaver.nuvai.dev) → Agent keys → Make a key. Copy the key (it starts with adk_). We show it only once. Details: Make an agent key.
2. Add Adaver to VS Code
Create the file .vscode/mcp.json in your project. You have two choices.
Choice A (recommended): VS Code asks for the key. The key is not written in the file, so the file is safe to commit.
{
"inputs": [
{
"type": "promptString",
"id": "adaver-key",
"description": "Adaver agent key (starts with adk_)",
"password": true
}
],
"servers": {
"adaver": {
"type": "http",
"url": "https://api.adaver.nuvai.dev/mcp",
"headers": {
"Authorization": "Bearer ${input:adaver-key}"
}
}
}
}VS Code asks for the key the first time the server starts, and keeps it for you.
Choice B: the key in the file. This is the text the account page shows with a Copy button. Put your key in place of adk_YOUR_KEY_HERE.
{
"servers": {
"adaver": {
"type": "http",
"url": "https://api.adaver.nuvai.dev/mcp",
"headers": {
"Authorization": "Bearer adk_YOUR_KEY_HERE"
}
}
}
}| Choice | Good | Bad |
|---|---|---|
| A: VS Code asks | The key never sits in the project. Safe to commit. | One more step the first time. |
| B: key in the file | Simple. | Never commit this file. Add .vscode/mcp.json to .gitignore. |
Never commit a file with a real key. Anyone who sees it can spend your images.
Then start the server: open .vscode/mcp.json and press Start above adaver, or run the command MCP: List Servers. Open Copilot Chat, choose Agent mode, and check that the Adaver tools are in the tools list.
3. Try it
Start with a free call. Ask the agent:
Use the adaver tools. List the vectorize presets, then show how many images I have left.You should see five presets and your balance. Neither call costs an image.
Then trace an image (this spends 1 image):
Vectorize https://example.com/logo.png with adaver and save the SVG as logo.svg.Use a public https address of your own image. A small local file also works: the agent can send it as base64 (up to about 3 MB).
4. See what you spend
| How | What you see |
|---|---|
| Ask the agent: "Show my Adaver balance" | The get_balance tool: images left, images held by running calls, the free image |
| Account page → Agent keys | Each key's daily limit and when it was last used |
Every finished trace also says "charged": true or false.
5. Daily limit and confirm mode
- Daily limit. Each key has "Images per day" (1 to 200, default 20). When a key reaches it, calls get
daily_cap_reachedand nothing is charged. Change it on the account page (Agent keys → Edit). Raising it asks for your password. - Confirm mode. A key in confirm mode never charges on the first call. It gets a price quote first, and the agent must ask you. A client that supports MCP questions (elicitation) shows this as a yes/no box. The account page does not have a switch for confirm mode yet, so keys made there have it off.
More: Spend and privacy.
6. Revoke the key
Account page → Agent keys → Revoke → Yes, revoke it. The key stops at once. Then delete the adaver part from .vscode/mcp.json. With choice A, the revoked key that VS Code saved no longer works, so it can do no harm.
Common errors
Every error has a request_id. Send it to us if you need help.
| You see | What it means | What to do |
|---|---|---|
401 / unauthenticated | The key is wrong, revoked, expired, or is not an agent key | Check that the header says Bearer and then the key. Make a new key if needed. |
| A tool is missing | The key does not have that permission (vectorize or balance) | Make a key with the permission you need. |
insufficient_images | No images left (or the free image needs a verified email) | Buy images, or verify your email. |
daily_cap_reached | This key used its daily limit | Wait until resets_at, or raise the limit. |
confirmation_required | The key is in confirm mode | Say yes, and the agent sends the call again with the confirm_token. |
fetch_failed | Adaver could not download the image_url | Use a public https address that serves the image itself. |
too_many_requests, too_many_jobs, busy | Too much at once | Wait retry_after_secs, then try again. |
mcp_disabled (HTTP 503) | The MCP door is switched off for now | Try again later. |
The full list is in the tool reference.

