design_search_references

Search design platforms like Dribbble and Behance for UI inspiration, case studies, and design system documentation to inform your creative projects.

Instructions

Web search scoped to design platforms. Returns article titles, snippets, and links. Better than image search when you want case studies, write-ups, or design system documentation.

Input Schema

TableJSON Schema

Name	Required	Description
`query`	Yes	UI design search query. Examples: "best dashboard designs 2025", "mobile navigation patterns"
`sites`	No	Filter to specific design sites. Empty array searches all sites.
`num`	No	Number of results to return (1-20, default: 10)

Implementation Reference

src/index.ts:246-278 (handler)

The handler function for the `design_search_references` tool which performs the web search using `serperRequest` and formats the output.

}, async (params: SearchReferencesInput) => {
  try {
    const siteQuery = buildSiteQuery(params.query, params.sites);
    const data = await serperRequest<SerperSearchResponse>("/search", {
      q: siteQuery,
      num: params.num,
    });

    const results = data.organic || [];
    const text = formatSearchResults(results, params.query);

    return {
      content: [{ type: "text" as const, text }],
      structuredContent: {
        query: params.query,
        count: results.length,
        results: results.map((r) => ({
          title: r.title,
          link: r.link,
          snippet: r.snippet,
          position: r.position,
        })),
      },
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text" as const,
          text: error instanceof Error ? error.message : `Error: ${String(error)}`,
        },
      ],
    };

src/index.ts:236-245 (registration)

Registration of the `design_search_references` tool with its title, description, schema, and annotations.

server.registerTool("design_search_references", {
  title: "Search design references",
  description: `Web search scoped to design platforms. Returns article titles, snippets, and links. Better than image search when you want case studies, write-ups, or design system documentation.`,
  inputSchema: SearchReferencesInputSchema,
  annotations: {
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
    openWorldHint: true,
  },

Design Inspiration MCP Server