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
Claude Code Plugin
Full plugin with skills, MCP tools, and auto-updates via marketplace.
Install pluginTypeScript SDK
Type-safe client for Node.js and the browser. Install from npm and start vectorizing in 3 lines.
View SDK docsQuick start
Vectorize an image in one curl command.
export SVG_NEW_API_KEY="svk_your_key_here"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_uploadvectorizevectorize_filerecolor_svgsimplify_svgremove_backgroundremove_background_filebatch_vectorizebatch_vectorize_filesget_batch_statuslist_vectorizationscreate_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-toolsThen 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.mdThen 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.
| Operation | Endpoint | Cost |
|---|---|---|
| Vectorize | /api/agent/vectorize | 1 credit |
| Batch vectorize | /api/agent/batch | 1 credit/image |
| Remove background | /api/agent/edit/remove-background | 1 credit |
| Recolor | /api/agent/edit/recolor | Free |
| Simplify | /api/agent/edit/simplify | Free |
| Batch status | /api/agent/batch/{id} | Free |
| Account and credits | /api/agent/account | Free |
Error codes
All errors return JSON with an error field.
| Status | Meaning | What to do |
|---|---|---|
400 | Bad request | Check image format and data URL |
401 | Unauthorized | Check your API key |
402 | Payment required | Upgrade or buy credits |
429 | Rate limited | Wait 60 seconds, max 10 req/min |
500 | Server error | Retry once |
504 | Timeout | Image may be too large |