KosmoKrator

newsletter

Beehiiv MCP Gateway for AI Agents

Expose Beehiiv tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

10 functions 6 read 4 write API key auth
Submit Beehiiv feedback View package source

Beehiiv MCP Gateway

Expose Beehiiv to MCP clients with `kosmokrator mcp:serve --integration=beehiiv`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server. The gateway exposes only the selected integration in the example below. 

curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
kosmokrator mcp:gateway:install --integration=beehiiv --write=deny --json
{
  "mcpServers": {
    "kosmokrator-beehiiv": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=beehiiv",
        "--write=deny"
      ]
    }
  }
}

Serve Manually

kosmokrator mcp:serve --integration=beehiiv --write=deny

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP toolSource functionType
integration__beehiiv__beehiiv_list_posts beehiiv.beehiiv_list_posts Read read
integration__beehiiv__beehiiv_get_post beehiiv.beehiiv_get_post Read read
integration__beehiiv__beehiiv_create_post beehiiv.beehiiv_create_post Write write
integration__beehiiv__beehiiv_update_post beehiiv.beehiiv_update_post Write write
integration__beehiiv__beehiiv_delete_post beehiiv.beehiiv_delete_post Write write
integration__beehiiv__beehiiv_list_subscribers beehiiv.beehiiv_list_subscribers Read read
integration__beehiiv__beehiiv_get_subscriber beehiiv.beehiiv_get_subscriber Read read
integration__beehiiv__beehiiv_create_subscriber beehiiv.beehiiv_create_subscriber Write write
integration__beehiiv__beehiiv_get_stats beehiiv.beehiiv_get_stats Read read
integration__beehiiv__beehiiv_get_current_user beehiiv.beehiiv_get_current_user Read read

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.