Beehiiv Analytics MCP Server

Instructions

Implementation Reference

• server.js:369-371 (handler)

  Executes the MCP tool 'get_publications' by calling the BeehiivAPI client's getPublications method to fetch publications from the API.

  case 'get_publications':
    result = await client.getPublications();
    break;

• server.js:192-199 (schema)

  Tool schema and metadata definition for 'get_publications', including empty input schema (no parameters required). Also serves as registration in the tools/list response.

  {
    name: "get_publications",
    description: "Get list of publications",
    inputSchema: {
      type: "object",
      properties: {},
      required: []
    }

• server.js:82-84 (helper)

  Supporting helper method in BeehiivAPI class that makes the actual API request to retrieve the list of publications.

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

• beehiiv_mcp_server.py:79-82 (helper)

  Equivalent helper method in the Python BeehiivAPI class used by the similar 'list_publications' tool.

  def get_publications(self) -> List[Dict[str, Any]]:
      """Get list of all publications."""
      data = self._make_request("GET", "/publications")
      return data.get("data", [])