LottieFiles MCP Server

Instructions

Implementation Reference

• src/handlers/ToolHandler.ts:42-56 (registration)

  Registration of the 'get_animation_details' tool in the listTools method, including its name, description, and input schema.

  {
    name: "get_animation_details",
    description:
      "Get detailed information about a specific Lottie animation, including animation data, preview images, and tags.",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "string",
          description: "Unique identifier of the animation",
        },
      },
      required: ["id"],
    },
  },

• src/handlers/ToolHandler.ts:110-122 (handler)

  The handler case in callTool that executes the get_animation_details tool by calling the API client and returning the details as JSON.

  case "get_animation_details":
    const details = await this.apiClient.getAnimationById(
      args?.id as string
    );
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(details, null, 2),
        },
      ],
    };

• src/api/LottieApiClient.ts:38-56 (helper)

  Core helper method in LottieApiClient that fetches animation details from the LottieFiles API using the provided animation ID.

  async getAnimationById(id: string) {
    try {
      const response = await this.axiosInstance.get(
        `${this.baseUrl}/animations/get-animation-data`,
        {
          params: {
            fileId: id,
          },
        }
      );
  
      return response.data;
    } catch (error) {
      if (error instanceof Error) {
        throw new Error(`Failed to get animation: ${error.message}`);
      }
      throw new Error("Failed to get animation: Unknown error");
    }
  }