Marketplace Search MCP

Instructions

Implementation Reference

• src/index.ts:50-84 (handler)

  The handler and registration logic for the 'search_reverb' tool, which fetches music gear listings from a backend API.

  // --- search_reverb ---
  server.tool(
    "search_reverb",
    "Search used and new music gear listings from Reverb.com. Find guitars, amps, pedals, synths, and more. Returns prices, condition, seller info, and listing URLs.",
    {
      query: z
        .string()
        .describe(
          'Instrument or gear search term (e.g. "gibson les paul", "boss ds-1")'
        ),
      limit: z
        .number()
        .int()
        .min(1)
        .max(50)
        .default(20)
        .describe("Number of results to return (max 50)"),
    },
    async ({ query, limit }) => {
      const url = `${BACKEND_URL}/reverb/search?query=${encodeURIComponent(query)}&limit=${limit}`;
      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) }],
      };
    }
  );