# Beamer — how to use (mcp.ai)

Connect your Beamer account and use 12 tools for notifications straight from your AI agent. Connect with your own API key. Beamer is a platform that enables companies to announce news, updates, and features directly within their applications or websites, enhancing user engagement and communication.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_beamer?ms=1787295840000`
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. `beamer_count_post_comments`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/beamer`
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/beamer/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/beamer/count/post/comments` — Tool to count existing comments on a specific post. Use when you need the total number of comments matching specific filters.
  - body: { dateTo?: string, postId: integer, search?: string, dateFrom?: string, language?: string }
- `POST https://api.mcp.ai/api/beamer/count/post/reactions` — Tool to count existing reactions on a specific post. Use when you need the total number of reactions for a given post.
  - body: { postId: integer }
- `POST https://api.mcp.ai/api/beamer/count/posts` — Tool to count existing posts. Use when you need the number of posts matching specific filters.
  - body: { dateTo?: string, filter?: string, userId?: string, expired?: boolean, archived?: boolean, category?: string, dateFrom?: string, language?: string, filterUrl?: string, published?: boolean, forceFilter?: string, ignoreFilters?: boolean, filterByUserId?: boolean }
- `POST https://api.mcp.ai/api/beamer/count/unread/posts` — Tool to count unread posts for a user. Use when you need the number of posts the user would see when opening their Beamer feed.
  - body: { filter?: string, userId?: string, dateFrom?: string, filterUrl?: string, userEmail?: string, forceFilter?: string, userLastName?: string, userFirstName?: string }
- `POST https://api.mcp.ai/api/beamer/get/category` — Tool to retrieve metadata for a Beamer category by its ID. Use when you need category information for filtering or grouping posts. Beamer uses a fixed set of categories: new, improvement, fix, comings
  - body: { category_id: string }
- `POST https://api.mcp.ai/api/beamer/get/feed` — Tool to retrieve the URL for your standalone feed. Use after embedding to fetch the feed link for embedding or sharing.
  - body: { theme?: string, filter?: string, userId?: string, language?: string, userEmail?: string, filterByUrl?: boolean, forceFilter?: string, userLastName?: string, ignoreFilters?: boolean, userFirstName?: string }
- `POST https://api.mcp.ai/api/beamer/get/notification` — Tool to retrieve details of a specific notification by its unique notification ID. Use after obtaining the notification ID to fetch its full details.
  - body: { notificationId: integer }
- `POST https://api.mcp.ai/api/beamer/get/notifications` — Tool to fetch unread notifications. Use after providing user context to retrieve and mark notifications as read.
  - body: { page?: integer, filter?: string, userId?: string, category?: string, dateFrom?: string, language?: string, filterUrl?: string, saveViews?: boolean, userEmail?: string, markAsRead?: boolean, maxResults?: integer, forceFilter?: string, userLastName?: string, ignoreFilters?: boolean, userFirstName?: string, traceableLinks?: boolean, ignoreRequestDetails?: boolean }
- `POST https://api.mcp.ai/api/beamer/get/post/comments` — Tool to retrieve comments for a specific post. Use after identifying the post ID to list its comments.
  - body: { page?: integer, dateTo?: string, postId: integer, search?: string, dateFrom?: string, language?: string, maxResults?: integer }
- `POST https://api.mcp.ai/api/beamer/get/post/reactions` — Tool to retrieve all reactions associated with a specific post. Use when you need to list reactions and optionally filter by date, reaction type, or pagination.
  - body: { page?: integer, dateTo?: string, postId: integer, dateFrom?: string, reaction?: string, maxResults?: integer }
- `POST https://api.mcp.ai/api/beamer/get/posts` — Tool to retrieve a list of posts. Use when you need IDs and titles of posts for further operations.
- `POST https://api.mcp.ai/api/beamer/ping` — Tool to ping the Beamer API. Use when verifying API key authentication before making further requests.

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

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