Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Canny MCP server

Vendor MCP
Open markdown

The Canny MCP connector routes your AI agent's tool calls to Canny's own MCP server through Scalekit. Each user signs in to Canny once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 64 tools.

Tools
64
What they doRead · write · destructive
29 · 14 · 2129 read14 write21 destructive
Users sign in with
OAuth app
Your own Canny MCP server app

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 Canny MCP connection

    In AgentKit > Connections, create a Canny MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Canny MCP server connections use your own OAuth app. Register one with Canny MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Canny MCP connection.

  5. 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 = 'cannymcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Canny MCP:', 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: 'cannymcp_list_admins',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • cannymcp_list_adminsRead-only: Returns all admin teammates, including each admin name so callers can identify users.Read-only

    List Admin Teammates

    Read-only: Returns all admin teammates, including each admin name so callers can identify users. By default, admin IDs are omitted. To include IDs for use with other tools that accept admin IDs, pass `include: ["ids"]`. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

    Inputs

    includearray
    Optional response fields to include. Pass `["ids"]` to include admin IDs for cross-tool usage.
  • cannymcp_list_board_categoriesRead-only: Returns categories that belong to the provided board.Read-only

    List Board Categories

    Read-only: Returns categories that belong to the provided board. Categories may be nested via `parentID`.

    Inputs

    boardIDstringrequired
    The ID of the board whose categories should be returned.
    limitnumber
    The maximum number of categories to return.default 25
    skipnumber
    The number of categories to skip.default 0
  • cannymcp_list_board_tagsRead-only: Returns tags that belong to the provided board sorted by newest first.Read-only

    List Board Tags

    Read-only: Returns tags that belong to the provided board sorted by newest first.

    Inputs

    boardIDstringrequired
    The ID of the board whose tags should be returned. Use `list_boards` to discover valid board IDs.
    limitnumber
    The maximum number of tags to return.default 25
    skipnumber
    The number of tags to skip.default 0
  • cannymcp_list_boardsRead-only: Returns all boards.Read-only

    List Boards

    Read-only: Returns all boards. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

    Inputs

    This tool takes no inputs.

  • cannymcp_list_changelog_entriesRead-only: Returns changelog entries, filtered and sorted by the given parameters.Read-only

    List Changelog Entries

    Read-only: Returns changelog entries, filtered and sorted by the given parameters.

    Inputs

    labelIDsarray
    Filter to entries that have any of these label IDs. Discover valid IDs via `list_changelog_labels`.
    limitnumber
    The maximum number of changelog entries to return.default 10
    skipnumber
    The number of changelog entries to skip.default 0
    sortstring
    How to sort the returned entries.one of createdlastSavednonPublishedFirstpublishedAtdefault nonPublishedFirst
    typestring
    Filter to entries of this type.one of fixednewimproved
  • cannymcp_list_changelog_labelsRead-only: Returns all changelog labels.Read-only

    List Changelog Labels

    Read-only: Returns all changelog labels. Labels are used to categorize changelog entries.

    Inputs

    This tool takes no inputs.

  • cannymcp_list_commentsRead-only: Returns idea comments from a specific idea's activity tab.Read-only

    List Idea Comments

    Read-only: Returns idea comments from a specific idea's activity tab. Use `create_comment` to add one. Mentions in comment text are converted to readable plaintext names. By default, user-related identifiers are omitted. Pass `include: ["users"]` to include them.

    Inputs

    ideaIDstringrequired
    The ID of the idea whose comments should be returned.
    includearray
    Optional response fields to include. By default, user-related identifiers are omitted. Pass `["users"]` to include them.
  • cannymcp_list_companiesRead-only: Returns a list of all companies associated with your company, ordered by created date, optionally filtered by search query or scoped to a segment.Read-only

    List Companies

    Read-only: Returns a list of all companies associated with your company, ordered by created date, optionally filtered by search query or scoped to a segment.

    Inputs

    cursorstring
    The pagination cursor. Use the `nextCursor` value from a previous response to fetch the next page. Not supported with `search`.
    limitnumber
    The maximum number of companies to return.default 10
    searchstring
    A search query to filter companies by name.
    segmentIDstring
    The ID of a segment to scope companies to. Use the `list_segments` tool to discover valid IDs. Only a segment's company-scoped attributes are applied, so a segment whose `objectType` is 'mixed' narrows the results by part of its definition, and one whose `objectType` is 'user' is rejected because it cannot narrow companies at all.