Developer tools

Build with SVG.new

Vectorize images, edit SVGs, and batch process — from your code, your AI agent, or your terminal.

Choose your integration

REST API

Call endpoints directly from any language. Bearer token auth, JSON in/out.

View endpoints

MCP Server

Connect to Claude Desktop, Cursor, or Windsurf via Model Context Protocol.

Setup guide

Claude Code Plugin

Full plugin with skills, MCP tools, and auto-updates via marketplace.

Install plugin

Quick Skill

One command to add /svg to Claude Code. No plugin needed.

Install skill

TypeScript SDK

Type-safe client for Node.js and the browser. Install from npm and start vectorizing in 3 lines.

View SDK docs

Quick start

Vectorize an image in one curl command.

1Get an API key from your Account page
2
export SVG_NEW_API_KEY="svk_your_key_here"
3
curl -X POST https://svg.new/api/agent/vectorize \
  -H "Authorization: Bearer $SVG_NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "data:image/png;base64,'$(base64 -i input.png)'"}'

API Reference

Endpoints

All endpoints require Authorization: Bearer svk_...

Model Context Protocol

MCP Server

Connect SVG.new to any MCP-compatible client — Claude, Claude Code, Cursor, Windsurf, and more. AI agents can discover and use vectorization tools automatically.

Hosted MCP endpoint

Connect to https://svg.new/api/mcp using Streamable HTTP. It accepts either of two credentials. Clients that support OAuth sign in with an SVG.new account: they discover it from https://svg.new/.well-known/oauth-protected-resource and register with dynamic client registration. Claude and Claude Code work this way; see the MCP server guide.

Or send an API key in the Authorization: Bearer svk_... header on every request:

{
  "mcpServers": {
    "svg-new": {
      "type": "http",
      "url": "https://svg.new/api/mcp",
      "headers": {
        "Authorization": "Bearer svk_your_key_here"
      }
    }
  }
}

Local MCP server

{
  "mcpServers": {
    "svg-new": {
      "command": "npx",
      "args": ["@svgnew/mcp"],
      "env": {
        "SVG_NEW_API_KEY": "svk_your_key_here"
      }
    }
  }
}

Available tools

create_upload
vectorize
vectorize_file
recolor_svg
simplify_svg
remove_background
remove_background_file
batch_vectorize
batch_vectorize_files
get_batch_status
list_vectorizations

create_upload is on the hosted server only. Full inputs, limits and per-client setup are in the MCP server guide.

Claude Code

Plugin

Full plugin with skills, MCP integration, and auto-updates. Install from the marketplace, or add it from the Claude directory.

/plugin marketplace add svgnew/plugin
/plugin install svg-vectorizer@svg-new-tools

Then run /mcp, pick the plugin's svg-new server and choose Authenticate to sign in with your SVG.new account. No API key needed.

Included skills

/svg-vectorizer:vectorize logo.png
/svg-vectorizer:recolor icon.svg
/svg-vectorizer:simplify icon.svg
/svg-vectorizer:remove-background art.svg
/svg-vectorizer:batch ./images/

Or just ask naturally — “vectorize this logo”, “convert all PNGs to SVG”, “change the red to blue”.

One-liner

Quick Skill Install

Don't need the full plugin? Add the /svg skill to Claude Code with one command.

mkdir -p ~/.claude/skills/svg-new && curl -s https://svg.new/skill.md -o ~/.claude/skills/svg-new/SKILL.md

Then use /svg in Claude Code or just say “vectorize this image”.

Credit costs

Every account can use the API. Free accounts get 3 credits a day; Pro ($9.99/mo) includes 1,000 credits a month.

OperationEndpointCost
Vectorize/api/agent/vectorize1 credit
Batch vectorize/api/agent/batch1 credit/image
Remove background/api/agent/edit/remove-background1 credit
Recolor/api/agent/edit/recolorFree
Simplify/api/agent/edit/simplifyFree
Batch status/api/agent/batch/{id}Free
Account and credits/api/agent/accountFree

Error codes

All errors return JSON with an error field.

StatusMeaningWhat to do
400Bad requestCheck image format and data URL
401UnauthorizedCheck your API key
402Payment requiredUpgrade or buy credits
429Rate limitedWait 60 seconds, max 10 req/min
500Server errorRetry once
504TimeoutImage may be too large

Ready to build?

Get your API key and start vectorizing in under a minute.