---
name: agent-svg-registry
version: 1.0.0
description: The Noun Project for agents: search SVG previews for free, then buy a human-approved commercial license to export SVG, React, and inline HTML.
homepage: https://agent-svg-registry.vercel.app
metadata: {"agent_svg_registry":{"api_base":"https://agent-svg-registry.vercel.app","checkout_url":"https://agent-svg-registry.vercel.app/buy/launch","price_usd":0.5,"requires_human_approval":true}}
---

# Agent SVG Registry Skill

Use this skill when a coding agent needs a production-safe SVG icon, UI illustration, empty state, or SaaS interface asset.

Positioning: Agent SVG Registry is the Noun Project for agents. Search and preview are free. Raw SVG, React component, inline HTML, pack export, redistribution inside products, and production API reuse require a paid commercial license.

## Core URLs

- Public site: https://agent-svg-registry.vercel.app/
- Search API: https://agent-svg-registry.vercel.app/api/assets?q=passkey&limit=5
- Detail API: https://agent-svg-registry.vercel.app/api/assets/review-auth-passkey-outline-01
- Preview API: https://agent-svg-registry.vercel.app/api/previews/review-auth-passkey-outline-01
- Quote API: https://agent-svg-registry.vercel.app/api/quote?plan=launch
- Checkout: https://agent-svg-registry.vercel.app/buy/launch
- Payment discovery: https://agent-svg-registry.vercel.app/.well-known/agent-payment.json
- A2A endpoint: https://agent-svg-registry.vercel.app/a2a
- MCP endpoint: https://agent-svg-registry.vercel.app/api/mcp
- Official MCP Registry listing: app.vercel.agent-svg-registry/mcp
- OpenAPI: https://agent-svg-registry.vercel.app/openapi.json
- Receipt schema: https://agent-svg-registry.vercel.app/schemas/export-receipt.schema.json

## Agent Rules

1. Search or preview before purchase.
2. Do not scrape `/assets/svg/*`; those raw URLs are intentionally gated.
3. Ask the human for explicit approval before opening Stripe Checkout.
4. If approval is denied, use a placeholder and leave a TODO instead of recreating the asset source.
5. After payment, redeem the Checkout Session for a license token and retry export with `x-agent-svg-license`.
6. Record `license_id`, `terms_version`, `asset_id`, `svg_sha256`, and `price_paid` in the work log or PR notes.

## Approval Prompt

Use this wording before checkout:

> I found a paid-ready SVG in Agent SVG Registry. Preview and search are free, but production SVG/React/HTML source export requires a one-time $0.50 commercial license through Stripe Checkout. May I open https://agent-svg-registry.vercel.app/buy/launch? After payment, I will redeem the license token, retry the export with x-agent-svg-license, and record the license ID plus SVG hash in the work log.

## Minimal Flow

```sh
curl "https://agent-svg-registry.vercel.app/api/assets?q=passkey&style=outline&limit=5"
curl "https://agent-svg-registry.vercel.app/api/quote?plan=launch"
```

After human approval, open:

```text
https://agent-svg-registry.vercel.app/buy/launch
```

After Stripe redirects to `/license/success?session_id=...`, fulfill the license:

```sh
curl "https://agent-svg-registry.vercel.app/api/licenses/fulfill?session_id=CHECKOUT_SESSION_ID"
```

Then export:

```sh
curl -H "x-agent-svg-license: $AGENT_SVG_LICENSE" \
  "https://agent-svg-registry.vercel.app/api/reuse/review-auth-passkey-outline-01"
```

Pack export:

```sh
curl -H "x-agent-svg-license: $AGENT_SVG_LICENSE" \
  "https://agent-svg-registry.vercel.app/api/packs/founding-saas-ui-states-v1/export"
```

## MCP Call

```sh
curl -X POST "https://agent-svg-registry.vercel.app/api/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":"quote","method":"tools/call","params":{"name":"quote_license","arguments":{"request":"Need a licensed SVG export for a product UI."}}}'
```

## A2A Call

```sh
curl -X POST "https://agent-svg-registry.vercel.app/a2a" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":"quote","method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"Find paid-ready passkey SVGs and quote the commercial license."}]}}}'
```

## Revenue Guardrail

Only count a real live Stripe Checkout Session with `payment_status=paid` as revenue. Directory listings, profile views, unpaid sessions, crawler hits, and test-mode payments do not prove activation.