# beehiiv tools in Cogny Cogny's beehiiv integration exposes 17 tools (13 read, 4 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (13): only reads data. - **Write** (4): creates or changes something. - **Destructive** (0): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## All tools | Tool | Kind | What it does | |---|---|---| | `list_publications` | Read | List the beehiiv publications your API key can access. | | `get_publication` | Read | Get one beehiiv publication. | | `list_posts` | Read | List posts of a publication with their performance stats. | | `get_post` | Read | Get a single beehiiv post. | | `get_posts_aggregate_stats` | Read | Get aggregate stats (recipients, opens, clicks) across a publication's posts. | | `create_post` | Write | Create a beehiiv post as a DRAFT. | | `list_subscriptions` | Read | List subscribers of a publication. | | `get_subscription_by_email` | Read | Look up a subscriber by email address. | | `get_subscription_by_id` | Read | Get a subscriber by its subscription id. | | `create_subscription` | Write | Create a beehiiv subscriber, or update the existing one with that email. | | `update_subscription` | Write | Update an existing beehiiv subscriber (idempotent). | | `list_segments` | Read | List segments of a publication. | | `get_segment` | Read | Get a single segment. | | `list_segment_subscribers` | Read | List the subscribers in a segment. | | `list_automations` | Read | List automations of a publication. | | `list_automation_journeys` | Read | List the journeys of an automation. | | `add_subscription_to_automation` | Write | Enrol a subscriber in an automation. | Exact input schemas come from `tools/list` once beehiiv is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt