Clawy MCP Server

Instructions

Implementation Reference

• src/tools/firecrawl.ts:30-39 (handler)

  Definition of the firecrawl_map tool, including its schema and API endpoint. The execution handler logic is generic and handled by the server loop in src/index.ts.

      name: "firecrawl_map",
      description: "Map all URLs on a website without extracting content. Fast way to discover site structure.",
      inputSchema: z.object({
        url: z.string().describe("Website URL to map"),
        limit: z.number().optional().describe("Maximum URLs to discover (default 100)"),
      }),
      endpoint: "/v1/firecrawl/map",
    },
  ];

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

  The tool registration happens here by iterating over allTools and using a gatewayRequest helper to forward requests to the specified endpoint.

  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 }],
        };
      },
    );
  }