Aimtell integration
Aimtell is a web push notification platform. An agent can send a push notification to chosen subscribers; create, schedule, update, share and delete manual, event-triggered and RSS campaigns; manage a site's welcome notification; build and share subscriber segments; list subscribers and set their attributes and aliases; read day-by-day campaign results, analytics over time and recent notification, event, pageview, attribute and alias logs; and manage websites, their users, tracking settings, custom variables, cross-domain tracking pixels and opt-in prompts with their display conditions. Not exposed: reading or replacing a site's VAPID and FCM push keys (the answer carries the private key), changing the account password, and the per-subscriber click list of a manual campaign (its route answers 404 on the live API). Authentication is an API key generated in the Aimtell dashboard under Settings, API Key, sent in the X-Authorization-Api-Key header. Aimtell answers a missing key with HTTP 200 and result error, so read result in every answer.
Say what should happen.
The workflow builds itself.
What you can do with Aimtell
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Shared, 8 operations
list_campaign_sharesList campaign sharesGETLists the sites a manual campaign is shared with and the copied campaign id on each. Empty when the campaign is not shared.list_rss_campaign_sharesList rss campaign sharesGETLists the sites an RSS campaign is shared with and the copied campaign id on each. Empty when the campaign is not shared.list_segment_sharesList segment sharesGETLists the sites a segment is shared with: the matching segment id on each site and the shared_id that links them. Empty when the segment is not shared.list_triggered_campaign_sharesList triggered campaign sharesGETLists the sites an event-triggered campaign is shared with and the copied campaign id on each. Empty when the campaign is not shared.share_campaignShare campaignPOSTShares a manual campaign with other sites as linked copies that follow later edits; once scheduled, the copies push to those sites' real subscribers. It must target one segment already shared with every listed site (share_segment).share_rss_campaignShare rss campaignPOSTShares an RSS campaign with other sites as linked copies that follow later edits; once active, the copies push to those sites' real subscribers. It must target one segment already shared with every listed site (share_segment).share_segmentShare segmentPOSTShares a segment with other sites, creating a matching segment on each; needed before sharing a campaign that targets it. Returns the whole shared group. Some conditions block sharing (see details).share_triggered_campaignShare triggered campaignPOSTShares an event-triggered campaign with other sites as linked copies that follow later edits; once active, the copies push to those sites' real subscribers. It must target one segment already shared with every listed site (share_segment).
Result, 6 operations
get_api_campaign_resultsGet api campaign resultsGETReturns the day-by-day results of a website's API pushes between two dates: sent, delivered, bounced, clicked and conversions, each keyed by day (MM/DD/YYYY).get_campaign_resultsGet campaign resultsGETReturns a manual campaign's results per day between two dates: sent, delivered, bounced, clicked and conversions, each keyed by day (MM/DD/YYYY). Revenue of monetized campaigns is included.get_rss_campaign_resultsGet rss campaign resultsGETReturns an RSS campaign's results per day between two dates: sent, delivered, bounced, clicked and conversions, each keyed by day (MM/DD/YYYY).get_segment_countsGet segment countsGETReturns how many subscribers a segment held on each day between two dates, as one object keyed by day (MM/DD/YYYY).get_triggered_campaign_resultsGet triggered campaign resultsGETReturns an event-triggered campaign's results per day between two dates: sent, delivered, bounced, clicked and conversions, each keyed by day (MM/DD/YYYY). Revenue of monetized campaigns is included.get_welcome_campaign_resultsGet welcome campaign resultsGETReturns a welcome notification's results per day between two dates: sent, delivered, bounced, clicked and conversions, each keyed by day (MM/DD/YYYY).
Campaign, 5 operations
create_campaignCreate campaignPOSTCreates a manual push campaign, saved as a draft (status 1, the default) or scheduled (status 2), which then sends to real subscribers at schedule_date. Returns campaignId.delete_campaignDelete campaignDELETEDeletes a manual campaign.get_campaignGet campaignGETReturns one manual campaign: content, target segments, schedule, recurrence, status (1 draft, 2 scheduled, other codes as Aimtell sets them) and lifetime results (sent, delivered, bounced, clicked, conversions).list_campaignsList campaignsGETLists a website's manual campaigns: id, name, content, target segments, schedule, send date and status.update_campaignUpdate campaignPUTChanges a manual campaign. Leave out a field to keep it. Setting status 2 schedules the campaign to send to real subscribers at schedule_date. On an A/B test, pass version_b with its status.
Condition, 5 operations
create_prompt_conditionCreate prompt conditionPOSTAdds a rule that decides on which page, device and browser an opt-in prompt shows, and after what delay. With autoPrompt 0 pass exactly one of seconds_delay, scroll_delay or pages_delay.delete_prompt_conditionDelete prompt conditionDELETEDeletes an opt-in prompt display rule.get_prompt_conditionGet prompt conditionGETReturns one opt-in prompt display rule: page, prompt, auto-prompt flag, device, browser, delays, cookie, priority and disabled flag.list_prompt_conditionsList prompt conditionsGETLists a website's opt-in prompt display rules: page, prompt, auto-prompt flag, device, browser, delays, cookie, priority and disabled flag.update_prompt_conditionUpdate prompt conditionPUTChanges an opt-in prompt display rule. Aimtell requires page, promptId, autoPrompt and priority: read the rule with get_prompt_condition and send those back with your change.
Event campaign, 5 operations
create_triggered_campaignCreate triggered campaignPOSTCreates an event-triggered campaign with only a name. Set its content, triggering event, delay and status with update_triggered_campaign. Returns campaignId.delete_triggered_campaignDelete triggered campaignDELETEDeletes an event-triggered campaign.get_triggered_campaignGet triggered campaignGETReturns one event-triggered campaign: content, triggering event (eventCategory, eventAction, eventLabel), delay, status (1 draft, 5 active) and lifetime results.list_triggered_campaignsList triggered campaignsGETLists a website's event-triggered campaigns: id, name, content, triggering event, delay, status and lifetime results.update_triggered_campaignUpdate triggered campaignPUTChanges an event-triggered campaign. Leave out a field to keep it. Setting status 5 activates it: subscribers who fire the event then receive the push for real.
Pixel, 5 operations
create_pixelCreate pixelPOSTCreates a cross-domain tracking pixel for a website and returns its id. Set the event it records with update_pixel.delete_pixelDelete pixelDELETEDeletes a cross-domain tracking pixel.get_pixelGet pixelGETReturns one cross-domain tracking pixel: id, website, name, the event it records (a JSON-encoded string), active flag and creation time.list_pixelsList pixelsGETLists a website's cross-domain tracking pixels: id, name, the event each records (a JSON-encoded string), active flag and creation time.update_pixelUpdate pixelPOSTChanges a tracking pixel's name and the event it records. Aimtell requires both: read the current values with get_pixel and send them back with your change.
Prompt, 5 operations
create_promptCreate promptPOSTCreates an opt-in prompt (the box that asks visitors to allow notifications) for a website and returns its id. Its text and colors are set with update_prompt.delete_promptDelete promptDELETEDeletes an opt-in prompt (Aimtell answers that it de-activated the prompt).get_promptGet promptGETReturns one opt-in prompt: name, header and body text, button texts and colors, icon, position and type.list_promptsList promptsGETLists a website's opt-in prompts with their texts, colors, icon, position and type.update_promptUpdate promptPUTChanges an opt-in prompt's name, texts, colors or icon. Leave out a field to keep it. Colors are hexadecimal, such as #4e99cf.
Rss notification, 5 operations
create_rss_campaignCreate rss campaignPOSTCreates an RSS campaign with only a name. Set its feed, content and status with update_rss_campaign. Returns campaignId.delete_rss_campaignDelete rss campaignDELETEDeletes an RSS campaign.get_rss_campaignGet rss campaignGETReturns one RSS campaign: feed URL, content templates ({rss_title}, {rss_body}, {rss_link}), segments, send maximum, status (1 draft, 2 active) and lifetime results.list_rss_campaignsList rss campaignsGETLists a website's RSS campaigns: id, name, feed URL, content templates, segments, send maximum, status and lifetime results.update_rss_campaignUpdate rss campaignPUTChanges an RSS campaign. status is required by Aimtell: send 1 (draft) or 2 (active: each new feed item is pushed to real subscribers). Leave out other fields to keep them.
Segment, 5 operations
create_segmentCreate segmentPOSTCreates a subscriber segment on a website from a definition such as (region==California). An empty definition matches every subscriber. Returns the segment id.delete_segmentDelete segmentDELETEDeletes a segment.get_segmentGet segmentGETReturns one segment: idsegment, name, definition, website, owner, creation and update times and deleted flag.list_segmentsList segmentsGETLists a website's segments with idsegment, name and definition.update_segmentUpdate segmentPUTChanges a segment's name or definition. Leave out a field to keep it.
Site, 5 operations
create_siteCreate sitePOSTAdds a website to the Aimtell account and returns its id. get_site_tracking_code returns the code to install on the site.delete_siteDelete siteDELETEDeletes a website from the Aimtell account (Aimtell answers that it de-activated the site).get_siteGet siteGETReturns one website: id, uid, url, name, icon, opt-in prompt id, Safari web push id, auto-prompt flag, creation time and active flag.list_sitesList sitesGETLists the active websites of the Aimtell account with id, uid, url, name, icon and opt-in prompt. The numeric id is the site id every other tool takes as idSite or id.update_siteUpdate sitePUTChanges a website's name and icon. name is required by Aimtell even when unchanged: read the current one with get_site first. Leave icon out to keep the current icon.
Permitted, 3 operations
grant_site_accessGrant site accessPOSTGives an already registered Aimtell user access to a website, by email address. This grants real access to the site's data and campaigns. Fails when no Aimtell user has that email.list_site_usersList site usersGETLists the Aimtell users who can access a website: uid, first and last name, email address (username) and whether they own it. Personal data of those users.revoke_site_accessRevoke site accessDELETERemoves a user's access to a website, by user uid (from list_site_users).
Variable, 3 operations
delete_site_custom_variableDelete site custom variableDELETEDeletes a website's custom variable by name. Aimtell answers a bare true, so the tool returns no fields on success; a failure returns result error with a message.list_site_custom_variablesList site custom variablesGETLists a website's custom variables: name, value and the snippet to paste in a notification to insert the value.upsert_site_custom_variableUpsert site custom variablePOSTCreates a custom variable on a website, or overwrites the value of the variable with that name. Aimtell answers a bare true, so success returns no fields; a failure returns result error with a message.
Dashboard, 2 operations
get_account_analyticsGet account analyticsGETReturns one metric summed over all the account's websites for a date range, keyed by day (MM/DD/YYYY). With breakdown=true the numbers are split per site instead.get_site_analyticsGet site analyticsGETReturns one metric of a website over a date range, as one object keyed by day (MM/DD/YYYY): new subscribers, unsubscribes, notifications sent or clicked, opt-in rate, inactive removals or revenue.
Settings, 2 operations
get_site_settingsGet site settingsGETReturns a website's tracking settings (IP and user-agent collection, click and subscription events, data retention, daily frequency cap). Aimtell documents no response shape for this read, so the whole answer is returned.update_site_settingsUpdate site settingsPOSTReplaces a website's tracking settings. Aimtell requires all eight settings on every call: read the current ones with get_site_settings and send them back with your change.
Subscriber, 2 operations
list_subscribersList subscribersGETLists a website's push subscribers with device, browser, location and IP address (personal data), optionally filtered by segment or one subscriber. include adds their attributes or recent notifications.track_subscriber_attributesTrack subscriber attributesPOSTSets custom attributes, or the user and email aliases, on one subscriber of a website, found by subscriber_uid or by an existing alias.
User, 2 operations
get_account_userGet account userGETReturns the Aimtell account the API key belongs to: uid, name, email, timezone, registration and last sign-in times, trial status and plan type. The account's auth token is not returned.update_account_userUpdate account userPUTChanges the account's first name, last name or timezone. Leave out a field to keep its current value. Changing the password is not exposed.
Alia, 1 operation
list_alias_logsList alias logsGETLists the aliases recorded for a website's subscribers: subscriber uid, user alias, email hash and times.
Api campaign, 1 operation
list_api_campaignsList api campaignsGETLists the most recent pushes sent through the API (send_push_notification) for a website: content, target (segment, alias or subscriber uids) and the send response. Aimtell keeps only recent ones.
Attribute, 1 operation
list_attribute_logsList attribute logsGETLists the custom attribute values recorded for a website's subscribers: subscriber uid, attribute name, value and times.
Code, 1 operation
get_site_tracking_codeGet site tracking codeGETReturns the Aimtell push and website tracking code (an HTML script snippet) to install on a website, with the site's url.
Default condition, 1 operation
get_default_prompt_conditionGet default prompt conditionGETReturns a website's default opt-in prompt display rule: page, prompt, auto-prompt flag, device, browser, delays, cookie, priority and disabled flag.
Event, 1 operation
list_event_logsList event logsGETLists the custom events recorded for a website's subscribers: subscriber uid, event category, action, label, value and time.
Notification, 1 operation
list_notification_logsList notification logsGETReturns a recent sample of the notifications a website sent to its subscribers (not a full log; on busy sites the window is short), optionally for one subscriber.
Pageview, 1 operation
list_pageview_logsList pageview logsGETLists the pageviews recorded for a website's subscribers: subscriber uid, visit id, page title, page URL and time.
Push, 1 operation
send_push_notificationSend push notificationPOSTSends a push notification right away to real subscribers of a site: those in subscriber_uids, the segment segmentId, or the subscriber with that alias. Always pass one target. Returns an objectId.
Upsert, 1 operation
upsert_welcome_campaignUpsert welcome campaignPOSTCreates or replaces a website's welcome notification. status 1 makes it live: every real new subscriber then receives it right after opting in. Aimtell requires title, body, link and status.
Welcome, 1 operation
get_welcome_campaignGet welcome campaignGETReturns a website's welcome notification, the push sent to new subscribers right after they opt in: content, status (0 draft, 1 active), conversion trigger and action buttons.
Use Aimtell from Claude Code, Cursor or Codex
Connect Aimtell in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Aimtell operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Aimtell
- Create your workspace
Sign up free. Nothing to install.
- Connect Aimtell once
Add your Aimtell connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Aimtell integration FAQ
What can you do with the Aimtell integration?
LiveContext exposes 79 operations on Aimtell, covering shared, result, campaign and condition.
