Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Airspeed MCP server

Vendor MCP
Open markdown

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

Tools
71
What they doRead · write · destructive
45 · 11 · 1545 read11 write15 destructive
Users sign in with
OAuth app
Your own Airspeed 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 Airspeed MCP connection

    In AgentKit > Connections, create an Airspeed 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

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

    Then enter the app's Client ID and Client Secret on the Airspeed 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 = 'airspeedmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Airspeed 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: 'airspeedmcp_get_agent_thread',
    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
  • airspeedmcp_get_agentRead an agent using the app's live definition permissions.Read-only

    Get agent

    Read an agent using the app's live definition permissions. Personal view accepts the native workflow/template/installation identifiers. Organization view requires a template_id from the organization directory and returns that same safe projection. Neither view installs or executes agents.

    Inputs

    agent_idstringrequired
    No description.
    viewstring
    No description.one of personalorganizationdefault personal
  • airspeedmcp_get_agent_runRead the full latest output of one of your Airspeed agent runs.Read-only

    Get agent run

    Read the full latest output of one of your Airspeed agent runs. Accepts any run list_agent_runs can return: a chat or a run of a saved agent. For a conversation, the output is its latest reply. This retrieves an existing result; it does not start or rerun an agent. Use url_link to cite the run or send the user to it. Only runs owned by the signed-in user in their organization are available, including for admins. Missing runs and other people's runs both answer "Agent run not found".

    Inputs

    run_idstringrequired
    Run ID returned by list_agent_runs, which is also the conversation's thread ID.
  • airspeedmcp_get_agent_threadRead native conversation detail by exactly one thread ID or share ID.Read-only

    Get agent thread

    Read native conversation detail by exactly one thread ID or share ID. Thread IDs require ownership. Shared reads recheck the live share, tenant, and underlying resource access through the same app dependencies. Returns the app's visible messages and metadata, including native pending approvals for owner reads; this does not make approval decisions or start an agent.

    Inputs

    share_idstring
    No description.
    thread_idstring
    No description.
  • airspeedmcp_get_call_activity_statsRead native call-count, duration and talk statistics.Read-only

    Get call activity stats

    Read native call-count, duration and talk statistics. Users with activity-page permission default to the organization cohort; others default to their own home-widget statistics and cannot select others. Counts follow the caller's list visibility: a hidden call is absent, and a private call the caller did not join is absent too. A private call they joined still counts. Call titles are not returned. Dates use the native unbounded start/current-time end; exact time-range filters are not offered because the native API cannot honor them. Every request scans the full call history in scope, so avoid repeated calls.

    Inputs

    filtersstring
    No description.
  • airspeedmcp_get_call_infoRead a call's summary, extracted insights, and transcript.Read-only

    Get call info

    Read a call's summary, extracted insights, and transcript. Also returns participants, companies, tags, an Airspeed call link, and recording details when available. Stored CRM deal, contact, lead, and company IDs are included when available, separately from Airspeed IDs; each company's id is its Airspeed company ID, and a participant's user_id is their Airspeed user ID when matched. Use this to answer questions about what was discussed, building on Airspeed's existing analysis. Fields may be absent when their data is unavailable. Use url_link to cite the call. Only calls the user may read in full in Airspeed are available, including private calls they participated in. Missing, redacted, and hidden calls all answer "Call not found"; this does not prove a call never happened. Recording URLs expire after 24 hours. Set transcript={} to request bounded native raw text, or supply language for native translated turns. Truncated means content past the bound is not available over MCP: there is no offset or cursor, so repeating the request returns the same prefix. Raise the bound (up to 20000 characters or 100 turns) or send the user to url_link for the rest. A translated request translates the complete transcript every time, so do not repeat it. The default inline inferred transcript and recording behavior remains unchanged. comments_limit optionally returns recent top-level comments in native order, with direct reply counts but no reply bodies. reply_count does not include replies nested under those replies. The native reader still loads the whole comment tree; truncated reports omitted top-level comments, not a cursor.

    Inputs

    call_idstringrequired
    Call ID returned by list_calls or taken from an Airspeed call link. Do not use a call title as the ID.
    comments_limitstring
    Optional. Return up to this many recent top-level comments. Omit for the default response.
    transcriptstring
    Optional. {} returns raw text cut at max_characters; with language, returns translated turns cut at limit. Each bound applies only to its own form. Omit for the default response.
  • airspeedmcp_get_call_mediaGet a call's audio or video recording link and media type.Read-only

    Get call media

    Get a call's audio or video recording link and media type. Use this when the user wants the recording. For a transcript, summary, or insights, use get_call_info instead. Recording URLs expire after 24 hours; media may be absent when no recording is available. Only calls the user may read in full in Airspeed are available, including private calls they participated in. Missing, redacted, and hidden calls all answer "Call not found".

    Inputs

    call_idstringrequired
    Call ID returned by list_calls or taken from an Airspeed call link.
  • airspeedmcp_get_call_snippetsRead existing clips from a call, with their transcript excerpts.Read-only

    Get call snippets

    Read existing clips from a call, with their transcript excerpts. Returns saved snippets, newest first, with start and end times and recording links when available. Transcript turns cover only each snippet's range. This does not create clips or search for new excerpts. Use get_call_info for the full transcript. Recording URLs expire after 24 hours. Only calls the user may read in full in Airspeed are available, including private calls they participated in. Missing, redacted, and hidden calls all answer "Call not found". No snippets does not mean no call transcript.

    Inputs

    call_idstringrequired
    Call ID returned by list_calls or taken from an Airspeed call link.
  • airspeedmcp_get_changelogRead what changed in these tools, as Markdown, newest change first.Read-only

    Get changelog

    Read what changed in these tools, as Markdown, newest change first. Covers removed, renamed and merged tools and changes to their inputs or results that a client may need to act on. Call it when a tool you expected is missing or a call that used to work is rejected. The live tool list remains the source of truth for current schemas.

    Inputs

    This tool takes no inputs.