{
  "info": {
    "name": "Beamer — mcp.ai",
    "description": "REST API for the Beamer MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/beamer",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "beamer_count_post_comments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/post/comments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "post",
            "comments"
          ]
        },
        "description": "Tool to count existing comments on a specific post. Use when you need the total number of comments matching specific filters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dateTo\": \"\",\n  \"postId\": 0,\n  \"search\": \"\",\n  \"dateFrom\": \"\",\n  \"language\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_count_post_reactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/post/reactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "post",
            "reactions"
          ]
        },
        "description": "Tool to count existing reactions on a specific post. Use when you need the total number of reactions for a given post.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"postId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_count_posts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/posts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "posts"
          ]
        },
        "description": "Tool to count existing posts. Use when you need the number of posts matching specific filters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dateTo\": \"\",\n  \"filter\": \"\",\n  \"userId\": \"\",\n  \"expired\": false,\n  \"archived\": false,\n  \"category\": \"\",\n  \"dateFrom\": \"\",\n  \"language\": \"\",\n  \"filterUrl\": \"\",\n  \"published\": false,\n  \"forceFilter\": \"\",\n  \"ignoreFilters\": false,\n  \"filterByUserId\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_count_unread_posts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/unread/posts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "unread",
            "posts"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"filter\": \"\",\n  \"userId\": \"\",\n  \"dateFrom\": \"\",\n  \"filterUrl\": \"\",\n  \"userEmail\": \"\",\n  \"forceFilter\": \"\",\n  \"userLastName\": \"\",\n  \"userFirstName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_category",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/category",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "category"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"category_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_feed",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/feed",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "feed"
          ]
        },
        "description": "Tool to retrieve the URL for your standalone feed. Use after embedding to fetch the feed link for embedding or sharing.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"theme\": \"\",\n  \"filter\": \"\",\n  \"userId\": \"\",\n  \"language\": \"\",\n  \"userEmail\": \"\",\n  \"filterByUrl\": false,\n  \"forceFilter\": \"\",\n  \"userLastName\": \"\",\n  \"ignoreFilters\": false,\n  \"userFirstName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_notification",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/notification",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "notification"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"notificationId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_notifications",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/notifications",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "notifications"
          ]
        },
        "description": "Tool to fetch unread notifications. Use after providing user context to retrieve and mark notifications as read.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"filter\": \"\",\n  \"userId\": \"\",\n  \"category\": \"\",\n  \"dateFrom\": \"\",\n  \"language\": \"\",\n  \"filterUrl\": \"\",\n  \"saveViews\": false,\n  \"userEmail\": \"\",\n  \"markAsRead\": false,\n  \"maxResults\": 0,\n  \"forceFilter\": \"\",\n  \"userLastName\": \"\",\n  \"ignoreFilters\": false,\n  \"userFirstName\": \"\",\n  \"traceableLinks\": false,\n  \"ignoreRequestDetails\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_post_comments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/post/comments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "post",
            "comments"
          ]
        },
        "description": "Tool to retrieve comments for a specific post. Use after identifying the post ID to list its comments.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"dateTo\": \"\",\n  \"postId\": 0,\n  \"search\": \"\",\n  \"dateFrom\": \"\",\n  \"language\": \"\",\n  \"maxResults\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_post_reactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/post/reactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "post",
            "reactions"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"dateTo\": \"\",\n  \"postId\": 0,\n  \"dateFrom\": \"\",\n  \"reaction\": \"\",\n  \"maxResults\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_get_posts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/posts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "posts"
          ]
        },
        "description": "Tool to retrieve a list of posts. Use when you need IDs and titles of posts for further operations.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beamer_ping",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/ping",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "ping"
          ]
        },
        "description": "Tool to ping the Beamer API. Use when verifying API key authentication before making further requests.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}