# AimTell — MCP server on mcp.ai
> Connect your AimTell account and use 15 tools for notifications straight from your AI agent. Connect with your own API key. AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics.

By: mcp.ai · official
Page: https://mcp.ai/aimtell

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_aimtell?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/aimtell/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/aimtell/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/aimtell/skill.md
Postman collection (v2.1): https://mcp.ai/aimtell/postman.json

## Tools
- aimtell_create_manual_campaign(body?: string, link?: string, name: string, title?: string, site_id: integer, icon_url?: string, push_ttl?: integer, image_url?: string, segment_ids?: integer[]) — Create a manual push campaign as a draft only; this tool never schedules or sends it.
- aimtell_create_segment(name: string, site_id: integer, definition: string) — Create a named audience segment for a website from an AimTell segment definition.
- aimtell_delete_manual_campaign(campaign_id: integer) — Permanently delete one manual campaign by ID. This destructive action cannot be undone and permanently removes the campaign.
- aimtell_delete_segment(segment_id: integer) — Permanently delete one audience segment by ID. This destructive action cannot be undone; it removes the segment but does not delete its subscribers.
- aimtell_get_analytics_over_time(metric: string, site_id?: integer, end_date: string, start_date: string, breakdown_by_site?: boolean) — Return a daily AimTell metric over a date range for all websites or one website.
- aimtell_get_campaign_results(end_date: string, start_date: string, campaign_id: integer, campaign_type: string) — Return daily send, delivery, bounce, click, conversion, and available revenue results for a manual, event-triggered, RSS, or welcome campaign.
- aimtell_list_campaigns(limit?: integer, site_id: integer, next_cursor?: string, campaign_type: string) — Return one page of manual, event-triggered, RSS, or API push campaigns for an AimTell website.
- aimtell_list_notification_logs(limit?: integer, site_id: integer, next_cursor?: string, subscriber_id?: string) — Return one page from AimTell's sampled notification log for the last seven days, optionally filtered to one subscriber. This is not a complete delivery ledger and does not include every notification s
- aimtell_list_segments(site_id: integer) — Return all audience segments for an AimTell website, including the IDs and definitions used for subscriber filtering and campaign targeting.
- aimtell_list_subscribers(limit?: integer, include?: string[], site_id: integer, segment_id?: integer, next_cursor?: string, subscriber_id?: string) — Return one page of subscribers for an AimTell website, optionally filtered by segment or subscriber ID and optionally including attributes or notification history. AimTell may return processing=true w
- aimtell_list_websites(limit?: integer, next_cursor?: string, include_subscriber_count?: boolean) — Return one page of websites available to the connected AimTell account, including site IDs needed by other tools. Use next_cursor to retrieve later pages.
- aimtell_send_push_notification(body: string, link: string, title: string, site_id: integer, icon_url?: string, push_ttl?: integer, image_url?: string, segment_id?: integer, send_to_all?: boolean, collapse_key?: string, action_buttons?: object[], subscriber_ids?: string[], subscriber_alias?: string, auto_hide_seconds?: integer) — Immediately send a one-off push notification to exactly one explicitly selected audience: subscriber IDs, one segment, one alias, or the website's full reachable audience. Delivery begins immediately,
- aimtell_set_subscriber_attributes(site_id: integer, attributes: object, user_alias?: string, email_alias?: string, subscriber_id?: string) — Set custom attributes on one subscriber identified by subscriber UID, user alias, or email alias; supplied aliases may also be associated with the subscriber.
- aimtell_update_manual_campaign(body?: string, link?: string, name?: string, title?: string, icon_url?: string, push_ttl?: integer, image_url?: string, campaign_id: integer, segment_ids?: integer[]) — Update the content or targeting of an unscheduled, unsent, non-A/B manual campaign draft without scheduling or sending it.
- aimtell_update_segment(name?: string, definition?: string, segment_id: integer) — Change the name or audience definition of an existing AimTell segment.

## Example prompts
- "What can I do in AimTell?"
- "Show me a summary of my AimTell account"

## Links
Docs: https://mcp.ai/docs/mcps/aimtell
Website: https://mcp.ai/mcps/aimtell