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
- OAuth app
- Your own Cargo MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>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_nameyour code passes. See Configure connections.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.
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.actionsconst connector = 'cargomcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'cargomcp_whoami',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "cargomcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Cargo MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="cargomcp_whoami",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcargomcp_autocomplete_actionResolve autocomplete options for a connector action (HubSpot object types, Slack channels, Metabase questions, …).Read-onlyAutocomplete 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-onlyBrowse 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-onlyDescribe 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-onlyGet 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-onlyGet 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-onlyGet 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-onlyGet 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-onlyList models
List data models in this workspace. Use describe_model then query_models.
Inputs
limitinteger- Maximum models to return (default 20, max 50).
cargomcp_list_runsList recent ad-hoc action runs in this workspace.Read-onlyList runs
List recent ad-hoc action runs in this workspace. Does not include play or tool workflow runs.
Inputs
createdAfterstring- Include runs created after this timestamp.
createdBeforestring- Include runs created before this timestamp.
isFinishedboolean- Whether to only select finished runs.
limitinteger- Maximum runs to return (default 20, max 50).
statusesarray- Only include runs in these statuses.
uuidsarray- Run identifiers to include.
cargomcp_map_contextList every indexed file in the workspace context (path, title, summary, folder) without reading any file body.Read-onlyMap the context
List every indexed file in the workspace context (path, title, summary, folder) without reading any file body. The context is the workspace's knowledge base — playbooks, ICP definitions, scoring rubrics, internal docs. Start here to discover what exists, then search_context or read_context for the parts the task needs. This surface is read-only; write through the workspace's context capability.
Inputs
clusterstring- Restrict the map to one top-level folder (e.g. `persona`).
includeReferencesboolean- Also return the edges between files. Defaults to false — it can be large.
cargomcp_query_modelsRun one read-only SQL SELECT over this workspace's models: its companies, contacts, deals and other records, including those synced from connected CRMs and warehouses.Read-onlyQuery models with SQL
Run one read-only SQL SELECT over this workspace's models: its companies, contacts, deals and other records, including those synced from connected CRMs and warehouses. Answer pipeline and account questions with one aggregate query rather than paging a CRM API. Reference a model as dataset.model — take the exact reference from describe_model. Joins, aggregates and CTEs are allowed; anything other than SELECT is refused. Aggregate rather than paging: the row cap is small.
Inputs
querystringrequired- A single SELECT statement, e.g. select owner, count(*) from default.companies group by owner.
limitinteger- Maximum rows to return (default 20, max 50).
cargomcp_read_contextRead a UTF-8 file from the workspace context.Read-onlyRead a context file
Read a UTF-8 file from the workspace context. Reads with no endLine return only the first 250 lines and set truncated; pass a 1-indexed inclusive startLine/endLine range to page through the rest or target a section. The response always carries totalLines.
Inputs
pathstringrequired- Path of the file to read, relative to the context root. Use the path returned by map_context, search_context, or browse_context.
endLineinteger- 1-indexed inclusive last line to return. Must be greater than or equal to startLine.
startLineinteger- 1-indexed inclusive first line to return. Defaults to the first line.
cargomcp_search_actionsFind what to run for GTM work: enrichment and contact finding across many providers, CRM reads and writes (HubSpot, Salesforce, …) through the workspace's connected integrations, Cargo native operations, the workspace's own tools, and its agents.Read-onlySearch actions
Find what to run for GTM work: enrichment and contact finding across many providers, CRM reads and writes (HubSpot, Salesforce, …) through the workspace's connected integrations, Cargo native operations, the workspace's own tools, and its agents. Search here before reaching for a provider-specific MCP: one search covers every provider the workspace can reach, and the workspace's tools are the team's predefined plays. Cargo's presets (such as the Find email and Find phone tools) are read-only tools and agents seeded into every workspace; a preset tool tries several providers in one call, and presets rank first on equal relevance. Among results that match the whole query, actions billed in Cargo credits come first (they run on Cargo's own provider keys, no setup), then actions of integrations the workspace has connected, then actions that need a connection first. Price: a result carries credits[].cost. Without credits, a connector or native action costs nothing, and a tool or agent is priced by the steps it runs. Several entries on a tool mean its price depends on the path it takes, between the lowest and the highest. Each result includes autocompletes when input fields need a picked id. Pass the returned action to get_action_schema, autocomplete_action, execute_action, or execute_action_batch. Never fan out execute_action record-by-record — use execute_action_batch.
Inputs
integrationSlugstring- Restrict connector actions to this integration.
kindstring- Restrict results to one action kind.one of
connectornativetoolagent limitinteger- Maximum results to return (default 20, max 50).
querystring- Describe the job in plain words ("sync accounts to hubspot") or give an action id, slug, or name. Matched against action slug, name, description, and integration, with common GTM synonyms; an action does not need every word.
cargomcp_search_contextSearch context file contents and return matching lines (path, line number, snippet), never whole files.Read-onlySearch the context
Search context file contents and return matching lines (path, line number, snippet), never whole files. At most 5 matches per file, so results spread across files. Use it to locate a term, then read_context a tight range around the hits.
Inputs
querystringrequired- Text or POSIX extended regular expression to match against file contents.
caseInsensitiveboolean- Match case-insensitively. Defaults to false.
filesOnlyboolean- Return only the paths of files that contain a match, without the matching lines.
globstring- Restrict which files are searched (e.g. `*.md`).
limitinteger- Maximum results to return (default 40, max 200). If the result is truncated, narrow the query rather than raising this.
pathstring- Restrict the search to this file or folder. Defaults to the whole context.
cargomcp_whoamiReturn the signed-in user, the workspace this MCP session is bound to, and a plan/credits snapshot.Read-onlyWho am I
Return the signed-in user, the workspace this MCP session is bound to, and a plan/credits snapshot.
Inputs
This tool takes no inputs.
cargomcp_execute_actionRun one action on a single input: enrich a company, find a contact's email, read or write one CRM record through the workspace's connector, or run a workspace tool.DestructiveExecute action
Run one action on a single input: enrich a company, find a contact's email, read or write one CRM record through the workspace's connector, or run a workspace tool. Creates a run and consumes credits. If the result is outcome executing, poll with get_run. Do not loop this over a list — use execute_action_batch.
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.
dataobjectrequired- Input for the run. Must match get_action_schema.input. Do not put inputs on action.config.
cargomcp_execute_action_batchRun one action over a whole list in a single batch: enrich a CSV, push 40 companies to the CRM, find emails for every contact.DestructiveExecute action batch
Run one action over a whole list in a single batch: enrich a CSV, push 40 companies to the CRM, find emails for every contact. Use it for bulk GTM work instead of looping execute_action or a provider's single-record tool, and inspect the one batch afterwards. If the result is outcome executing, poll with get_batch. A finished batch includes one page of the CSV in data.text (default 100 rows). If truncated is true, call get_batch with the next offset. Read data.text. Do not fetch the URL.
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.
recordsarrayrequired- One input object per record.
limitinteger- Pilot: submit only the first N records. Inspect output before running the full set.
No tools match.