Clawy MCP Server

Instructions

Implementation Reference

• src/index.ts:15-40 (handler)

  This is the dynamic handler for all tools, including "court_auction_search". It uses the tool's endpoint and performs a gatewayRequest.

  for (const tool of allTools) {
    server.tool(
      tool.name,
      tool.description,
      tool.inputSchema.shape,
      async (params) => {
        const method = tool.method || "POST";
        const result = await gatewayRequest(method, tool.endpoint, params as Record<string, unknown>);
  
        if (result.error) {
          return {
            content: [{ type: "text" as const, text: `Error (${result.status}): ${result.error}` }],
            isError: true,
          };
        }
  
        const text = typeof result.data === "string"
          ? result.data
          : JSON.stringify(result.data, null, 2);
  
        return {
          content: [{ type: "text" as const, text }],
        };
      },
    );
  }

• src/tools/court-auction.ts:5-17 (registration)

  Definition and registration of the "court_auction_search" tool, including its schema and endpoint.

  {
    name: "court_auction_search",
    description: "Search Korean court auction property listings. Find foreclosed real estate by region, property type, price range, or auction date.",
    inputSchema: z.object({
      region: z.string().optional().describe("Court region (e.g., '서울', '부산', '대구', 'Seoul')"),
      property_type: z.string().optional().describe("Property type (e.g., '아파트', '토지', '상가', 'apartment', 'land')"),
      min_price: z.number().optional().describe("Minimum appraisal price (KRW)"),
      max_price: z.number().optional().describe("Maximum appraisal price (KRW)"),
      keyword: z.string().optional().describe("Search keyword"),
      page: z.number().optional().describe("Page number (default 1)"),
    }),
    endpoint: "/v1/auction/search",
  },