How do I install the runframe mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `RUNFRAME_API_KEY`, `RUNFRAME_API_URL`, `MCP_ACCESS_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Runframe MCP Server

MCP server for Runframe incident management — any agent, any IDE, one system of record

Local serverstdio

What is the Runframe MCP Server?

MCP server for Runframe incident management — any agent, any IDE, one system of record

What the server does

17 tools covering incidents, on-call, services, postmortems, teams, and people lookup. Requires Node.js 20+.

Stay in your editor — — acknowledge incidents, page responders, and write postmortems without switching to a browser
Let agents handle the routine — — AI agents can triage, escalate, and update incidents autonomously using scoped API keys
Zero infrastructure — — runs via npx, no server to deploy for local use

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
runframe_list_incidents	incidents:read
runframe_get_incident	incidents:read
runframe_create_incident	incidents:write
runframe_update_incident	incidents:write
runframe_change_incident_status	incidents:write
runframe_acknowledge_incident	incidents:write
runframe_add_incident_event	incidents:write
runframe_escalate_incident	incidents:write
runframe_page_someone	incidents:write
runframe_get_current_oncall	oncall:read
runframe_list_services	services:read
runframe_get_service	services:read
runframe_create_postmortem	postmortems:write
runframe_get_postmortem	postmortems:read
runframe_list_teams	teams:read
runframe_get_escalation_policy	oncall:read
runframe_find_user	users:read

How to install the Runframe MCP Server

{
  "mcpServers": {
    "runframe": {
      "command": "npx",
      "args": [
        "-y",
        "@runframe/mcp-server"
      ],
      "env": {
        "RUNFRAME_API_KEY": "YOUR_RUNFRAME_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
RUNFRAME_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Frequently asked questions

MCP server for Runframe incident management — any agent, any IDE, one system of record Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.