Connect · MCP server

Connect your AI to Wunderlust.

Wunderlust is a free MCP server. Your AI agent searches the stash of hand-picked sites, skills, UI components and AI tools and comes back with cards, links and caveats. No account, no key, read-only.

Server

https://wunderlust.xyz/api/mcp

Transport: Streamable HTTP. Authentication: none.

Pick your AI, easiest first

No setup at all

Open any card on wunderlust.xyz and click Use with AI. It builds a prompt you can paste into any chat.

Claude app and claude.ai · 1 click

Watch the 1-minute video, with the steps and screens, on one page.

1. Add Wunderlust to Claude
   The Wunderlust page in the Claude directory opens. Sign in to Claude if it asks, then click Connect. There is no link to paste.
2. Start a new chat and ask, for example: "Use Wunderlust to find sites with playful scroll motion." If Claude asks to use Wunderlust, click Allow.
3. Prefer to add it by hand? In Claude, open Customize, then Connectors, and click Add custom connector. Name it Wunderlust, paste the server link above and choose No sign in.

Cursor 1 click

1. Add to Cursor
   If your browser asks to open Cursor, click Open. In Cursor, click Install.
2. Nothing opened? In Cursor Settings, find MCP, add a new server and paste:

   {"mcpServers": {"wunderlust": {"url": "https://wunderlust.xyz/api/mcp"}}}

3. Open the chat with ⌘ L (Ctrl L on Windows) and ask for a site, a skill or an AI tool.

VS Code with GitHub Copilot · 1 click

1. Add to VS Code
   VS Code shows Wunderlust. Click Install.
2. Nothing opened? Press ⌘ Shift P, run MCP: Add Server, choose HTTP and paste the server link.
3. Open the chat with ⌃ ⌘ I (Ctrl Alt I), choose Agent and ask for a site, a skill or an AI tool.

Claude Code 1 click · 1 minute

1. Open Claude Code and connect
   A Terminal window opens with Claude Code and the request already typed. Press Enter and choose Yes when it asks to run the commands. It installs the Wunderlust plugin: the connector plus a skill that tells Claude when to use it. This link works after you have used Claude Code in Terminal once.
2. Did it not open? Open Terminal (Mac) or PowerShell (Windows) and run:

   claude plugin marketplace add wunderlustxyz/wunderlust
   claude plugin install wunderlust@wunderlust

   Inside Claude Code you can also type /plugin marketplace add wunderlustxyz/wunderlust and then /plugin install wunderlust@wunderlust. Prefer only the connector? Run claude mcp add --transport http --scope user wunderlust https://wunderlust.xyz/api/mcp.
3. Start a new session: type claude, press Enter and ask: "Use Wunderlust to find sites with playful scroll motion."

Codex 1 click · 1 minute

1. Open Codex and connect
   The Codex app opens a new thread with the request already typed. Press Enter and approve the commands. It installs the Wunderlust plugin: the connector plus a skill that tells Codex when to use it.
2. Using the Codex CLI, or did it not open? Run:

   codex plugin marketplace add wunderlustxyz/wunderlust
   codex plugin add wunderlust@wunderlust

   Prefer only the connector? Run codex mcp add wunderlust --url https://wunderlust.xyz/api/mcp.
3. Start a new thread and ask for a site, a skill or an AI tool.

ChatGPT developer mode · 2 minutes

1. On chatgpt.com, open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode. Not every plan has it.
2. Click Create, name it Wunderlust, paste the server link and choose No authentication.
3. In a new chat, click +, choose Developer mode, turn on Wunderlust and ask for a site, a skill or an AI tool.

Any other AI agent

Paste this request in your agent's chat. The agent adds Wunderlust for you:

Add the Wunderlust MCP server to your MCP settings so it works in all my projects.

URL: https://wunderlust.xyz/api/mcp
Transport: HTTP
Authentication: none
Setup guide: https://wunderlust.xyz/connect

When it is done, tell me how to reload you so the Wunderlust tools show up.

Or add it by hand: a server of type HTTP with the server link above and no authentication. This works in Windsurf, Gemini CLI, Cline, Lovable, Bolt and other apps with MCP.

Tools

All tools are read-only. They never change anything in your account or anywhere else.

search_references

Search by free text (English or Portuguese) or by category, tags, pattern or editorial pick. Returns a ranked list with a short description, the one idea worth exploring, the official link and the Wunderlust page.

get_references

Full detail for up to 20 cards: what each one is, typical uses, benefits, caveats, links, similar cards and, for some sites, a DESIGN.md with approximate design tokens. Design cards also say why the idea works and what to watch out for when you use it.

similar_references

Cards similar to one you already like.

random_references

A random selection, optionally within a category or tags.

show_references

Shows up to 12 chosen cards as a strip of visual cards with cover and short video, in apps that support it. Other apps get the same list as text.

list_facets

Every category, tag, pattern and editorial pick, with counts.

get_collection

Reads a collection someone shared from Wunderlust, as a brief.

get_examples

Returns a few design cards for a UI brief, with why each idea works, what to watch out for and, for some sites, approximate design tokens.

Answers with two or more cards include a board link that opens them side by side in the browser.

Answers carry the notes people see: why the idea works and what to watch out for on design cards, and a “Checked by Wunderlust” note on many skill and agent cards. Search also understands goals, like “loading screen”. The full list of what Wunderlust can do is on What Wunderlust can do.

Try asking

• "Use Wunderlust to find sites with playful scroll motion."
• "Find an open-source 3D library for a product page and tell me its caveats."
• "Show me award-winning portfolio sites with kinetic type."
• "I like GSAP. What is similar in Wunderlust?"
• "Surprise me with five AI tools from Wunderlust."

Your own collections

Signed in, you can create a private connector link in Connect your agent, so your agent also reads your own collections and briefs and, if you allow it, saves cards to your stash, with a short note if you ask it to. It never deletes, renames or shares anything. Open it on Wunderlust.

Limits and privacy

Up to 600 requests per hour per network. We do not keep what your agent asks. To stop abuse we keep a one-way code made from the IP address for up to 48 hours, never the address itself. Details in the privacy policy and the terms.

Help: hello@wunderlust.xyz