# APSIS One tools in Cogny Cogny's APSIS One integration exposes 23 tools (19 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** (19): 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. ## Notes APSIS One is connected from Settings → Integrations with an **API key** you create in APSIS One under Account settings → API keys. APSIS generates a client ID and a client secret for the key; paste both into Cogny. EU and APAC accounts both work, and there is no region to choose. The key's own section and keyspace access decides what Cogny can read and write. Most tools need a section discriminator (from `list_sections`), and profile tools also need a keyspace discriminator (from `list_keyspaces`) and the profile's key in that keyspace — for the email keyspace, the email address. Reads cover sections, keyspaces, channels, attributes, consent topics, tags, event types, segments (with live profile counts and trends), recent email sendings with their statistics, email event exports, and one subscriber profile at a time (attributes, tags, events, consents). Writes cover profile attributes, tags, events and opt-in / opt-out consent; they change real subscriber records and stay **ask-first** until you allow them in Settings. Events can trigger APSIS One automations. ## Known gaps - Recent email sendings are the latest 500 per section; older sendings are reached through the email event export. - SMS, Marketing Automation, Website and Forms & Pages activity statistics are not exposed yet. - Profiles are read one at a time by key; there is no profile search or list. Use segments and their counts for audience size. - No tool creates, deletes, merges or imports profiles, and no tool sends an email or SMS. - Consent is set per topic and channel as opt-in or opt-out; double opt-in states are not supported by APSIS One's API. ## All tools | Tool | Kind | What it does | |---|---|---| | `list_sections` | Read | List the sections (brands or business units) in your APSIS One account. | | `list_keyspaces` | Read | List the keyspaces that identify profiles in APSIS One, such as email, mobile or CRM id. | | `list_channels` | Read | List the channels (email, SMS, web …) consent can be given for in APSIS One. | | `list_attributes` | Read | List the profile attributes defined in a section, such as first name, city or loyalty level. | | `list_consent_topics` | Read | List the consent topics (newsletters and subscription lists) in a section. | | `list_tags` | Read | List the tags defined in a section. | | `list_event_types` | Read | List the event types a section records on profiles, such as purchases, form submits or email opens. | | `list_segments` | Read | List the segments in your APSIS One account. | | `get_segment` | Read | Get one segment and its versions, including the rules that define it. | | `count_segment_profiles` | Read | Count how many profiles match a segment right now. | | `get_segment_trend` | Read | Show how many profiles matched a segment at up to 25 points in time. | | `list_email_activities` | Read | List recent email sendings in a section with their delivery, open, click, bounce and unsubscribe numbers. | | `get_email_activity` | Read | Get one email sending with its full statistics. | | `start_email_event_export` | Read | Start an export of individual email events (sends, opens, clicks, bounces, unsubscribes) for a period. | | `get_email_event_export` | Read | Check an email event export and get its download link when it is ready. | | `get_profile_attributes` | Read | Read a subscriber profile's attribute values in a section. | | `get_profile_tags` | Read | Read which tags a subscriber profile has in a section. | | `get_profile_events` | Read | Read a subscriber profile's event history in a section, newest first. | | `get_profile_consents` | Read | Read a subscriber profile's consents: which topics and channels it is opted in or out of. | | `update_profile_attributes` | Write | Set or clear attribute values on a subscriber profile in APSIS One. | | `set_profile_tags` | Write | Add or remove tags on a subscriber profile in APSIS One. | | `add_profile_events` | Write | Record events (such as a purchase or a form submit) on a subscriber profile in APSIS One. | | `set_profile_consent` | Write | Opt a subscriber in to or out of a consent topic on one channel in APSIS One. | Exact input schemas come from `tools/list` once APSIS One 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