Connect AI agents to the Jam MCP server

Vendor MCP

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

Tools: 15
What they doRead · write · destructive: 13 · 2 · 013 read2 write0 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
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>
```
Create the Jam MCP connection
In AgentKit > Connections, create a Jam MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Jam MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'jammcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Jam MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'jammcp_listfolders',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "jammcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Jam MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="jammcp_listfolders",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

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 Playground Request a tool

jammcp_analyzevideoExtract user intents from a Jam recording.Read-only
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.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_fetchRetrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.Read-only
Fetch
Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.
Inputs
idstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_getconsolelogsRetrieve browser console output captured during the Jam session, including errors, warnings, info messages, and debug logs.Read-only
GetConsoleLogs
Retrieve browser console output captured during the Jam session, including errors, warnings, info messages, and debug logs.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
limitnumber
Maximum number of events to return
logLevelstring
Optional filter to limit logs to a specific log level (error, warn, info, log, debug)one of errorwarninfologdebug
jammcp_getdetailsRetrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.Read-only
GetDetails
Retrieve metadata and details for a specific Jam bug report, including author, description, timestamps, type, and metadata.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_getmetadataRetrieve custom metadata set via the jam.metadata() SDK.Read-only
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.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_getnetworkrequestsRetrieve network requests captured during the Jam session, including URLs, methods, status codes, headers, and response times.Read-only
GetNetworkRequests
Retrieve network requests captured during the Jam session, including URLs, methods, status codes, headers, and response times.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
contentTypestring
Filter by content type (e.g., 'application/json')
hoststring
Filter by host (e.g., 'api.example.com')
limitnumber
Maximum number of events to return
methodstring
Filter by HTTP method (e.g., 'GET', 'POST', 'PUT', 'DELETE')
statusCodenumber
Filter by HTTP status code (e.g., 500) or range (e.g., '4xx', '5xx')
jammcp_getscreenshotsRetrieve screenshots from screenshot-type Jams.Read-only
GetScreenshots
Retrieve screenshots from screenshot-type Jams. Use getDetails first to verify the Jam type before calling this tool.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_getusereventsRetrieve the timeline of user interactions captured in the Jam, including clicks, inputs, navigation, and scroll events.Read-only
GetUserEvents
Retrieve the timeline of user interactions captured in the Jam, including clicks, inputs, navigation, and scroll events.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_getvideotranscriptRetrieve the speech transcript (captions) from a video Jam recording in WebVTT format with timestamps.Read-only
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.
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
jammcp_listfoldersList folders in the team with optional search and pagination.Read-only
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.
Inputs
afterstring
Cursor for forward pagination (folder ID)
limitnumber
Maximum number of results to returndefault 50
orderBystring
Sort order fieldone of createdAtupdatedAtdefault createdAt
querystring
Search query to filter folders by name
jammcp_listjamsList Jam bug reports with filtering and pagination.Read-only
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.
Inputs
afterstring
Cursor for forward pagination (Jam ID)
authorstring
Author filter: "me", user name, email, or user ID
createdAtstring
Filter by creation date: ISO date string or ISO 8601 duration (e.g., "-P7D" for last 7 days)
folderstring
Folder filter: folder name, folder ID, folder short ID, or "root" for unfiled Jams
limitnumber
Maximum number of results to returndefault 50
orderBystring
Sort order fieldone of createdAtupdatedAtdefault createdAt
querystring
Text search query to filter Jams by title or description
typestring
Filter by Jam typeone of videoscreenshotreplay
urlstring
Filter by original page URL (partial match, case-insensitive)
jammcp_listmembersList team members with optional search and pagination.Read-only
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.
Inputs
afterstring
Cursor for forward pagination (user ID)
limitnumber
Maximum number of results to returndefault 50
querystring
Search query to filter users by name or email
jammcp_searchSearch for a Jam by extracting a UUID from a query string, jam.dev URL, or pasted text and returning matching Jam metadata.Read-only
Search
Search for a Jam by extracting a UUID from a query string, jam.dev URL, or pasted text and returning matching Jam metadata.
Inputs
querystringrequired
Search string containing a UUID or a jam.dev URL (e.g., https://jam.dev/c/{uuid})
jammcp_createcommentAdd a new comment to a Jam bug report.Write
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.
Inputs
bodystringrequired
The comment body in Markdown format
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
playbackRelativeTimestampnumber
Optional 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_updatejamUpdate a Jam bug report.Write
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.
- Idempotent
Inputs
jamIdstringrequired
Jam identifier — a UUID or a jam.dev URL
folderstring
Target folder: folder name, folder ID, folder short ID, or "root" to move to root level

Setup

Install the SDK

Set your credentials

Create the Jam MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

AnalyzeVideo

Inputs

Fetch

Inputs

GetConsoleLogs

Inputs

GetDetails

Inputs

GetMetadata

Inputs

GetNetworkRequests

Inputs

GetScreenshots

Inputs

GetUserEvents

Inputs

GetVideoTranscript

Inputs

ListFolders

Inputs

ListJams

Inputs

ListMembers

Inputs

Search

Inputs

CreateComment

Inputs

UpdateJam

Inputs

Related: other Developer Tools connectors