MCP server (Lookout)

Connect Cursor, Claude Desktop, or any MCP client to your Lookout account over HTTP JSON-RPC. Use the same Personal access token you create under Profile for the REST API.

Endpoint: POST https://uselookout.app/mcp/lookout
Auth: Authorization: Bearer <sanctum_token> (or ?api_token= on GET-style clients only — prefer the header)
Throttle: 120 requests/minute per user (same as /api/v1).

Cursor configuration

Add to your project or user MCP config (replace host and token):

{
  "mcpServers": {
    "lookout": {
      "url": "https://uselookout.app/mcp/lookout",
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

Local dev example: http://lookout.test/mcp/lookout

Tools (17)

Tool	Purpose
`lookout_me`	Current user, organizations, teams
`lookout_list_projects`	Projects you can access
`lookout_create_project`	Create a project (returns full `api_key` once)
`lookout_get_project`	Single project metadata
`lookout_list_grouped_errors`	Grouped issues with search/status filters
`lookout_error_group_count`	Count of matching groups
`lookout_occurrence_count`	Raw occurrence count
`lookout_list_occurrences`	Occurrences in a fingerprint group
`lookout_get_occurrence`	Full stack, context, breadcrumbs
`lookout_list_issue_comments`	Issue thread comments
`lookout_comment_on_error`	Post a comment (optional `parent_id` reply)
`lookout_resolve_error`	Resolve group (optional comment)
`lookout_open_error`	Re-open group
`lookout_ignore_error`	Ignore group
`lookout_snooze_error`	Snooze with preset or ISO8601 `until`
`lookout_unsnooze_error`	Clear snooze
`lookout_query_telemetry`	Query traces, logs, jobs, mail, gates, metrics, …

REST parity: every Sanctum v1 route in the REST API has a matching tool except ingest (project API key) and operator routes.

Resources

URI	Content
`lookout://openapi/v1.yaml`	OpenAPI 3 spec
`lookout://docs/api`	REST API markdown reference
`lookout://docs/ingest`	Ingest API markdown reference
`lookout://docs/mcp`	This page (connection + catalog)

Prompts

Prompt	Use when
`triage_error`	You have an `error_id` and need resolve/snooze/ignore workflow
`debug_slow_request`	Slow endpoints, failing jobs, log correlation
`investigate_regression`	Multi-release or post-deploy spike

Example JSON-RPC

List tools (after MCP initialize / notifications/initialized):

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Call a tool:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "lookout_list_projects",
    "arguments": {}
  }
}

Security

Treat personal access tokens like passwords. Scope tokens to people who can triage production.
MCP exposes the same project visibility as the web UI; 404 when a resource is not accessible.
Ingest and project API keys are not used on this endpoint — send events via the Ingest API instead.