Connect AI agents to the LogRocket MCP server

Vendor MCP

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

Tools: 8
What they doRead · write · destructive: 8 · 0 · 08 read0 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 LogRocket MCP connection
In AgentKit > Connections, create a LogRocket MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for LogRocket 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 = 'logrocketmcp'
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 LogRocket 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: 'logrocketmcp_list_organizations',
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 = "logrocketmcp"
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 LogRocket 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="logrocketmcp_list_organizations",
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

logrocketmcp_build_metricUse this to query LogRocket analytics data.Read-only
Build Metric
Use this to query LogRocket analytics data. This tool translates your natural language query into a LogRocket metric (e.g., timeseries, table, conversion funnel) that is then used to find relevant data. It's best used for performing aggregate analysis (e.g., session totals over time, browser or country breakdowns, conversion rates between steps). Returns an object with a `metricDefinition` field indicating the LogRocket metric that was used to find the data and a `metricQueryResult` field containing the corresponding analytics data.
Inputs
organizationIDstringrequired
The organization ID to run the query against. If not provided by the user, discover options using the list_organizations tool.
projectIDstringrequired
The project ID to run the query against. If not provided by the user, discover options using the list_projects tool.
querystringrequired
Natural language query describing the analytics data you want to retrieve.
limitinteger
Maximum number of rows/buckets returned in metricQueryResult for top-N or table-style metrics (e.g., top countries, top pages, top users). Defaults to 20. This does not control sessionDefinitions and may be ignored for metric types that do not return ranked row buckets.
timezonestring
Optional IANA timezone (e.g., 'America/New_York'). Time buckets align to this timezone's calendar (e.g., daily buckets break at its midnight). When omitted, they align to UTC.
logrocketmcp_find_issuesUse this to list a LogRocket project's issues.Read-only
Find Issues
Use this to list a LogRocket project's issues. This includes error signals detected in session recordings, specifically JavaScript exceptions, network errors, rage clicks, dead clicks, frustrating network requests, error states, and mobile crash reports. Issues can be filtered by severity, triage status, issue type, and time range, and optionally refined with a natural language query. Returns an object with an `issues` field listing matching issues, each with its issue type, platform, event count, first/last seen dates, `triageStatus`, a `url` linking to the issue's detail page in the LogRocket dashboard, and an AI-generated `issueDescription` when one exists.
Inputs
organizationIDstringrequired
The organization ID to run the query against. If not provided by the user, discover options using the list_organizations tool.
projectIDstringrequired
The project ID to run the query against. If not provided by the user, discover options using the list_projects tool.
endDatestring
Optional ISO 8601 datetime for the end of the time range to search. Defaults to now.
issueTypesarray
Optional list of issue types to include. "exception" covers JavaScript exceptions and mobile errors, "networkError" failed network requests, "mobileCrash" mobile app crash reports, "rageClick" repeated frustrated clicks, "deadClick" clicks with no visible effect, "frustratingNetworkRequest" impatient user actions during slow requests, and "errorState" error pages and modals users encounter. Defaults to all issue types.
limitinteger
Maximum number of issues to fetch, applied before any natural language relevance filtering. Defaults to 30.
querystring
Optional natural language query used to refine results (e.g., "checkout errors affecting Chrome users"). When provided, additional filters are parsed from the query and results are filtered to those relevant to it. Omit to list issues using only the structured parameters.
severitystring
Optional severity filter. "severe" returns only issues where LogRocket detected significant user impact and generated an issue description; "notSevere" returns only issues without one; "any" returns both. Defaults to "severe".one of severenotSevereany
startDatestring
Optional ISO 8601 datetime for the start of the time range to search. Defaults to a lookback of one week. Issues data is only retained for 30 days: start dates older than that are clamped to 30 days ago, and time ranges ending more than 30 days ago return no issues.
triageStatusesarray
Optional list of triage statuses to include. Issues start as "untriaged" and can be triaged by users to "highImpact", "lowImpact", or "ignored". Defaults to ["untriaged"], matching the default dashboard issues view.
logrocketmcp_find_sessionsUse this to find LogRocket sessions matching a natural language query.Read-only
Find Sessions
Use this to find LogRocket sessions matching a natural language query. This tool translates your natural language query into LogRocket filters that are then used to find relevant sessions. It's best used for filtering sessions based on user ID or email, custom user traits, visited page or URL, custom events, text inputs, clicked on text or CSS selector, network errors, IP address, user location (e.g., country), and/or other basic metadata, in addition to over a specific date range (e.g., last week). Returns an object with a list of relevant sessions in the `sessionDefinitions` field, each with recording ID, session ID, session URL, date of recording as a Unix timestamp in milliseconds, and other basic metadata. The returned object will also include a `metricDefinition` field indicating which LogRocket filters were used to find the sessions.
Inputs
organizationIDstringrequired
The organization ID to run the query against. If not provided by the user, discover options using the list_organizations tool.
projectIDstringrequired
The project ID to run the query against. If not provided by the user, discover options using the list_projects tool.
querystringrequired
Natural language query describing the sessions you want to find.
limitinteger
Maximum number of sessions to return. Defaults to 10.
logrocketmcp_get_network_entriesUse this to retrieve raw network request and response pairs recorded during a single LogRocket session, identified by its recording ID and session ID, as a HAR 1.2 document.Read-only
Get Network Entries
Use this to retrieve raw network request and response pairs recorded during a single LogRocket session, identified by its recording ID and session ID, as a HAR 1.2 document. Prefer this tool over watch_sessions when you only need network data. The response is an object with `total`, `offset`, `limit`, and `har`; entries are sorted by request start time and paginated, so if `offset + limit < total`, call the tool again with a higher offset to fetch the next page.
Inputs
organizationIDstringrequired
The organization ID to run the query against. If not provided by the user, discover options using the list_organizations tool.
projectIDstringrequired
The project ID to run the query against. If not provided by the user, discover options using the list_projects tool.
recordingIDstringrequired
The recording ID of the session.
sessionIDintegerrequired
The session ID of the session. Provide this as an integer.
endTimestring
Optional ISO 8601 datetime. Only entries whose request started at or before this time are returned. Defaults to the end of the session.
limitinteger
Maximum number of entries to return per call. Defaults to 100.
maxStatusinteger
Optional inclusive upper bound on the response status code.
methodsarray
Optional list of HTTP methods (e.g., ["POST", "PUT"]). Only entries whose request used one of these methods are returned. Matching is case-insensitive.
minStatusinteger
Optional inclusive lower bound on the response status code. Combine with maxStatus to select a range (e.g., 500 and 599 for server errors) or use both with the same value to select one code (e.g., 404).
offsetinteger
Number of matching entries to skip, for pagination. Defaults to 0.
startTimestring
Optional ISO 8601 datetime. Only entries whose request started at or after this time are returned. Defaults to the start of the session.
urlFilterstring
Optional case-insensitive substring filter applied to request URLs (e.g., "/api/cart" or "subdomain.example.com"). Only entries whose URL contains this substring are returned.
logrocketmcp_list_organizationsList all LogRocket organizations the authenticated user has access to.Read-only
List Organizations
List all LogRocket organizations the authenticated user has access to. Use this first to discover available organizations before querying projects or sessions.
Inputs
This tool takes no inputs.
logrocketmcp_list_projectsList all projects within a LogRocket organization.Read-only
List Projects
List all projects within a LogRocket organization. Use this to identify accessible projects before querying sessions, metrics, or issues.
Inputs
organizationSlugstringrequired
The slug of the LogRocket organization. Use the list_organizations tool to find available organization slugs.
logrocketmcp_use_logrocketProcess a natural language query against LogRocket data — sessions, metrics, and issues.Read-only
Use LogRocket
Process a natural language query against LogRocket data — sessions, metrics, and issues. Use this to investigate user-reported bugs, understand behavior patterns, analyze performance metrics, and detect regressions by correlating code changes with LogRocket data.
Inputs
organizationSlugstringrequired
The slug of the LogRocket organization to query. Use the list_organizations tool to find available slugs.
projectSlugstringrequired
The slug of the LogRocket project to query. Use the list_projects tool to find available slugs.
querystringrequired
Natural language query describing what to investigate. Examples: 'show me sessions where users encountered a checkout error', 'how many users hit the payment failure last week', 'find sessions with rage clicks on the signup button'.
logrocketmcp_watch_sessionsUse this to analyze one or more LogRocket sessions, each identified by its recording ID and session ID.Read-only
Watch Sessions
Use this to analyze one or more LogRocket sessions, each identified by its recording ID and session ID. You can use this tool to understand user behavior in the session or to extract additional information about the session (e.g., metadata, console logs, network requests and responses). Provide a separate natural language query describing what you want to know for each session to be analyzed. Sessions are analyzed in parallel, independently of each other. Session watching can take several minutes to complete; if pendingResults are returned, continue calling this tool with pollForResults: true and the pending fingerprints until all requests are complete.
Inputs
organizationIDstringrequired
The organization ID to run the query against. If not provided by the user, discover options using the list_organizations tool.
projectIDstringrequired
The project ID to run the query against. If not provided by the user, discover options using the list_projects tool.
fingerprintsarray
Fingerprints identifying session watching requests that are still pending. Required when pollForResults is true.
pollForResultsboolean
Set to true to poll for completion of previously-submitted session watching requests. Omit in all other cases.
sessionsarray
Sessions to be analyzed. Required when pollForResults is omitted or false. Omit when polling for already-submitted fingerprints.

Setup

Install the SDK

Set your credentials

Create the LogRocket MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Build Metric

Inputs

Find Issues

Inputs

Find Sessions

Inputs

Get Network Entries

Inputs

List Organizations

Inputs

List Projects

Inputs

Use LogRocket

Inputs

Watch Sessions

Inputs

Related: other Analytics connectors