# Fomo — MCP server on 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.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_fomo?ms=1787296080000
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/fomo/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/fomo/<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/fomo/skill.md
Postman collection (v2.1): https://mcp.ai/fomo/postman.json

## Tools
- fomo_create_fomo_event(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[]) — 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
- fomo_create_fomo_template(name: string, message: string, image_url?: string, use_avatar?: boolean, use_ip_mapping?: boolean, markdown_enabled?: boolean) — 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
- fomo_delete_fomo_event(id: integer) — 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.
- fomo_get_fomo_event(id: integer) — 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.
- fomo_get_statistics(date_range_to: string, date_range_from: string) — 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
- fomo_list_events(page?: integer, order_by?: string, per_page?: integer, show_meta?: boolean, order_direction?: string) — 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
- fomo_search_event(q: string, field: string) — 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.
- fomo_update_application(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[]) — 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
- fomo_update_event(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[]) — 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.

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

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