Recall MCP Tools
Tools available in the Recall MCP server for querying logs.recall_query
Search logs using the Recall Query Language.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Query in Recall Query Language |
limit | number | No | Max results (default: 50) |
Examples
“Show me error logs from the last hour”
“Find logs for user 123”
“Show me slow requests”
recall_errors
Get error-level logs quickly.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
since | string | No | Time range (default: 1h) |
environment | string | No | Filter by environment |
Examples
“What errors happened today?”
“Show production errors”
recall_stats
Get aggregated log statistics.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
since | string | No | Time range (default: 24h) |
by | string | No | Group by: level, commit, hour, day |
Examples
“How many logs per level today?”
“Show hourly breakdown”
recall_by_session
Get all logs from a specific session.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | The session ID |
Examples
“Show me all logs from session sess_abc123”
recall_request
Get all logs from a specific request.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | The request ID |
Examples
“Show me logs for request req_xyz789”
recall_new_session
Create a new session for grouping related logs.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | No | Optional session name |
Examples
“Start a new session for this debugging session”
recall_clear_session
Delete all logs associated with a session.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | The session ID to clear |
Examples
“Clear all logs from my test session”
Query Language Reference
Thequery parameter uses the Recall Query Language:
Level Filters
level:error- Error logs onlylevel:error,warn- Errors and warnings
Time Filters
since:1h- Last hoursince:24h- Last 24 hourssince:7d- Last 7 days
Field Filters
env:production- Production onlyservice:api- API servicedata.user.id:123- Specific user
Text Search
"payment failed"- Search in messageerror timeout- Multiple terms