Beehiiv Analytics MCP Server

Instructions

Implementation Reference

• beehiiv_mcp_server.py:393-398 (handler)

  MCP call_tool handler that processes arguments, calls the Beehiiv API client, and returns the publication details as JSON text content.

  elif name == "get_publication_details":
      publication_id = arguments["publication_id"]
      details = client.get_publication_details(publication_id)
      return CallToolResult(
          content=[TextContent(type="text", text=json.dumps(details, indent=2))]
      )

• beehiiv_mcp_server.py:195-204 (schema)

  Input schema specifying the required 'publication_id' string parameter for the tool.

  inputSchema={
      "type": "object",
      "properties": {
          "publication_id": {
              "type": "string",
              "description": "The publication ID (e.g., pub_00000000-0000-0000-0000-000000000000)",
          }
      },
      "required": ["publication_id"],
  },

• beehiiv_mcp_server.py:192-205 (registration)

  Tool registration in the list_tools() decorator, including name, description, and schema.

  Tool(
      name="get_publication_details",
      description="Get detailed information about a specific publication",
      inputSchema={
          "type": "object",
          "properties": {
              "publication_id": {
                  "type": "string",
                  "description": "The publication ID (e.g., pub_00000000-0000-0000-0000-000000000000)",
              }
          },
          "required": ["publication_id"],
      },
  ),

• beehiiv_mcp_server.py:84-87 (helper)

  BeehiivAPI helper method that performs the actual API request to fetch publication details.

  def get_publication_details(self, publication_id: str) -> Dict[str, Any]:
      """Get detailed information about a specific publication."""
      data = self._make_request("GET", f"/publications/{publication_id}")
      return data.get("data", {})