Jam MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

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. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'jammcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Jam MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'jammcp_fetch',
     toolInput: { id: 'https://example.com/id' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "jammcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Jam MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"id":"https://example.com/id"},
       tool_name="jammcp_fetch",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Updatejam records — Update a Jam bug report
• Search records — Search for a Jam by extracting a UUID from a query string, jam.dev URL, or pasted text and returning matching Jam metadata
• Listmembers records — List team members with optional search and pagination
• Listjams records — List Jam bug reports with filtering and pagination
• Listfolders records — List folders in the team with optional search and pagination
• Getvideotranscript records — Retrieve the speech transcript (captions) from a video Jam recording in WebVTT format with timestamps

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

jammcp_analyzevideo#Extract user intents from a Jam recording. Identifies distinct user goals, issues, and feedback with detailed context including visual observations, interactions, and technical indicators.1 param▾

Extract user intents from a Jam recording. Identifies distinct user goals, issues, and feedback with detailed context including visual observations, interactions, and technical indicators.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_createcomment#Add a new comment to a Jam bug report. The comment body supports Markdown formatting. Use this to add notes, analysis results, or follow-up information to a Jam.3 params▾

Add a new comment to a Jam bug report. The comment body supports Markdown formatting. Use this to add notes, analysis results, or follow-up information to a Jam.

NameTypeRequiredDescription

bodystringrequiredThe comment body in Markdown format

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

playbackRelativeTimestampnumberoptionalOptional timestamp in milliseconds relative to the start of the media playback. When provided, the comment will be linked to that specific point in the video/replay.

jammcp_fetch#Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.1 param▾

Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.

NameTypeRequiredDescription

idstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_getconsolelogs#Retrieve browser console output captured during the Jam session, including errors, warnings, info messages, and debug logs.3 params▾

Retrieve browser console output captured during the Jam session, including errors, warnings, info messages, and debug logs.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

limitnumberoptionalMaximum number of events to return

logLevelstringoptionalOptional filter to limit logs to a specific log level (error, warn, info, log, debug)

jammcp_getdetails#Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.1 param▾

Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_getmetadata#Retrieve custom metadata set via the jam.metadata() SDK. Returns key-value pairs defined by the application developer, such as user IDs, app versions, feature flags, or any custom debugging context.1 param▾

Retrieve custom metadata set via the jam.metadata() SDK. Returns key-value pairs defined by the application developer, such as user IDs, app versions, feature flags, or any custom debugging context.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_getnetworkrequests#Retrieve network requests captured during the Jam session, including URLs, methods, status codes, headers, and response times.6 params▾

Retrieve network requests captured during the Jam session, including URLs, methods, status codes, headers, and response times.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

contentTypestringoptionalFilter by content type (e.g., 'application/json')

hoststringoptionalFilter by host (e.g., 'api.example.com')

limitnumberoptionalMaximum number of events to return

methodstringoptionalFilter by HTTP method (e.g., 'GET', 'POST', 'PUT', 'DELETE')

statusCodenumberoptionalFilter by HTTP status code (e.g., 500) or range (e.g., '4xx', '5xx')

jammcp_getscreenshots#Retrieve screenshots from screenshot-type Jams. Use getDetails first to verify the Jam type before calling this tool.1 param▾

Retrieve screenshots from screenshot-type Jams. Use getDetails first to verify the Jam type before calling this tool.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_getuserevents#Retrieve the timeline of user interactions captured in the Jam, including clicks, inputs, navigation, and scroll events.1 param▾

Retrieve the timeline of user interactions captured in the Jam, including clicks, inputs, navigation, and scroll events.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_getvideotranscript#Retrieve the speech transcript (captions) from a video Jam recording in WebVTT format with timestamps. Only available for video Jams where the microphone was enabled during recording. Use this to understand what the user said while recording the bug report.1 param▾

Retrieve the speech transcript (captions) from a video Jam recording in WebVTT format with timestamps. Only available for video Jams where the microphone was enabled during recording. Use this to understand what the user said while recording the bug report.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

jammcp_listfolders#List folders in the team with optional search and pagination. Returns folder metadata including name, short ID, Jam count, and timestamps. Use this to discover available folders for organizing Jams.4 params▾

List folders in the team with optional search and pagination. Returns folder metadata including name, short ID, Jam count, and timestamps. Use this to discover available folders for organizing Jams.

NameTypeRequiredDescription

afterstringoptionalCursor for forward pagination (folder ID)

limitnumberoptionalMaximum number of results to return

orderBystringoptionalSort order field

querystringoptionalSearch query to filter folders by name

jammcp_listjams#List Jam bug reports with filtering and pagination. Search by text, filter by type (video/screenshot/replay), folder, author, URL, or creation date. Returns Jam metadata including title, author, folder, and timestamps. Use this to find specific Jams or browse the team's bug reports.9 params▾

List Jam bug reports with filtering and pagination. Search by text, filter by type (video/screenshot/replay), folder, author, URL, or creation date. Returns Jam metadata including title, author, folder, and timestamps. Use this to find specific Jams or browse the team's bug reports.

NameTypeRequiredDescription

afterstringoptionalCursor for forward pagination (Jam ID)

authorstringoptionalAuthor filter: "me", user name, email, or user ID

createdAtstringoptionalFilter by creation date: ISO date string or ISO 8601 duration (e.g., "-P7D" for last 7 days)

folderstringoptionalFolder filter: folder name, folder ID, folder short ID, or "root" for unfiled Jams

limitnumberoptionalMaximum number of results to return

orderBystringoptionalSort order field

querystringoptionalText search query to filter Jams by title or description

typestringoptionalFilter by Jam type

urlstringoptionalFilter by original page URL (partial match, case-insensitive)

jammcp_listmembers#List team members with optional search and pagination. Returns user metadata including name, email, and role. Use this to find users for filtering Jams by author.3 params▾

List team members with optional search and pagination. Returns user metadata including name, email, and role. Use this to find users for filtering Jams by author.

NameTypeRequiredDescription

afterstringoptionalCursor for forward pagination (user ID)

limitnumberoptionalMaximum number of results to return

querystringoptionalSearch query to filter users by name or email

jammcp_search#Search for a Jam by extracting a UUID from a query string, jam.dev URL, or pasted text and returning matching Jam metadata.1 param▾

Search for a Jam by extracting a UUID from a query string, jam.dev URL, or pasted text and returning matching Jam metadata.

NameTypeRequiredDescription

querystringrequiredSearch string containing a UUID or a jam.dev URL (e.g., https://jam.dev/c/{uuid})

jammcp_updatejam#Update a Jam bug report. Currently supports moving Jams between folders. Use folder name, folder ID, folder short ID, or "root" to move to the root level.2 params▾

Update a Jam bug report. Currently supports moving Jams between folders. Use folder name, folder ID, folder short ID, or "root" to move to the root level.

NameTypeRequiredDescription

jamIdstringrequiredJam identifier — a UUID or a jam.dev URL

folderstringoptionalTarget folder: folder name, folder ID, folder short ID, or "root" to move to root level