Beehiiv Analytics MCP Server

Instructions

Implementation Reference

• server.js:106-108 (handler)

  Core implementation of the get_segments tool: fetches segments from Beehiiv API endpoint using HTTP GET request.

  async getSegments(publicationId) {
    return await makeRequest('GET', `${this.baseUrl}/publications/${publicationId}/segments`, this.headers);
  }

• server.js:289-302 (registration)

  Registration of the get_segments tool in the tools/list response, including name, description, and input schema definition.

  {
    name: "get_segments",
    description: "Get segments for a publication",
    inputSchema: {
      type: "object",
      properties: {
        publication_id: {
          type: "string",
          description: "The ID of the publication"
        }
      },
      required: ["publication_id"]
    }
  },

• server.js:387-389 (handler)

  Tool dispatch handler in the tools/call case switch that calls the getSegments implementation.

  case 'get_segments':
    result = await client.getSegments(args.publication_id);
    break;

• server.js:292-301 (schema)

  Input schema definition for the get_segments tool, specifying the required publication_id parameter.

  inputSchema: {
    type: "object",
    properties: {
      publication_id: {
        type: "string",
        description: "The ID of the publication"
      }
    },
    required: ["publication_id"]
  }