Marketplace Search MCP

Instructions

Implementation Reference

• src/index.ts:87-129 (handler)

  The 'search_thumbtack' tool is defined using server.tool, including its schema, description, and the async handler logic that fetches data from the backend.

  server.tool(
    "search_thumbtack",
    "Search local service professionals from Thumbtack. Find plumbers, electricians, cleaners, and 1000+ other service categories. Returns ratings, reviews, pricing, and hire counts.",
    {
      query: z
        .string()
        .describe(
          'Service category search term (e.g. "plumbers", "house cleaners")'
        ),
      location: z
        .string()
        .optional()
        .describe(
          'City/state slug (e.g. "san-francisco/ca", "austin/tx"). Omit for national results.'
        ),
      limit: z
        .number()
        .int()
        .min(1)
        .max(20)
        .default(20)
        .describe("Number of results to return (max 20)"),
    },
    async ({ query, location, limit }) => {
      let url = `${BACKEND_URL}/thumbtack/search?query=${encodeURIComponent(query)}&limit=${limit}`;
      if (location) {
        url += `&location=${encodeURIComponent(location)}`;
      }
      const res = await fetch(url);
      const data = await res.json();
  
      if (!data.success) {
        return {
          isError: true,
          content: [{ type: "text", text: `Error: ${data.error}` }],
        };
      }
  
      return {
        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
      };
    }
  );