Beehiiv Analytics MCP Server

Instructions

Implementation Reference

• server.js:102-104 (handler)

  The handler function in BeehiivAPI class that performs the HTTP GET request to retrieve subscriber details from the Beehiiv API.

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

• server.js:271-288 (schema)

  The input schema and metadata for the 'get_subscriber_details' tool, provided in the tools/list response.

  {
    name: "get_subscriber_details",
    description: "Get detailed information about a specific subscriber",
    inputSchema: {
      type: "object",
      properties: {
        publication_id: {
          type: "string",
          description: "The ID of the publication"
        },
        subscriber_id: {
          type: "string",
          description: "The ID of the subscriber"
        }
      },
      required: ["publication_id", "subscriber_id"]
    }
  },

• server.js:384-386 (registration)

  The dispatch logic in the tools/call handler that routes the tool invocation to the appropriate client method.

  case 'get_subscriber_details':
    result = await client.getSubscriberDetails(args.publication_id, args.subscriber_id);
    break;