Inspo MCP server
online · 100% uptimeio.github.Nutlope/inspo·v0.1.16·828 starsReal production websites for coding agents: palettes, fonts, fold autopsies and reference JSX.
828 stars1.8k downloads/wk
Reviews
Write oneNobody has reviewed Inspo yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Inspo tools (15)
write = sends, deletes, buys or postscompareFreeCompare 2-4 captured sites across palette, typefaces, macrostructure, mode, style tags, type/spacing/radius scales and container width. Returns per-site breakdowns plus what they share - triangulates a house style from a few references.
find_by_colorFreeReal sites whose extracted palette sits near a hex colour (OKLAB distance, so 'close' means the same colour family, not just the same hue). Use when a brief names a brand colour.
find_componentsFreeReal sites featuring a specific UI component (hero, pricing, features, cta, nav, footer, testimonial, logo-cloud, faq, stat), with a per-element crop where one exists. For copy-pasteable code use get_reference_jsx.
find_examples_for_macrostructureFreeReal sites exemplifying one of the 19 named macrostructures. Call it at the macrostructure-pick step. Accepts slugs ('bento-grid') or display names ('Bento Grid').
find_reference_componentsFreeThe canonical reference components as an index: id, label, macrostructure and a note for each hero / pricing / cta / nav / footer archetype. Pick one, then get_reference_jsx(type, id) for its source.
find_similarFreeA screen's nearest design neighbours - ranked by design-similarity embeddings where available, else by macrostructure / industry / style overlap. One result per site.
get_collectionFreeFetch one issue by slug, including the editor's blurb and ordered screen list.
get_design_systemFreeThe full DESIGN.md for one screen - real fonts, frequency-ranked palette, CSS variables, detected tech, colour roles, type ramp. Thin captured tokens are supplemented by a live fetch of the source; `live=false` skips that.
get_filtersFreeEvery value the filters accept: styles, industries, macrostructures, modes, vibes, colors, page types, component types. Zero input. Call it when unsure - an out-of-vocabulary value errors.
get_reference_jsxFreeThe full canonical JSX source for one reference component, including the header stamp naming its macrostructure / theme / states. Copy-pasteable; tweak tokens to the target brand.
get_screenFreeFetch the full record for one screen by slug - every viewport variant, palette, fonts, tech stack, designer credit.
get_site_pagesFreeA site's captured pages as an ordered flow (landing → pricing → features → ...) with titles, northstars and thumbnails - how a real product sequences its pages. No arguments returns the directory of flow-capable sites. Accepts a site or screen slug.
list_collectionsFreeList every editor-curated issue. Use this for thematic browsing - e.g. all 'Editorial Layouts' or 'Dark Product Pages'.
recommendFreeOrchestrator - start here for a brief. One call returns a macrostructure pick, 5 real exemplars, matching reference components (source via get_reference_jsx), a palette suggestion, and an `evidence` packet measuring the genre's paper band / display class / accent hue. Pass a macrostructure to skip the pick step. No LLM call.
search_screensFreeSearch the archive of real website screenshots. Returns screens with palette, fonts, components and image URLs.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- Live reliabilityremote reachable in 485ms20/20
- Tool poisoning15 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evalinspo-mcp.mjs: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
How Inspo compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 48,255 servers
- Tools
- 15
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 164 ms
- faster than 70% of 30,031 servers
- GitHub stars
- 828
- more than 95% of 28,688 servers
- Downloads a week
- 1,806
- more than 95% of 12,191 servers with a package
What its tools let an agent do: 15 read
Install Inspo in Claude Code, Cursor or VS Code
claude mcp add --transport http inspo https://inspomcp.dev/api/mcp
What the publisher says
From the Inspo repository's README, as published. We do not edit it. Read it on GitHub
Inspo
Real production websites your coding agent can study, over MCP, before it writes UI. inspomcp.dev
With and without
Same brief, same model, no design skill on either run. The only difference: the page on the right was built with Inspo MCP on the session.
That gap is the product. Agents have tools but not taste, and the open web already holds every reference they need: Inspo assembles, tags, and addresses it.
What's inside
- 2,320 pages across 832 real sites, each captured on desktop and mobile, with traced palettes, real fonts, detected tech, and a fold-by-fold autopsy on every page.
- 68 canonical reference components (heroes, pricing, footers, navs, and more), each demonstrating one named macrostructure, with copy-pasteable JSX.
- A DESIGN.md for every site, extracted from its DOM: semantic palette roles, type ramp, spacing scale, CSS variables, container width.
Fifteen tools expose all of it; recommend(brief) composes most of them into one call. The full tool table lives in apps/mcp/README.md.
Tech stack
- TypeScript MCP server with two transports: stdio via npm, and Streamable HTTP served by the site's own Vercel deployment. No database at query time; the catalogue ships as a static seed.
- Next.js 16 + Tailwind v4 gallery: the archive browser and the curator dashboard.
- Playwright capture worker: desktop and mobile shots, palette, type ramp and CSS variable extraction, tag and autopsy passes via Together AI.
- Together AI embeddings behind semantic search and find_similar.
- A smoke harness that boots the server in-process and exercises the core tools.
Cloning & running
- One command, any client: npx -y inspo-mcp install (detects Claude Code, Cursor, Codex, VS Code, Windsurf, Zed, Claude Desktop and writes the config; --dry-run shows the plan)
- Or point a client at the hosted endpoint yourself: claude mcp add --transport http inspo https://inspomcp.dev/api/mcp
- Or clone: git clone https://github.com/Nutlope/inspo.git && cd inspo && pnpm install
- Gallery: pnpm dev, then open localhost:3000
- Dev loop: pnpm --filter @inspo/mcp test
Per-client snippets (Cursor, Windsurf, Zed, Claude Desktop) are on the MCP page; the self-host runbook is DEPLOY.md.
Roadmap
- [ ] show the desktop and mobile capture side by side on every screen page
- [ ] backfill component crops so find_components returns a crop for every hit
- [ ] paginate the list tools instead of capping them
- [ ] re-shoot the mobile set at retina scale
- Accounts and paywalls are skipped on purpose: the archive is more useful free.
Want a site in the archive? Append it to apps/worker/src/seed-urls.ts and open a PR. The bar: does it make the archive better for someone building a website?
Security
Every tool is read-only. The one path that touches the outside world - getdesignsystem(live:true), which supplements thin captured tokens from the screen's own source - passes each URL and redirect through an SSRF guard: public named hosts only, ports 80 and 443, byte-capped body, no JS execution. The hosted endpoint logs tool name, success and duration per call, never IPs or query text.
MIT, copyright Together AI and contributors. The screenshots remain the work of their designers: every screen credits and links its source, and takedowns are honoured at /dmca.
Nothing above is checked by us. What we check is on the safety report.
Inspo: common questions
- Is Inspo MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Inspo safety report
- How do I install Inspo?
- It runs remotely at inspomcp.dev. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Inspo need an API key?
- Yes. The registry entry asks for
TOGETHER_API_KEY. - Is Inspo maintained?
- The last commit was 33 days ago (2026-10-01). The latest release is v0.1.16.
- Is Inspo up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Inspo compare with other MCP servers?
- safety score 88/100 (higher than 75% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.