integrations tools rule

    Rule MCP for your AI agent

    Cogny's Rule integration exposes 35 tools (18 read, 10 write, 7 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.

    • 18readonly reads data.
    • 10writecreates or changes something.
    • 7destructivedeletes, 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 Rule in Cogny. Every Rule 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

    Rule (app.rule.io) connects with an API key from Rule → Settings → API. Every list tool pages with limit (max 100) and page; an answer's meta.next_page / meta.previous_page give the page numbers for the next call.

    Known gaps

    • No subscribers-by-tag filter. Rule's API has no endpoint that lists the subscribers of one tag and list_subscribers has no tag parameter. get_tag with with_count=true returns recipient_count, the size of the tag, without paging through every subscriber; list_subscriber_tags answers the question the other way round, for one subscriber.
    • Segments are what Rule's GET /segments returns. The tool passes the list through unchanged; if a campaign refers to segments the list does not contain, the difference is in Rule's API, not in the tool.
    • Rule's pagination links carry the account's API key. The tool removes it before anything is returned; use the page numbers instead of the links.

    what each tool does.

    Read 18 · only reads data

    • tool_list_subscribersReadList subscribers with pagination.
    • tool_get_subscriberReadGet a single subscriber.
    • tool_get_subscriber_fieldsReadGet custom fields for a subscriber.
    • tool_list_subscriber_tagsReadList tags assigned to a subscriber.
    • tool_list_tagsReadList all tags with pagination.
    • tool_get_tagReadGet a single tag by ID or name, optionally with how many subscribers carry it.
    • tool_list_campaignsReadList campaigns with optional filtering.
    • tool_get_campaignReadGet a single campaign by ID.
    • tool_get_campaign_statisticsReadGet performance statistics for a campaign.
    • tool_list_templatesReadList all email templates.
    • tool_get_templateReadGet a single template by ID.
    • tool_list_segmentsReadList all segments with pagination.
    • tool_list_customizationsReadList all custom field group definitions.
    • tool_get_customizationReadGet a specific custom field group.
    • tool_list_suppressionsReadList suppressed subscribers.
    • tool_list_preference_groupsReadList all preference groups.
    • tool_get_subscriber_preferencesReadGet subscriber preferences for a specific preference group.
    • tool_list_journeysReadList automation journeys with optional filtering.

    Write 10 · creates or changes something

    • tool_create_subscriberWriteCreate a new subscriber.
    • tool_update_subscriberWriteUpdate an existing subscriber.
    • tool_add_subscriber_tagsWriteAdd tags to a subscriber.
    • tool_update_tagWriteRename or update a tag.
    • tool_create_campaignWriteCreate a campaign draft.
    • tool_send_campaignWriteSend a campaign immediately.
    • tool_schedule_campaignWriteSchedule a campaign for later delivery.
    • tool_send_transactionWriteSend a transactional email or SMS.
    • tool_create_customizationWriteCreate custom field definitions.
    • tool_update_subscriber_preferencesWriteUpdate subscriber preferences for a preference group.

    Destructive 7 · deletes, removes or replaces something

    • tool_delete_subscriberDestructiveDelete a single subscriber.
    • tool_delete_subscribersDestructiveMass delete multiple subscribers.
    • tool_remove_subscriber_tagDestructiveRemove a specific tag from a subscriber.
    • tool_clear_subscriber_tagsDestructiveRemove all tags from a subscriber.
    • tool_delete_tagDestructiveDelete a tag.
    • tool_clear_tagDestructiveClear all subscriber associations from a tag (without deleting the tag).
    • tool_delete_campaignDestructiveDelete a campaign.

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