Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Stormboard

Scalekit connector
Open markdown

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

Tools
50
What they doRead · write · destructive
19 · 25 · 619 read25 write6 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 Stormboard connection

    In AgentKit > Connections, create a Stormboard 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 = 'stormboard'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Stormboard:', 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: 'stormboard_auth_test',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Stormboard 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
  • stormboard_auth_testCheck that the API key works.Read-only

    Test Authentication

    Check that the API key works. Returns 200 when it is valid and 403 when it is not.

    Inputs

    This tool takes no inputs.

  • stormboard_idea_comments_listList the comments on an idea, oldest or newest first, optionally with an avatar map.Read-only

    List Idea Comments

    List the comments on an idea, oldest or newest first, optionally with an avatar map. Returns comments with author, text and time.

    Inputs

    idea_idintegerrequired
    Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
    avatarsinteger
    1 to include a map of user avatars, 0 to leave it out. Example: 0.one of 01
    orderstring
    Sort order. Defaults to asc. Example: asc.one of ascdesc
  • stormboard_idea_getGet one idea with its data and metadata: type, text or file data, color, shape, position, votes, comments count and task.Read-only

    Get Idea

    Get one idea with its data and metadata: type, text or file data, color, shape, position, votes, comments count and task. Returns the idea object.

    Inputs

    idea_idintegerrequired
    Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
  • stormboard_idea_tags_getGet the tag values set on an idea.Read-only

    Get Idea Tags

    Get the tag values set on an idea. Returns tag name/value pairs.

    Inputs

    idea_idintegerrequired
    Idea (sticky note) ID, from stormboard_storm_ideas_list. Example: 1000000.
  • stormboard_storm_access_getCheck whether you can access a Storm and with which role.Read-only

    Get My Storm Access

    Check whether you can access a Storm and with which role. Returns your access level, or 401 when you have no access.

    Inputs

    storm_idintegerrequired
    Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
  • stormboard_storm_chat_messages_listList the chat messages in a Storm.Read-only

    List Storm Chat Messages

    List the chat messages in a Storm. Returns messages with author, text and time. Use stormboard_storm_chat_unread_list for only unread ones.

    Inputs

    storm_idintegerrequired
    Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
  • stormboard_storm_chat_unread_listList the chat messages in a Storm you have not read yet.Read-only

    List Unread Storm Chat Messages

    List the chat messages in a Storm you have not read yet. Returns messages. Mark them read with stormboard_storm_chat_mark_read.

    Inputs

    storm_idintegerrequired
    Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.
  • stormboard_storm_connectors_listList the line connectors between ideas in a Storm.Read-only

    List Storm Connectors

    List the line connectors between ideas in a Storm. Returns connector IDs with their from and to ideas, label and color.

    Inputs

    storm_idintegerrequired
    Storm (board) ID, from stormboard_storms_list or the Storm's share dialog. Example: 49999.