ESA MCP Server

Instructions

Implementation Reference

• src/server.ts:204-214 (registration)

  Registers the 'delete_esa_post' MCP tool with description, input schema using Zod, and an async handler function that delegates to ApiClient.deletePost.

  server.tool(
    "delete_esa_post",
    "Delete a post in esa.io. Required parameters: postNumber.",
    {
      teamName: z.string().default(getRequiredEnv("DEFAULT_ESA_TEAM")),
      postNumber: z.number(),
    },
    async (input) =>
      await formatTool(async () =>
        client.deletePost(input.teamName, input.postNumber)
      )

• src/api.ts:146-154 (handler)

  ApiClient.deletePost: Performs the HTTP DELETE request to esa.io API endpoint for deleting a specific post, using generated esaAPI function and callApi wrapper.

  async deletePost(teamName: string, postNumber: number) {
    return this.callApi(() =>
      deleteV1TeamsTeamNamePostsPostNumber(teamName, postNumber, {
        headers: {
          Authorization: `Bearer ${this.apiKey}`,
        },
      })
    ).then((response) => response.data)
  }

• src/server.ts:207-209 (schema)

  Zod input schema for delete_esa_post tool: teamName (string, optional default from env), postNumber (required number).

  {
    teamName: z.string().default(getRequiredEnv("DEFAULT_ESA_TEAM")),
    postNumber: z.number(),

• src/formatTool.ts:34-61 (helper)

  formatTool helper: Executes tool callback, converts result to YAML-formatted text content for MCP response, handles success and errors uniformly.

  export const formatTool = async (
    cb: () => unknown
  ): Promise<CallToolResult> => {
    try {
      const result = await cb()
  
      return {
        content: [
          {
            type: "text",
            text: stringify(toResponse(result)),
          },
        ],
      }
    } catch (error) {
      console.error("Error in formatTool:", error)
  
      return {
        isError: true,
        content: [
          {
            type: "text",
            text: `Error: ${error instanceof Error ? `${error.name}: ${error.message}` : String(error)}`,
          },
        ],
      }
    }
  }

• src/api.ts:32-54 (helper)

  callApi private method in ApiClient: Handles API responses, checks status codes (200,201,204 success), throws ApiError on failures with appropriate messages.

  private async callApi<T extends { status: number; data: unknown }>(
    cb: () => Promise<T>
  ) {
    const response = await cb()
    if (
      response.status === 200 ||
      response.status === 201 ||
      response.status === 204
    ) {
      return response as T extends { status: 200 | 201 | 204 } ? T : never
    } else {
      if (
        typeof response.data === "object" &&
        response.data !== null &&
        "message" in response.data &&
        typeof response.data.message === "string"
      ) {
        throw new ApiError(response.data.message)
      }
  
      throw new ApiError(`Api Error: ${response.status}`)
    }
  }