Clawy MCP Server

Instructions

Implementation Reference

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

  The generic tool registration loop in src/index.ts uses the 'endpoint' property defined in the tool schemas (like src/tools/dart.ts) to execute requests via 'gatewayRequest'. The 'dart_disclosure' tool is registered here along with all other tools in 'allTools'.

  // Register all tools
  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/dart.ts:5-17 (schema)

  Definition of the 'dart_disclosure' tool, including its schema, description, and the endpoint used for the API request.

  {
    name: "dart_disclosure",
    description: "Search Korean corporate disclosures (DART/FSS). Find filings by company code, name, or keyword. Covers listed and unlisted Korean companies.",
    inputSchema: z.object({
      corp_code: z.string().optional().describe("DART corporation code (8 digits)"),
      corp_name: z.string().optional().describe("Company name (Korean or English)"),
      keyword: z.string().optional().describe("Search keyword for disclosure title"),
      bgn_de: z.string().optional().describe("Start date (YYYYMMDD)"),
      end_de: z.string().optional().describe("End date (YYYYMMDD)"),
      page_count: z.number().optional().describe("Results per page (default 10, max 100)"),
    }),
    endpoint: "/v1/dart/disclosure",
  },