Docs menuMCP overview

AI integration

TheSeeker Reference MCP server

AI tools such as Claude, Cursor and Codex search the UI design references collected in TheSeeker Reference directly, and read as much of their analysis, context and images as they need.

POSTEndpointhttps://ref.theseeker.io/mcp

MCP (Model Context Protocol) is a standard that connects AI tools to outside data. Register the server once, and during a conversation the agent can look through tags, find references that match, check their images and answer with links to the originals.

This is a public, read-only server, so no authentication is needed. It only reads the references and images published in the web gallery.

Web gallery and MCP

The same data, presented to people and to AI agents in the way that suits each.

AspectWeb galleryMCP
AudiencePeople browsing referencesAI agents connected through an MCP client
AccessBrowse and search in a browserTool calls the agent makes during a conversation
Addresshttps://ref.theseeker.iohttps://ref.theseeker.io/mcp
OutputCard grids and detail pagesJSON results and image content blocks

Prerequisites

  • An AI client that supports MCP. Connection steps for each client follow below.
  • A network that can reach ref.theseeker.io
  • No account or API key. Connect right away, with no sign-up or token.

Connect

Pick the client you use and register the server as described. In every client, name the server ref.

  1. Run the command in a terminal.

  2. Check the tool list in Claude Code.

bash
claude mcp add --transport http ref https://ref.theseeker.io/mcp

The full request format and curl examples are in the endpoint spec of the tool reference.

Once connected, ask the agent to “show me the TheSeeker Reference MCP tools” to check the connection right away.

Lookup flow

Agents usually find references in five steps. The more each result narrows the arguments of the next call, the faster and more accurate the answers get.

  1. Check tags and categories list_tags

    Explores public reference counts by category, and the tags. Narrow the tags by category or search term.

  2. Search for matching references search_references

    Finds public references by keyword, tag, category and designer. Each result carries a preview image and the original page URL.

  3. Compare candidates on one sheet get_contact_sheet

    Puts up to 16 candidate references on one image for comparison. Each cell shows its reference id.

  4. Read only the sections you need get_reference

    Reads only the parts of a reference you pick: analysis, media, original post, designer and similar work.

  5. View images of the chosen references get_reference_images

    Shows the images and video posters of chosen references directly. An error on one image does not block the others.

Images take up a lot of conversation context. Gather candidates widely (15–20), compare the best 16 at most on one get_contact_sheet or split them across two, and request original images in small or medium size only for the 3–5 you will actually use. One call returns up to 6 images.

Available tools

Every tool is read-only. Select a tool name for its arguments and response examples.

ToolWhat it does
search_referencesFinds public references by keyword, tag, category and designer. Each result carries a preview image and the original page URL.
get_referenceReads only the parts of a reference you pick: analysis, media, original post, designer and similar work.
get_reference_imagesShows the images and video posters of chosen references directly. An error on one image does not block the others.
get_contact_sheetPuts up to 16 candidate references on one image for comparison. Each cell shows its reference id.
list_tagsExplores public reference counts by category, and the tags. Narrow the tags by category or search term.
list_authorsShows the bio and reference count of every designer with public references.

Example prompts

Once connected, try asking the agent something like this.

  • Find dark-mode fintech dashboards in TheSeeker Reference and summarize the layout patterns they share.
  • Gather a wide set of bento-grid landing pages, compare them on a contact sheet, pick 3 and look at their images, then suggest a hero section that fits our product.
  • Find the 3 designers with the most references and compare their styles.

Best practices

Check tags first

Use list_tags to see the tag slugs actually in use, then pass them in tags of search_references. A tag that does not exist returns no results.

Include only the sections you need

Put only the sections you need in include of get_reference. The available values are analysis, media, tweet, author, similar; the less you request, the lighter the response.

Look wide, open originals for only 3–5

Compare up to 16 candidates on one sheet with get_contact_sheet, then call get_reference_images in small or medium size only for the 3–5 references you will actually use. Original images take up a lot of conversation context.

Cite pageUrl

Include the pageUrl that comes with each result in your answer, so readers can open the original reference right away.

Search in Korean or English

Titles and summaries are in Korean, and English fields such as titleEn and summaryEn are indexed too. Both “대시보드” and “dashboard” find results.

When it connects, the server tells the agent the order to use the tools in and what to watch for, so the agent follows the flow above without a separate system prompt.

Limits and errors

Each IP can make up to 120 requests per 60 seconds. Past the limit the server returns HTTP 429 with a Retry-After header; wait that long, then try again.

Image limits

Images per call4 by default, up to 6
Per imageUp to 5 MiB
Per call in totalUp to 15 MiB
Image fetch timeout10 seconds

Error codes

CodeLayerMeaning
RATE_LIMITEDTool resultContact sheet build and queue capacity is full; retry shortly.
NOT_FOUNDTool resultThe requested reference does not exist or is not public.
VALIDATIONTool resultA value passed to the tool is outside the allowed range or format.
INTERNALTool resultSomething went wrong during the lookup. Try again shortly.
400/-32600HTTP responseAt most one get_contact_sheet call is allowed per batch.
405HTTP responseHTTP method not allowed. Use POST for tool calls.
406HTTP responseInclude both application/json and text/event-stream in the Accept header.
429/-32029HTTP responsePer-minute request limit exceeded. A batch counts once per tools/call (at least once). Retry after the time given in Retry-After.

Disconnect

Remove the ref entry from your client settings. The server has no sessions or tokens to revoke.

  • Claude Code: claude mcp remove ref
  • Claude Desktop: Delete the ref connector under Settings → Connectors.
  • Cursor: Delete the ref entry, then reload.
  • VS Code: Delete the ref entry from servers.
  • Codex: Delete the [mcp_servers.ref] block.
  • opencode: Delete mcp.ref, or set enabled to false.
  • Windsurf: Delete the ref entry from mcpServers.
  • Gemini CLI: Delete the mcpServers.ref entry.
  • curl: The server is stateless, so there is no connection to remove.