integrations tools omnisend

    Omnisend MCP for your AI agent

    Cogny's Omnisend integration exposes 32 tools (16 read, 15 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

    • 16readonly reads data.
    • 15writecreates or changes something.
    • 1destructivedeletes, 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. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect Omnisend in Cogny. Every Omnisend tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    Notes

    Omnisend connects with an API key from Integrations → API Keys (the same key you'd use for the REST API). Cogny can build an email campaign as a draft, set its content and audience, and then send or cancel it. The agent sends to your real audience only after you confirm; send_campaign_test_email sends only to email addresses you name. There are no delete tools — the agent can build, update and send, but it can't delete contacts, campaigns or segments.

    Writes are confirm-gated: send_campaign, send_campaign_test_email, enable_automation, upsert_contact, update_contact, add_contact_tags, remove_contact_tags, create_segment and update_segment make no call to Omnisend until you pass confirm=true — they first describe what they would do. This covers sends and every tool that changes your audience. Automations: Cogny can read and copy them, and enable or disable a flow — enabling a draft automation turns it live for real contacts, so it asks you to confirm first.

    Known gaps

    • Campaigns are email only. SMS campaign sending isn't exposed in this release.
    • There are no delete tools for contacts, campaigns or segments — the agent can't remove records from Omnisend.
    • Brand-level settings and the aggregate statistics report endpoints aren't exposed (their API paths couldn't be confirmed against the live API).
    • Drag-and-drop campaign builder content can't be driven from Cogny; drafts are built through the REST content model.

    what each tool does.

    Read 16 · only reads data

    • list_contactsReadList contacts with optional filters.
    • get_contactReadGet a contact by email address.
    • list_segmentsReadList segments.
    • get_segment_statisticsReadGet a segment's statistics (contact counts, and more).
    • list_campaignsReadList email and SMS campaigns, with an optional status filter.
    • get_campaignReadGet a campaign by id.
    • get_campaign_utmReadGet a campaign's UTM tracking parameters.
    • get_campaign_reportReadGet a campaign's delivery and engagement report.
    • list_automationsReadList automations.
    • get_automationReadGet an automation by id.
    • list_formsReadList signup forms.
    • get_form_reportReadGet a signup form's performance report.
    • list_productsReadList products in your catalogue.
    • get_productReadGet a product by id.
    • list_email_templatesReadList email templates.
    • get_email_contentReadGet an email template's content by id.

    Write 15 · creates or changes something

    • upsert_contactWriteCreate a contact, or update it if the email already exists.
    • update_contactWriteUpdate an existing contact by its id.
    • add_contact_tagsWriteAdd tags to one or more contacts in a batch.
    • remove_contact_tagsWriteRemove tags from one or more contacts in a batch.
    • create_segmentWriteCreate a dynamic segment.
    • update_segmentWriteUpdate a segment's name and/or query.
    • create_campaignWriteCreate a draft email campaign.
    • update_campaignWriteUpdate a draft campaign's details or content.
    • copy_campaignWriteDuplicate a campaign.
    • update_campaign_utmWriteUpdate a campaign's UTM tracking parameters.
    • send_campaign_test_emailWriteSend a campaign test to the given email addresses, not your audience.
    • send_campaignWriteSend a campaign to its real audience.
    • enable_automationWriteTurn an automation live for real contacts.
    • disable_automationWritePause a live automation.
    • copy_automationWriteDuplicate an automation.

    Destructive 1 · deletes, removes or replaces something

    • cancel_campaignDestructiveCancel a scheduled or in-flight campaign send.

    Exact input schemas come from tools/list once Omnisend is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.