Logoforge MCP server
Commit Nov 8, 2026Lets an AI client search 1,025 brand logo SVGs and install them as typed React components or shadcn registry entries.
Also known as terravidhal/logoforge
- Stars
- 70
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 8, 2026
- License
- MIT
What is Logoforge MCP?
Logoforge lets an AI client search 1,025 brand logo SVGs and install them as typed React components or shadcn registry entries.
Summary generated from the project's README
About Logoforge MCP server
Finding and installing a brand logo for a developer tool usually means hunting for an SVG, cleaning it up, and wiring dark mode by hand. Logoforge catalogs 1,025 logos across 30 categories, including African brands such as MTN, Flutterwave, Paystack and M-Pesa, and turns each one into a typed React component delivered through the shadcn registry with a single command.
The MCP server runs remotely over HTTP and connects to Claude, Cursor, Windsurf or VS Code with a transport flag, no API key needed. Its tools are search_logos, list_categories, get_logo, get_logo_svg, get_logo_component and build_logo_cloud, so an AI client can search the set, pull a raw SVG, read the component source, or assemble a whole logo section in grid, marquee or bento layout and return the install command for every logo it imports.
Variants cover icon, icon-mono, icon-dark and wordmark, with dark files derived automatically and knockout monos for badge-style marks. Every variant records its upstream source and licence, and a JSON API serves the manifest without a key. Tooling is MIT; artwork is CC0 or brand-supplied.
What you can do with it
- 1Add a Stripe logo componentAsk the client to fetch the Stripe logo as a typed React component so it can be dropped into a pricing page without an extra package.
- 2Find African payment brand logosHave the client search for logos of payment providers like Paystack or Flutterwave that most logo collections skip.
- 3Grab a one-color mono markRequest a mono version of a logo that uses currentColor so it matches surrounding text styling.
- 4Check a logo's licenceHave the client look up a logo's entry to see which upstream file and licence it came from before shipping it.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableterravidhal/logoforge is public and reachablegithub.com/terravidhal/logoforge ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/terravidhal/logoforge ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubLogoforge
Brand logos for developers, as shadcn components.
1,025 clean SVG logos of the tools developers use — install any of them as a typed React component with one command, copy the SVG, or build a whole “Trusted by” logo cloud in seconds.
npx shadcn@latest add @logoforge/stripe
Website · Logo cloud builder · Categories · Docs · Request a logo
⭐ If Logoforge saves you a logo hunt, a star helps other developers find it.
Why Logoforge
- One command, one typed component.
npx shadcn add @logoforge/stripewritescomponents/logos/stripe.tsx— no package to install, no CSS touched, nothing but React.<StripeLogo />,<GithubLogo variant="mono" />,<VercelLogo type="wordmark" />: TypeScript only offers the variants a logo really has. - Dark mode that works. Near-black marks (GitHub, Vercel, Notion…) ship a dark file; the component switches with your
.darkclass — Tailwind v3 and v4, no JavaScript. - Mono that keeps its detail. Badge-style marks (Adobe apps, AWS services) get a knockout one-color version — the symbol cut out of its shape — not a solid blob.
- Logo clouds in one command. Pick logos on /cloud, choose grid, marquee or bento; one
shadcn addinstalls the section and every logo it imports. - African brands. MTN, Orange Money, M-Pesa, Flutterwave, Paystack, Moniepoint, OPay, Kuda, Chipper Cash, Yoco, Interswitch, Airtel, Orange, Andela — the brands most logo sets leave out.
- Built for AI editors. An MCP server lets Claude, Cursor, Windsurf or VS Code search and add logos for you.
- Every file is traceable. Each variant records its source, its exact upstream file and its licence.
Use it
shadcn CLI
@logoforge is in the official shadcn registry directory — no setup needed. Install any logo (slug = the logo page URL):
npx shadcn@latest add @logoforge/stripe @logoforge/supabase
{
"registries": {
"@logoforge": "https://logoforge.terravidhal.me/r/{name}.json"
}
}
import { StripeLogo } from "@/components/logos/stripe";
<StripeLogo className="size-8" /> // brand colors, auto dark mode
<StripeLogo variant="mono" className="size-6" /> // currentColor
<StripeLogo type="wordmark" className="h-6 w-auto" />
<StripeLogo mode="dark" /> // force a theme (no Tailwind needed)
<StripeLogo title="" /> // decorative: aria-hidden
SVG files
Every variant is a plain file: https://logoforge.terravidhal.me/logos/<slug>/<variant>.svg
| Variant | What it is | When |
|---|---|---|
icon |
The mark, brand colors | always |
icon-mono |
One color, currentColor |
most logos |
icon-dark |
For dark backgrounds | when the mark would vanish on dark |
wordmark / wordmark-dark |
The full lockup | when the brand has one |
Or grab them straight from this repository: logos/.
MCP server (Claude, Cursor, Windsurf, VS Code)
claude mcp add --transport http logoforge https://logoforge.terravidhal.me/mcp
Tools: search_logos, list_categories, get_logo, get_logo_svg, get_logo_component, build_logo_cloud.
Setup for every editor: docs/mcp.
JSON API
curl https://logoforge.terravidhal.me/api/logos.json # every logo
curl https://logoforge.terravidhal.me/api/logos/stripe.json # one logo, with sources
Static, no key, CORS open. Or read data/logos.json directly.
What's in this repository
logos/<slug>/*.svg optimized SVG files, one folder per logo
components/<slug>.tsx the generated React component (what the registry installs)
data/logos.json GENERATED manifest: names, aliases, categories, colors, variants, sources
data/curation.json which logos ship and where each comes from ← edit this
data/overrides.json reviewed fixes, each with its reason ← and this
data/additions/<slug>/ hand-sourced artwork + source.json (official or public domain)
data/backgrounds.json GENERATED badge detection for knockout monos
scripts/ the pipeline: import · analyze · check
reports/ import report + contact sheets for visual review
How the set is built
- Sources, pinned —
sources.lock.jsonfixes the Simple Icons version and the gilbarbara/logos commit. - Licence filter — CC0 only from the sets: Simple Icons icons published under another licence (CC BY, GPL, MIT…) are dropped. Brands no free set covers are added by hand in
data/additions/, public-domain files first, the brand's own artwork otherwise — each with itssource.json. - Optimize & vet — SVGO (viewBox kept, no fixed size, ids prefixed by slug); any script, event handler, embedded image or external reference is rejected.
- Variants — dark files are derived automatically (black ↔ white swap for knockout marks, near-black text to white, dark brand colors lightened to a 3:1 contrast, masks left untouched); monos come from Simple Icons, or are derived — as knockouts for badge marks detected in headless Chrome.
- Components — SVGR turns each variant into JSX; ids are suffixed per variant so several can share a page.
- Human review — every run writes contact sheets (
reports/review-NN.html); anything flagged must be looked at before it ships, and the decision is recorded indata/overrides.json.
npm install
npm run import # build logos/, components/, data/logos.json, reports/
npm run analyze # detect badge icons (needs Chrome; CHROME_PATH to override), then import again
npm run check # validate everything — runs in CI on every pull request
Sponsors
Logoforge is free and stays free. If it saves you time, you can support the project (pay what you want): your logo and link are added here as a thank-you.
No sponsors yet. Yours could be the first.
Contributing
Request a logo — open an issue with the brand name and a link to its official brand assets.
Add a logo from a free set:
- Add an entry to
data/curation.json:{ "slug": "acme", "si": "<simple-icons slug>", "gb": "<gilbarbara shortname>", "categories": ["devtools"] }. npm run import && npm run analyze && npm run import, then open the contact sheet inreports/and look at your logo on light and dark, in color and mono.- Fix anything off in
data/overrides.jsonwith areason, runnpm run check, open a pull request.
Add a logo no free set has: create data/additions/<slug>/icon.svg from a public-domain file or the brand's own website, plus a source.json (origin, page, file, license: public-domain or trademark, retrieved), and add "addition": true to its curation entry. Never trace a PNG: if no vector exists, the logo waits.
Categories are listed in data/categories.json.
Everyone taking part follows the Code of Conduct.
Star history
Licences and trademarks
- Tooling and data (scripts, components template, manifest): MIT.
- Artwork: from Simple Icons (CC0 1.0), gilbarbara/logos (CC0 1.0), Wikimedia Commons public-domain files, and — for a few brands no free set covers — the brands' own artwork. See CREDITS.md; every file's source is in
data/logos.json. - Trademarks: all product names, logos and brands are property of their respective owners. They are provided for identification only and their presence does not imply endorsement. A free licence on a file grants nothing on the brand: use a logo to refer to its product, and follow the brand's guidelines.
Brand owners: to remove or correct a logo, write from your company's domain to the address on logoforge.terravidhal.me/legal — handled within 72 hours.
Logoforge is free and open source. If it helped you, ⭐ star the repo — it's the best way to help other developers find it.
Built by Vidhal Elame · sibling of Blockforge
Logoforge MCP questions
How does an AI client connect to the Logoforge MCP server?
Add it as a remote HTTP MCP server in your editor; the README shows the Claude command and links setup docs for other editors.
What tools does the Logoforge MCP server expose?
It exposes tools to search logos, list categories, fetch a logo, its SVG or its component, and build a logo cloud.
How many logos does Logoforge include?
The gallery has 1,025 logos across 30 categories, covering AI, frameworks, databases, cloud, payments, learning, gaming and African brands.
Which logo variants are available as SVG files?
Each logo ships icon, mono icon, dark icon and wordmark files where the brand has one, fetchable from a predictable URL path.
Do I need an API key to use the JSON API?
No key is required; the JSON API is static with CORS open, and the whole set is also published as a manifest file.