Fal.ai MCP Server

Instructions

Implementation Reference

• src/index.ts:421-434 (handler)

  Handler for the check_status tool. Parses input using CheckStatusSchema and returns a text response explaining that full status checking requires app_id and request_id, currently a stub implementation.

  case "check_status": {
    const params = CheckStatusSchema.parse(args);
    // For now, return a message about status checking
    // Fal.ai queue.status requires both app_id and request_id
    
    return {
      content: [
        {
          type: "text",
          text: "Status checking requires both app_id and request_id. Use the result from run_model or run_workflow which includes status information.",
        },
      ],
    };
  }

• src/index.ts:83-85 (schema)

  Zod schema for check_status tool input validation: requires request_id string.

  const CheckStatusSchema = z.object({
    request_id: z.string().describe("The request ID to check status for"),
  });

• src/index.ts:192-205 (registration)

  Registration of the check_status tool in the list of tools returned by ListToolsRequestHandler, including name, description, and inputSchema matching the Zod schema.

  {
    name: "check_status",
    description: "Check the status of a Fal.ai request",
    inputSchema: {
      type: "object",
      properties: {
        request_id: {
          type: "string",
          description: "The request ID to check",
        },
      },
      required: ["request_id"],
    },
  },