MCP server

Ask Peak to turn on the MCP server for your workspace.

Before you start

Create a token with these scopes through API access.

workspace:read
runs:read

Store it in this environment variable.

PEAK_TOKEN

Connect your agent

Claude Code
Cursor
Other agents

claude mcp add --transport http peak https://app.peak.inc/api/mcp \
  --header "Authorization: Bearer $PEAK_TOKEN"

Add this flag to use it in every project.

--scope user

~/.cursor/mcp.json

{
  "mcpServers": {
    "peak": {
      "url": "https://app.peak.inc/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PEAK_TOKEN}" }
    }
  }
}

Use this Streamable HTTP endpoint.

https://app.peak.inc/api/mcp

Send the token in this header.

Authorization: Bearer PEAK_TOKEN

Copy the same setup from Settings → API access → Connect an agent.

Ask your agent

Why did the last CI run on main fail? Which step is slowest in ci.yml this week?

Use the tools

Every tool reads data. No tool changes your workspace.

Tool	Use it to
get_workspace	Read the workspace name and ID.
list_runs	List jobs that ran on Peak, newest first.
get_run	Read one job’s runner, timing, and GitHub link.
list_workflow_runs	List a repository’s workflow runs.
get_workflow_run	Read each job’s queue time, run time, result, and failed steps.
get_workflow_timings	Read p50, p90, and max time per job and step.
list_runners	List runner pools and their repositories.
get_runner_status	Check capacity for each runner size.
list_runner_profiles	Read a repository’s profiles.
list_runner_types	List released runner labels.
find_repository	Find a repository’s GitHub ID by owner/name.
get_onboarding	Check setup progress.
list_audit_events	Read workspace activity. Needs audit:read.

Expect more tools when other beta features are on, such as job search, job logs, and test results.

Check limits

Expect up to 120 requests per minute per token. Expect larger results to fail with result_too_large. Narrow the request and retry.

Get started

Move to Peak

Runners

Insights

Peakviews

Developer tools

Workspace

Before you start

Connect your agent

Ask your agent

Use the tools

Check limits

​Before you start

​Connect your agent

​Ask your agent

​Use the tools

​Check limits

Before you start

Connect your agent

Ask your agent

Use the tools

Check limits