# Agent SVG Registry Full Agent Guide

Agent SVG Registry is an agent-native SVG source registry for coding agents building product interfaces.

## Core Links

- Homepage: https://agent-svg-registry.vercel.app/
- Agent pack: https://agent-svg-registry.vercel.app/agent-pack
- Installable agent skill: https://agent-svg-registry.vercel.app/skill.md
- ClawHub/OpenClaw SKILL.md alias: https://agent-svg-registry.vercel.app/SKILL.md
- Agent skill manifest: https://agent-svg-registry.vercel.app/skill.json
- Agent offer JSON: https://agent-svg-registry.vercel.app/agent-offer.json
- Agent discovery manifest: https://agent-svg-registry.vercel.app/.well-known/agent-discovery.json
- ADP provider record: https://agentdiscovery.io/api/adp/v2/agents/did%3Aadp%3Ae2d11f6a-3cce-4056-92c9-ac09ba2d71bb
- BasedAgents registration manifest: https://agent-svg-registry.vercel.app/basedagents.json
- A2A agent card: https://agent-svg-registry.vercel.app/.well-known/agent-card.json
- A2A JSON-RPC endpoint: https://agent-svg-registry.vercel.app/a2a
- A2A tasks/send alias: https://agent-svg-registry.vercel.app/a2a/tasks/send
- A2A native message:send alias: https://agent-svg-registry.vercel.app/message:send
- REST invoke endpoint: https://agent-svg-registry.vercel.app/invoke
- Agent commerce manifest: https://agent-svg-registry.vercel.app/.well-known/agent-commerce.json
- OpenAPI: https://agent-svg-registry.vercel.app/openapi.json
- MCP manifest: https://agent-svg-registry.vercel.app/mcp/manifest.json
- MCP install JSON: https://agent-svg-registry.vercel.app/mcp/install.json
- Root MCP client config: https://agent-svg-registry.vercel.app/mcp.json
- MCP JSON-RPC endpoint: https://agent-svg-registry.vercel.app/api/mcp
- MCP wrapper install guide: https://agent-svg-registry.vercel.app/mcp-install.md
- MCP wrapper tarball: https://agent-svg-registry.vercel.app/downloads/agent-svg-registry-mcp-0.1.0.tgz
- Official MCP Registry listing: app.vercel.agent-svg-registry/mcp
- Quote endpoint: https://agent-svg-registry.vercel.app/api/quote?plan=launch
- Checkout: https://agent-svg-registry.vercel.app/buy/launch
- Machine-readable checkout brief: https://agent-svg-registry.vercel.app/checkout.md
- Demo trace: https://agent-svg-registry.vercel.app/agent-flow.md
- Paid receipt example: https://agent-svg-registry.vercel.app/examples/receipt.paid.example.json
- Declined receipt example: https://agent-svg-registry.vercel.app/examples/receipt.declined.example.json

## Agent Policy

Search and preview are free. Production source export requires a paid commercial license.

The launch license is $0.50 USD, one time. Agents must ask the human for explicit approval before opening checkout or requesting payment.

Approval copy:

> This task needs a licensed SVG export; price is $0.50 total, non-recurring, and I need human approval before checkout. If approved, I will attach the license ID, receipt, and SVG hash in the PR so the asset is auditable.

Preferred approval prompt:

> 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.

If the human declines, use a placeholder and leave a TODO instead of exporting, scraping, redrawing, or shipping an unlicensed SVG.

## Discovery Calls

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

## Agent Purchase Flow

1. Search or preview first: https://agent-svg-registry.vercel.app/api/assets?q=passkey&limit=5
2. Ask the human with the preferred approval prompt above.
3. Only after approval, open Stripe Checkout: https://agent-svg-registry.vercel.app/buy/launch
4. After Checkout success, redeem the license: https://agent-svg-registry.vercel.app/api/licenses/fulfill?session_id={CHECKOUT_SESSION_ID}
5. Retry export with `x-agent-svg-license`.

## A2A Message

```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."}]}}}'

curl -X POST "https://agent-svg-registry.vercel.app/a2a/tasks/send" \
  -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."}]}}}'
```

## REST Invoke

```sh
curl -X POST "https://agent-svg-registry.vercel.app/invoke" \
  -H "content-type: application/json" \
  -d '{"input":"Find paid-ready passkey SVGs and quote the commercial license.","capability":"licensed-svg-export"}'
```

## MCP JSON-RPC

```sh
curl -X POST "https://agent-svg-registry.vercel.app/api/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":"tools","method":"tools/list"}'

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 commercial SVG export."}}}'
```

Install local MCP wrapper:

```sh
npm install -g https://agent-svg-registry.vercel.app/downloads/agent-svg-registry-mcp-0.1.0.tgz
```

## Licensed Export

After human-approved Stripe Checkout returns a license token:

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

Store the license token only in the user's local project or secret store. Include `license_id`, `checkout_session_id`, `terms_version`, and `svg_sha256` in PR notes.

## Receipt Schema

Receipt schema: https://agent-svg-registry.vercel.app/schemas/export-receipt.schema.json

Paid receipt example: https://agent-svg-registry.vercel.app/examples/receipt.paid.example.json

Declined receipt example: https://agent-svg-registry.vercel.app/examples/receipt.declined.example.json

Important fields:

- `license_id`
- `checkout_session_id`
- `terms_version`
- `asset_id`
- `svg_sha256`
- `price_paid`
- `currency`
- `approval.status`

## Fake-Traction Guardrail

Do not count crawls, manifest fetches, directory listings, profile views, or unpaid Checkout Sessions as revenue. Activation is a real paid production Checkout Session followed by export with a license token.