Clawy MCP Server

Instructions

Implementation Reference

• src/index.ts:16-39 (handler)

  The handler for the `finnhub_query` tool is dynamically registered in `src/index.ts`. It utilizes `gatewayRequest` to perform the action based on the tool's endpoint defined in `src/tools/finnhub.ts`.

  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/finnhub.ts:8-13 (schema)

  Schema definition for the input arguments required by the `finnhub_query` tool.

  inputSchema: z.object({
    endpoint: z.string().describe("Finnhub endpoint (e.g., quote, company-news, recommendation, earnings)"),
    symbol: z.string().optional().describe("Stock symbol (e.g., AAPL, MSFT)"),
    from: z.string().optional().describe("Start date (YYYY-MM-DD) for news/earnings"),
    to: z.string().optional().describe("End date (YYYY-MM-DD)"),
  }),

• src/tools/finnhub.ts:5-15 (registration)

  Registration of the `finnhub_query` tool definition, including its name, description, schema, and API endpoint.

  {
    name: "finnhub_query",
    description: "Query real-time financial data from Finnhub. Stock quotes, company news, earnings, recommendations, and market status.",
    inputSchema: z.object({
      endpoint: z.string().describe("Finnhub endpoint (e.g., quote, company-news, recommendation, earnings)"),
      symbol: z.string().optional().describe("Stock symbol (e.g., AAPL, MSFT)"),
      from: z.string().optional().describe("Start date (YYYY-MM-DD) for news/earnings"),
      to: z.string().optional().describe("End date (YYYY-MM-DD)"),
    }),
    endpoint: "/v1/finnhub/query",
  },