Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Cargo MCP server

Vendor MCP
Open markdown

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

Tools
17
What they doRead · write · destructive
15 · 0 · 215 read0 write2 destructive
Users sign in with
OAuth app
Your own Cargo 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 Cargo MCP connection

    In AgentKit > Connections, create a Cargo 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

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

    Then enter the app's Client ID and Client Secret on the Cargo 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 = 'cargomcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Cargo 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: 'cargomcp_whoami',
    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
  • cargomcp_autocomplete_actionResolve autocomplete options for a connector action (HubSpot object types, Slack channels, Metabase questions, …).Read-only

    Autocomplete action

    Resolve autocomplete options for a connector action (HubSpot object types, Slack channels, Metabase questions, …). Pass slug from search_actions.autocompletes. Resolve params to concrete values first — do not pass $this expression paths. Put chosen values in execute_action data, not action.config.

    Inputs

    actionobjectrequired
    An orchestration action (connector, native, tool, or agent). Use search_actions, then pass the returned action object here unchanged. It carries no config — inputs go in data or records.
    paramsobject
    Already-resolved params required by this autocomplete. Use the params schema from the listed result. If that schema has query, pass the search string there.
    slugstring
    Autocomplete slug from search_actions.autocompletes.
  • cargomcp_browse_contextList the files and folders at a path in the workspace context.Read-only

    Browse the context

    List the files and folders at a path in the workspace context. Pass depth -1 with no path for the full tree in one call. Navigates structure without reading any content.

    Inputs

    depthinteger
    Pass -1 together with no path to return the entire tree. Omit for a single non-recursive listing.
    pathstring
    Folder to list, relative to the context root. Omit to list the root.
  • cargomcp_describe_modelReturn a model's columns, dataset slug, and unquoted dataset.model reference without querying rows.Read-only

    Describe model

    Return a model's columns, dataset slug, and unquoted dataset.model reference without querying rows.

    Inputs

    modelUuidstring
    Model uuid from list_models.
    slugstring
    Model slug from list_models, if you do not have the uuid.
  • cargomcp_get_action_schemaResolve the input and output JSON schemas of a connector, native, tool, or agent action without executing it.Read-only

    Get action schema

    Resolve the input and output JSON schemas of a connector, native, tool, or agent action without executing it. Pass the action object from search_actions. For connector fields that need a picked id (list, object type, campaign), call autocomplete_action.

    Inputs

    actionobjectrequired
    An orchestration action (connector, native, tool, or agent). Use search_actions, then pass the returned action object here unchanged. It carries no config — inputs go in data or records.
    dataobject
    Inputs the action would run with, as for execute_action. Only needed when the output schema depends on them — a HubSpot object type, a sheet.
  • cargomcp_get_batchGet one batch by uuid.Read-only

    Get batch

    Get one batch by uuid. If execute_action_batch returned outcome "executing", call this until the batch has finished. A finished batch includes one page of the CSV in data.text. Pass offset and limit to read further pages (limit default 100, max 100). If truncated is true, call again with the next offset. totalRows is the total when this page reaches the end of the file. Read data.text. Do not fetch the URL. Does not return the raw batch record or internal storage keys.

    Inputs

    batchUuidstringrequired
    Batch uuid.
    limitinteger
    Data rows to return. Defaults to 100, max 100.
    offsetinteger
    Data rows to skip before this page. Defaults to 0. The header is included on every page.
  • cargomcp_get_runGet one run by uuid.Read-only

    Get run

    Get one run by uuid. Returns the same shape as execute_action: the last node output, run uuid, and credits used. If execute_action returned outcome "executing", call this until the run has finished. Does not return computed configs, execution traces, or other debug payloads.

    Inputs

    runUuidstringrequired
    Run uuid.
  • cargomcp_get_usageCredit usage for the last 7 days, grouped by integration.Read-only

    Get usage

    Credit usage for the last 7 days, grouped by integration. Check this before running paid actions.

    Inputs

    This tool takes no inputs.

  • cargomcp_list_modelsList data models in this workspace.Read-only

    List models

    List data models in this workspace. Use describe_model then query_models.

    Inputs

    limitinteger
    Maximum models to return (default 20, max 50).