OpsLevel MCP Server

1<p align="center">
2    <a href="https://github.com/OpsLevel/opslevel-mcp/blob/main/LICENSE">
3        <img src="https://img.shields.io/github/license/OpsLevel/opslevel-mcp.svg" alt="License" /></a>
4    <a href="https://GitHub.com/OpsLevel/opslevel-mcp/releases/">
5        <img src="https://img.shields.io/github/v/release/OpsLevel/opslevel-mcp" alt="Release" /></a>
6    <a href="https://masterminds.github.io/stability/active.html">
7        <img src="https://masterminds.github.io/stability/active.svg" alt="Stability: Active" /></a>
8    <a href="https://github.com/OpsLevel/opslevel-mcp/graphs/contributors">
9        <img src="https://img.shields.io/github/contributors/OpsLevel/opslevel-mcp" alt="Contributors" /></a>
10    <a href="https://github.com/OpsLevel/opslevel-mcp/pulse">
11        <img src="https://img.shields.io/github/commit-activity/m/OpsLevel/opslevel-mcp" alt="Activity" /></a>
12    <a href="https://github.com/OpsLevel/opslevel-mcp/releases">
13        <img src="https://img.shields.io/github/downloads/OpsLevel/opslevel-mcp/total" alt="Downloads" /></a>
14    <a href="https://app.opslevel.com/services/opslevel_mcp/maturity-report">
15        <img src="https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fapp.opslevel.com%2Fapi%2Fservice_level%2Fdlmj6PlFjehv6iLE6IQtEGXi_uz3LF9rA5nxb35wiY8" alt="Overall" /></a>
16 
17[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/opslevel/opslevel-mcp)](https://archestra.ai/mcp-catalog/opslevel__opslevel-mcp)
18</p>
19 
20<p align="center">
21  <a href="https://glama.ai/mcp/servers/@OpsLevel/opslevel-mcp">
22    <img width="380" height="200" src="https://glama.ai/mcp/servers/@OpsLevel/opslevel-mcp/badge" />
23  </a>
24</p>
25 
26 
27# OpsLevel MCP Server
28 
29This MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)) server provides AIs with tools to interact with your OpsLevel account.
30 
31![mcp_image](https://github.com/user-attachments/assets/dd936eef-80c2-42a5-8d04-9ca9c2de8e76)
32 
33# Features
34 
35Currently, the MCP server only uses read-only access to your OpsLevel account and can read data from the following resources:
36 
37- Actions
38- Campaigns
39- Checks
40- Components
41- Component Dependencies (components that a component depends on)
42- Component Dependents (components that depend on a component)
43- Documentation (API & Tech Docs)
44- Domains
45- Filters
46- Infrastructure
47- Repositories
48- Systems
49- Teams
50- Users
51 
52# Setup
53 
541. Install the MCP Server
55   1. Homebrew - `brew install opslevel/tap/opslevel-mcp`
56   2. Docker - `docker pull public.ecr.aws/opslevel/mcp:latest`  
57      You can also used a pinned version [check out the gallery for the available tags](https://gallery.ecr.aws/opslevel/mcp) 
58   3. Manual - Visit our [GitHub releases page](https://github.com/OpsLevel/opslevel-mcp/releases) and download the binary for your operating system.
592. You will need an [API Token](https://app.opslevel.com/api_tokens) to authorize the MCP Server to talk to your account via an environment variable.
603. Setup MCP configuration for the AI tool of your choice.
61 
62## Claude
63 
64[Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
65 
661. Edit the file at the specified path based on the Claude Desktop docs
67   1. Mac OS - `${HOME}/Library/Application\ Support/Claude/claude_desktop_config.json`
68   2. Windows - `%APPDATA%\Claude\claude_desktop_config.json`
692. Start (or restart) Claude Desktop
70 
71```json
72{
73    "mcpServers": {
74        "opslevel": {
75            "command": "opslevel-mcp",
76            "env": {
77                "OPSLEVEL_API_TOKEN": "XXXXXXX"
78            }
79        }
80    }
81}
82```
83 
84## VS Code
85 
86[VS Code User Settings](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_finding-mcp-servers)
87 
881. Open the Settings menu (Command + Comma) and select the correct tab atop the page for your use case
89   1. Workspace - configures the server in the context of your workspace
90   2. User - configures the server in the context of your user
912. Select Features → Chat
923. Ensure that "Mcp" is Enabled
93   1. You may need to have your Github administrator enable "preview" features in the CoPilot settings for the organization.
944. Click "Edit in settings.json" under "Mcp > Discovery" to have the below config
95   1. Can also edit the file directly
96      1. (Mac OS)  `${HOME}/Library/Application\\ Support/Code/User/settings.json`
975. Start (or restart) VS Code
98 
99```json
100{
101    "chat.agent.enabled": true,
102    "chat.mcp.discovery.enabled": true,
103    "mcp": {
104        "inputs": [
105          {
106            "type": "promptString",
107            "id": "opslevel_token",
108            "description": "OpsLevel API Token",
109            "password": true
110          }
111        ],
112        "servers": {
113            "opslevel": {
114                "type": "stdio",
115                "command": "opslevel-mcp",
116                "env": {
117                    "OPSLEVEL_API_TOKEN": "${input:opslevel_token}"
118                }
119            }
120        }
121    }
122}
123```
124 
125## Cursor
126 
127[Cursor Docs](https://docs.cursor.com/context/model-context-protocol)
128 
129[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.png)](cursor://anysphere.cursor-deeplink/mcp/install?name=opslevel&config=eyJjb21tYW5kIjoib3BzbGV2ZWwtbWNwIiwiZW52Ijp7Ik9QU0xFVkVMX0FQSV9UT0tFTiI6IlhYWFhYWCJ9fQ==)
130 
1311. Open the Cursor menu and select Settings → Cursor Settings → MCP
1322. Click "Add new global MCP server"
1333. Add the config below
134 
135```json
136{
137  "mcpServers": {
138    "opslevel": {
139      "command": "opslevel-mcp",  
140      "env": {
141        "OPSLEVEL_API_TOKEN": "XXXXXX"
142      }
143    }
144  }
145}
146```
147 
148## Warp
149 
150[Warp](https://www.warp.dev/)
151 
1521. Access your MCP settings under Settings > AI > Manage MCP Servers. Warp provides [instructions for other ways to access this list.](https://docs.warp.dev/knowledge-and-collaboration/mcp#how-to-access-mcp-server-settings)
1532. Press the add button
1543. Add the config below
155 
156```json
157{
158  "opslevel": {
159    "command": "opslevel-mcp",
160    "args": [],
161    "env": {
162      "OPSLEVEL_API_TOKEN": "XXXXXX"
163    },
164    "start_on_launch": true
165  }
166}
167```
168 
169## Windsurf
170 
171[Windsurf](https://windsurf.com/editor)
172 
1731. Navigate to Windsurf - Settings > Advanced Settings
1742. Scroll down to the Cascade section and you will find the option to add a new server
1753. Edit the [mpc_config.json](https://docs.windsurf.com/windsurf/mcp#mcp-config-json) with the below configuration
1764. Restart Windsurf
177 
178```json
179{
180  "mcpServers": {
181    "opslevel": {
182      "command": "opslevel-mcp",  
183      "env": {
184        "OPSLEVEL_API_TOKEN": "XXXXXX"
185      }
186    }
187  }
188}
189```
190 
191### Docker
192 
193If you didn't install the binary directly and instead pulled the docker image you'll need to adjust the above MCP configurations to support running the server via docker
194 
195```
196        "command": "docker",
197        "args": [
198          "run",
199          "-i",
200          "--rm",
201          "-e",
202          "OPSLEVEL_API_TOKEN",
203          "public.ecr.aws/opslevel/mcp:latest"
204        ],
205```
206