# Fomo — how to use (mcp.ai)

Connect your Fomo account and use 9 tools for marketing automation straight from your AI agent. Connect with your own API key. Fomo is a social proof marketing platform that displays real-time user activity notifications on websites to build trust and increase conversions.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_fomo?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `fomo_create_fomo_event`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/fomo`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/fomo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/fomo/create/fomo/event` — Tool to create a new social proof event in Fomo. Use when you want to display an animated notification on your website showing recent customer activity. Events are created based on notification templa
  - body: { url?: string, city?: string, title?: string, country?: string, province?: string, image_url?: string, first_name?: string, ip_address?: string, external_id?: string, email_address?: string, event_type_id: integer, custom_event_fields_attributes?: object[] }
- `POST https://api.mcp.ai/api/fomo/create/fomo/template` — Tool to create a Template (Event Type) in Fomo. Use when building 3rd party Fomo integrations. Templates define the message structure for notification events and can include markdown formatting, custo
  - body: { name: string, message: string, image_url?: string, use_avatar?: boolean, use_ip_mapping?: boolean, markdown_enabled?: boolean }
- `POST https://api.mcp.ai/api/fomo/delete/fomo/event` — Tool to delete a Fomo event by ID. Permanently removes the notification event from the application. Use when you need to remove a specific event from your Fomo account.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/fomo/get/fomo/event` — Tool to retrieve a single event by ID from Fomo. Use when you need to fetch details of a specific notification event using its unique identifier.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/fomo/get/statistics` — Tool to fetch notification impressions, clicks, and conversion data for your Fomo application. Returns analytics statistics within a specified date range. Use when you need to analyze notification per
  - body: { date_range_to: string, date_range_from: string }
- `POST https://api.mcp.ai/api/fomo/list/events` — Tool to retrieve all notification events from your Fomo application. Use when you need to list, query, or paginate through events. Supports pagination, sorting, and optional metadata about total event
  - body: { page?: integer, order_by?: string, per_page?: integer, show_meta?: boolean, order_direction?: string }
- `POST https://api.mcp.ai/api/fomo/search/event` — Tool to search for a specific Fomo event by external_id or email_address. Use when you need to find a single event using a unique identifier. Returns the full event details if found.
  - body: { q: string, field: string }
- `POST https://api.mcp.ai/api/fomo/update/application` — Tool to update Fomo application settings including display configuration, notification behavior, theme, position, and UTM tracking parameters. Use when you need to modify widget appearance, timing, or
  - body: { id?: integer, url?: string, name?: string, theme?: string, closable?: boolean, language?: string, position?: string, installed?: boolean, page_load?: integer, randomize?: boolean, utm_medium?: string, utm_source?: string, display_for?: integer, hide_mobile?: boolean, display_period?: integer, time_ago_period?: integer, display_interval?: integer, maximum_per_page?: string, display_threshold?: integer, loop_notification?: boolean, time_ago_threshold?: integer, event_types_attributes?: object[] }
- `POST https://api.mcp.ai/api/fomo/update/event` — Tool to update an existing Fomo event. Changes key-value pairs of an event such as location, name, title, or custom fields. Use when you need to modify event properties after creation.
  - body: { id: integer, url?: string, city?: string, title?: string, country?: string, province?: string, image_url?: string, created_at?: string, first_name?: string, ip_address?: string, external_id?: string, email_address?: string, event_type_id: integer, custom_event_fields_attributes?: object[] }

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

## More
- Page: https://mcp.ai/fomo
- Agent spec (llms.txt): https://mcp.ai/fomo/llms.txt
- Postman collection: https://mcp.ai/fomo/postman.json