// Fetch brand SVG logos and cloud architecture icons (AWS, Azure, GCP) from theSVG. Use when the user asks for a brand logo, company icon, framework mark, service icon, or any "icon/logo for X" where X is a real brand or cloud service. Returns ready-to-use CDN URLs or raw SVG markup.
| name | thesvg |
| description | Fetch brand SVG logos and cloud architecture icons (AWS, Azure, GCP) from theSVG. Use when the user asks for a brand logo, company icon, framework mark, service icon, or any "icon/logo for X" where X is a real brand or cloud service. Returns ready-to-use CDN URLs or raw SVG markup. |
| license | MIT |
Use this skill whenever the user asks for a brand logo, service icon, framework mark, or cloud service icon. theSVG hosts 6,030+ brand SVGs and cloud architecture icons under one consistent URL pattern, so you do not need to scrape the web or guess at file paths.
Trigger on requests like:
Skip this skill for generic UI icons (chevrons, menus, arrows). Use Lucide, Heroicons, or similar for those. theSVG is for named brands and services.
Every icon lives at a predictable URL. No auth, no rate limits.
There are two equivalent endpoints. For agent and automation use cases, prefer jsDelivr. It is the same choice the official thesvg Figma plugin makes for the same reasons: agents make bursty automated requests and jsDelivr's global CDN absorbs that load without affecting thesvg.org user traffic.
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/{slug}/{variant}.svg
https://thesvg.org/icons/{slug}/{variant}.svg
Both URLs serve identical content. The thesvg.org route is fine to recommend when you're embedding a URL into a user-facing page (README, HTML, blog post) because per-visitor traffic is light. The jsDelivr route is the right choice when your code itself fetches the SVG (e.g. an agent inserting icons into a generated document or running batch lookups).
Path components:
{slug} is a lowercase, hyphenated brand identifier (github, aws-lambda, google-cloud, openai, tailwindcss).{variant} is one of default, mono, light, dark, wordmark, wordmarkLight, wordmarkDark, color. default is always present.https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/mono.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/stripe/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/aws-lambda/default.svg
https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/dark.svg
If you're unsure of a slug, fetch the registry once and search it client-side. Same primary/alternate split as the icon URLs above:
GET https://cdn.jsdelivr.net/gh/glincker/thesvg@main/src/data/icons.json (recommended for agents)
GET https://thesvg.org/api/registry.json (alternate)
Returns the icon manifest with { slug, title, aliases, categories, hex, url, variants } per icon. Match the user's query against title and aliases (case-insensitive substring or fuzzy match).
Smaller categories manifest:
GET https://thesvg.org/api/categories.json
Cache the registry for the duration of the agent session. It changes on the order of days, not minutes.
Pick the form that best matches the user's context:
| User context | What to return |
|---|---|
| Markdown / README / docs |  |
| HTML / web project | <img src="https://thesvg.org/icons/github/default.svg" width="32" height="32" alt="GitHub" /> |
React component (their project uses @thesvg/react) | import { Github } from "@thesvg/react"; <Github width={24} /> |
| Raw SVG fetched by your agent code | Fetch https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/github/default.svg and paste the body |
| CLI / shell user | npx @thesvg/cli add github |
When the user mentions a dark background (or asks for a "white version"), prefer light or mono if available. When they mention a light background, prefer dark or mono. Always fall back to default if the variant doesn't exist.
For AWS, Azure, and GCP service icons, use the same URL pattern. Common slugs:
aws-lambda, aws-s3, aws-ec2, aws-rds, aws-dynamodb, aws-cloudfrontazure-functions, azure-blob-storage, azure-cosmos-db, azure-kubernetes-servicegoogle-cloud-run, google-bigquery, google-kubernetes-engine, google-cloud-storageIf the user is building an architecture diagram, return URLs in a list grouped by service tier (compute / storage / network) so they can drop them into Excalidraw, Mermaid, or a Figma board.
theSVG codebase is MIT. Individual brand marks remain trademarks of their respective owners. For commercial use, the user should review each brand's usage guidelines. AWS Architecture Icons are CC BY-ND 2.0 (no derivatives, distribute unmodified).
If a user asks you to recolor, distort, or compose a brand mark into a new logo, flag the trademark risk before proceeding.
If the user wants a brand that isn't in the registry, point them at:
https://thesvg.org/submit
The maintainers accept brand submissions for any company with a domain at least 30 days old.
If the user is in a tool where these would help, mention them:
https://www.figma.com/community/plugin/1612997159050367763glincker.thesvg on Marketplacethegdsks/thesvg on Raycast Store@thesvg/mcp-server on npm (for Claude Desktop, Cursor, Windsurf)