Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Beamer

Scalekit connector
Open markdown

The Beamer connector lets your AI agent act in each user's Beamer account. Each user connects their own Beamer API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 49 tools.

Tools
49
What they doRead · write · destructive
26 · 14 · 926 read14 write9 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Beamer connection

    In AgentKit > Connections, create a Beamer connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'beamer'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Beamer:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'beamer_feature_requests_count',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Beamer credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • beamer_feature_request_comment_getGet one comment on a feature request.Read-only

    Get Feature Request Comment

    Get one comment on a feature request. Returns the comment's id, text, visibility, date and author details.

    Inputs

    comment_idintegerrequired
    ID of the comment, from the matching comments list tool. Example: 7654321.
    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
  • beamer_feature_request_comments_countCount comments on a feature request.Read-only

    Count Feature Request Comments

    Count comments on a feature request. Returns the count.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
    date_fromstring
    Count comments published after this date. The date must follow the ISO-8601 format. Example: 2026-01-01T00:00:00Z.
    date_tostring
    Count comments published before this date. The date must follow the ISO-8601 format. Example: 2026-01-31T23:59:59Z.
    languagestring
    Count comments with translations in this language. The language must follow the ISO-639 two-letter code format. Example: en.
    searchstring
    Count comments with content that contain this text. Example: dark mode.
    visibleboolean
    Count only visible (or not visible) comments. If unspecified, both types of comments will be retrieved. Example: true.
  • beamer_feature_request_comments_listList comments on a feature request, at most 10 per page.Read-only

    List Feature Request Comments

    List comments on a feature request, at most 10 per page. Returns each comment's id, text, visibility, date and author details.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
    date_fromstring
    Retrieve comments published after this date. The date must follow the ISO-8601 format. Example: 2026-01-01T00:00:00Z.
    date_tostring
    Retrieve comments published before this date. The date must follow the ISO-8601 format. Example: 2026-01-31T23:59:59Z.
    languagestring
    Retrieve comments with translations in this language. The language must follow the ISO-639 two-letter code format. Example: en.
    max_resultsinteger
    Maximum number of items to return per page (Beamer returns at most 10). Example: 10.
    pageinteger
    Page number to return, combined with max_results, starting at 1. Example: 1.
    searchstring
    Retrieve comments with content that contain this text. Example: dark mode.
    visibleboolean
    Retrieve only visible (or not visible) comments. If unspecified, both types of comments will be retrieved. Example: true.
  • beamer_feature_request_getGet one feature request.Read-only

    Get Feature Request

    Get one feature request. Returns its id, translations, status, category, notes, visibility, vote and comment counts.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
  • beamer_feature_request_vote_getGet one vote on a feature request.Read-only

    Get Feature Request Vote

    Get one vote on a feature request. Returns the vote's id, date and voter details.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
    vote_idintegerrequired
    ID of the vote, from beamer_feature_request_votes_list. Example: 112233.
  • beamer_feature_request_votes_countCount the votes on a feature request.Read-only

    Count Feature Request Votes

    Count the votes on a feature request. Returns the count.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
  • beamer_feature_request_votes_listList the votes on a feature request, at most 10 per page.Read-only

    List Feature Request Votes

    List the votes on a feature request, at most 10 per page. Returns each vote's id, date and voter details. Use beamer_feature_request_votes_count for the total.

    Inputs

    feature_request_idintegerrequired
    ID of the feature request, from beamer_feature_requests_list. Example: 98765.
    date_fromstring
    Retrieve votes created after this date. The date must follow the ISO-8601 format. Example: 2026-01-01T00:00:00Z.
    date_tostring
    Retrieve votes created before this date. The date must follow the ISO-8601 format. Example: 2026-01-31T23:59:59Z.
    max_resultsinteger
    Maximum number of items to return per page (Beamer returns at most 10). Example: 10.
    pageinteger
    Page number to return, combined with max_results, starting at 1. Example: 1.
  • beamer_feature_requests_countCount feature requests matching the same filters as beamer_feature_requests_list.Read-only

    Count Feature Requests

    Count feature requests matching the same filters as beamer_feature_requests_list. Returns the count.

    Inputs

    categorystring
    Count feature requests with this category. Example: new.
    date_fromstring
    Count feature requests created after this date. The date must follow the ISO-8601 format. Example: 2026-01-01T00:00:00Z.
    date_tostring
    Count feature requests created before this date. The date must follow the ISO-8601 format. Example: 2026-01-31T23:59:59Z.
    filtersstring
    Count feature requests with a matching segmentation filter. (Only available on the Pro plan (and up)). Example: beta.
    languagestring
    Count feature requests with translations in this language. The language must follow the ISO-639 two-letter code format. Example: en.
    searchstring
    Count feature requests with title or content that contain this text. Example: dark mode.
    statusstring
    Count feature requests with this status. Example: under_review.
    visibleboolean
    Count only visible (or not visible) feature requests. If unspecified, both types of feature requests will be retrieved. Example: true.