
Inspo MCP Server: Real Website Designs for Claude, Cursor and Other Apps
Lets your coding assistant study real, shipped websites before it writes UI: palettes, fonts, layouts and reference code.
Inspo is a searchable archive of real production websites, and this server lets Claude, Cursor and other assistants look things up in it. They can pull a site's colours, fonts and layout, compare several sites, and copy reference React components. Use the free hosted address with no sign-up, or run it from npm on your computer. It only reads the archive, and the server tells the assistant to skip it when your project already has its own design system.
Good for
- Developers who let Claude or Cursor build landing pages and want better-looking results
- Designers who want real references with the palette and type behind them
- Founders building a marketing site with an AI assistant
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install inspo MCP
Any client
- 1
Run this in a terminal.
shellnpx -y inspo-mcp install
Requires Node.js.
Read-only mode: All 15 tools are read-only; the installer is the only part that writes files.
Run this in a terminal. It detects Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop and Zed, shows a plan and asks before changing anything. It runs claude mcp add or codex mcp add, code --add-mcp, or edits the client's JSON config and keeps a .inspo-backup copy. Claude Desktop always gets the npx stdio form; Zed's config is printed for you to paste. Add --dry-run to see the plan without writing, --client <id> for one client, --local for the npx form instead of the hosted URL.
From the project README. Source.
Tools
Builds a design moodboard from a brief
Takes your page brief and returns a layout style, five real sites that use it, matching reference components, a suggested palette and spacing and hero rules. It makes no model call of its own.
Try: “Plan a pricing page for a developer tool, then show me references.”
Network ·
recommendSearches the archive of site screenshots
Searches captured pages by words and filters such as style, industry, colour and device. Each result has the palette, fonts, tags and desktop and mobile image links.
Try: “Find dark editorial landing pages for a fintech startup.”
Network ·
search_screensOpens one captured page
Returns everything stored for one captured page: every viewport, palette, fonts, tech stack and the designer credit.
Try: “Show me the full record for the stripe.com home page.”
Network ·
get_screenGives a site's design tokens
Returns a site's real fonts, palette and CSS variables, type ramp and detected tech. When the stored data is thin it also fetches the site's HTML and CSS from the live page; you can switch that off.
Try: “Give me the design system of linear.app so I can copy its spacing.”
Network ·
get_design_systemCompares two to four sites
Puts two to four sites side by side and reports what they share, such as tags, layout style and scales.
Try: “Compare the type and palette of Vercel, Linear and Stripe.”
Network ·
compareFinds sites that look alike
Returns sites that look or are built like a given page, one result per site.
Try: “Show me sites that look like the Notion pricing page.”
Network ·
find_similarFinds sites near a colour
Takes a hex colour and returns real sites whose palettes are close to it, measured so the same colour family counts as close.
Try: “Which production sites use a palette near #1F4E3D?”
Network ·
find_by_colorFinds sites for a layout pattern
Returns real sites that use one named layout pattern, such as Bento Grid. It accepts the name or its slug.
Try: “Show me three real Bento Grid landing pages.”
Network ·
find_examples_for_macrostructureFinds sites with a given UI part
Returns sites that have a hero, pricing table, nav, footer, FAQ or similar part, with an image crop of it when there is one.
Try: “Find strong pricing sections from SaaS sites.”
Network ·
find_componentsLists the canonical reference components
Lists the curated reference components by id, label, layout pattern and a short note, for each hero, pricing, call to action, nav and footer type.
Try: “What reference hero components are available?”
Network ·
find_reference_componentsReturns the code of a reference component
Returns the full React JSX for one reference component, with a header naming its layout pattern, theme and states, ready to copy and adapt.
Try: “Get the JSX for the editorial hero reference.”
Network ·
get_reference_jsxShows a site's pages in order
Returns a site's captured pages in reading order, such as landing, pricing and features. With no argument it lists the sites that have a page flow.
Try: “Show how Linear orders its landing, pricing and features pages.”
Network ·
get_site_pagesLists accepted filter values
Takes no input and lists every valid style, industry, layout pattern, mode, vibe, colour, page type and component type, so later calls do not fail on a wrong word.
Try: “What filter values can I use with search_screens?”
Network ·
get_filtersLists curated collections
Lists the editor-curated collections, such as Editorial Layouts or Dark Product Pages, for browsing by theme.
Try: “What curated design collections exist?”
Network ·
list_collectionsOpens one curated collection
Returns one collection with the editor's note and its ordered list of screens.
Try: “Open the Dark Product Pages collection.”
Network ·
get_collection
Listed by the running server in our sandbox
Permissions
low risk · 5 things to watch
Low risk
Every tool only reads the archive, so nothing on your computer or accounts changes. One option fetches a public page's HTML and CSS from the server side, and the results can be large and cost context.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
The npm version caches about 14 MB on disk
It keeps the catalogue in your OS cache folder (~/.cache/inspo-mcp on Linux). Set INSPO_CATALOGUE_CACHE to 0 to turn the cache off. github.com
Images and long results use context
Thumbnails come back inline, and results are re-read on every later turn. Set INSPO_IMAGES to none or INSPO_MAX_TOKENS to keep responses small. github.com
Server instructions tell the assistant when to call it
The server's built-in instructions list when to call Inspo and when not to, and say your project's own design system wins. Read them if the assistant uses it too often. inspomcp.dev
get_design_system can fetch a live web page
When stored tokens are thin it fetches the source page's HTML and CSS, with no JavaScript run. The server only allows public named hosts on ports 80 and 443, and you can pass live as false. github.com
The hosted server logs each call
The hosted endpoint logs the tool name, success and duration for each call. It says it keeps no IPs or query text. The npm version sends no telemetry. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Every tool is marked read-only by the server. There is nothing to switch off. |
|---|---|
| Talks to | inspomcp.dev (hosted server). Catalogue CDN (npm version). Together AI embeddings, only if you set TOGETHER_API_KEY. Public pages for get_design_system live fetch |
| Sign-in and keys | No sign-in or API key. TOGETHER_API_KEY is optional. |
Questions
Is the Inspo MCP server official?
Yes, in the sense that the Inspo project publishes it from its own repo (Nutlope/inspo) for its own archive of website screenshots. It is not made by the sites in the archive. The repo's MIT license names Together AI and contributors as copyright holder.
Who runs the hosted server at inspomcp.dev?
The Inspo project, whose repo is github.com/Nutlope/inspo and whose site is inspomcp.dev. The README says the hosted route runs on Vercel and logs the tool name, success and duration of each call, never IPs or query text.
What is the Inspo MCP server URL?
https://inspomcp.dev/api/mcp. It is free and needs no sign-in.
Do I need an API key?
No. A key from Together AI is optional and only turns on query-embedding semantic search in the npm version. Everything else works without it.
Is there a one-command install?
Yes. The README says npx -y inspo-mcp install finds Claude Code, Cursor, Codex, VS Code, Windsurf, Zed and Claude Desktop, shows a plan and asks before it writes. It backs up files it edits, and --dry-run writes nothing.
Hosted or on my own computer?
Both are documented. The hosted address needs nothing installed. The npm package runs on your computer and downloads the catalogue from a CDN.
Can it change my files?
No. The tools only read the archive. Only the separate install command edits your client config files, and only after you confirm.
Why does the assistant sometimes skip it?
The server tells assistants not to use it when your project already has a design system or the design is fixed. The project's own conventions win.
Is it free?
Yes. The hosted endpoint is free, and the code is MIT licensed. The README gives the hosted server a limit of 120 requests a minute per IP on each warm server instance.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
inspo-mcp- Registry
- npm
- Endpoint
https://inspomcp.dev/api/mcp- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 0.1.16
- License
- MIT
- Last commit
- Oct 28, 2026
- Open issues
- 1
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 5Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- inspomcp.dev · inspomcp.dev
- www.npmjs.com · npmjs.com