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

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

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

## Tools
- beamer_count_post_comments(dateTo?: string, postId: integer, search?: string, dateFrom?: string, language?: string) — Tool to count existing comments on a specific post. Use when you need the total number of comments matching specific filters.
- beamer_count_post_reactions(postId: integer) — Tool to count existing reactions on a specific post. Use when you need the total number of reactions for a given post.
- beamer_count_posts(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) — Tool to count existing posts. Use when you need the number of posts matching specific filters.
- beamer_count_unread_posts(filter?: string, userId?: string, dateFrom?: string, filterUrl?: string, userEmail?: string, forceFilter?: string, userLastName?: string, userFirstName?: string) — 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.
- beamer_get_category(category_id: string) — 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
- beamer_get_feed(theme?: string, filter?: string, userId?: string, language?: string, userEmail?: string, filterByUrl?: boolean, forceFilter?: string, userLastName?: string, ignoreFilters?: boolean, userFirstName?: string) — Tool to retrieve the URL for your standalone feed. Use after embedding to fetch the feed link for embedding or sharing.
- beamer_get_notification(notificationId: integer) — Tool to retrieve details of a specific notification by its unique notification ID. Use after obtaining the notification ID to fetch its full details.
- beamer_get_notifications(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) — Tool to fetch unread notifications. Use after providing user context to retrieve and mark notifications as read.
- beamer_get_post_comments(page?: integer, dateTo?: string, postId: integer, search?: string, dateFrom?: string, language?: string, maxResults?: integer) — Tool to retrieve comments for a specific post. Use after identifying the post ID to list its comments.
- beamer_get_post_reactions(page?: integer, dateTo?: string, postId: integer, dateFrom?: string, reaction?: string, maxResults?: integer) — 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.
- beamer_get_posts() — Tool to retrieve a list of posts. Use when you need IDs and titles of posts for further operations.
- 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"

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