MCP Server

The MCP server puts the data your catalog already has in the assistant you already work in.

This MCP (Model Context Protocol) server provides AIs with tools to interact with your OpsLevel account.

Your catalog already knows who owns every service, how they connect, and what "good" looks like. The MCP server puts that data in the assistant you already work in. You ask in your own words, in your own tool, and get a complete answer. The pairing matters more than the connection. OpsLevel holds the authoritative graph and your LLM does the joining, filtering, and formatting on top of it.

🤖

The OpsLevel MCP server is available for AI systems to connect with at https://app.opslevel.com/mcp

Architecture

OpsLevel makes it easy to give your LLM tool of choice access to your production architecture, relationships, docs, and more!

OpsLevel makes it easy to give your LLM tool of choice access to your production software architecture, relationships, docs, and more!

Features

Currently the MCP server only uses read-only access to your OpsLevel account and can read data from the following resources:

  • Actions
  • Checks
  • Components
  • Documentation (API & Tech Docs)
  • Domains
  • Filters
  • Infrastructure
  • Repositories
  • Systems
  • Teams
  • Users

Setup

Instructions for configuring your AI system to use this MCP server can be found below.

Claude Code (CLI)

Official Guide: Connect to MCP servers

  1. Run claude mcp add --transport http opslevel https://app.opslevel.com/mcp to add the OpsLevel MCP server to Claude code.

  2. Run claude mcp login opslevel to authenticate using your browser

    Example of the Authorize Access Prompt


Claude on the Web / Claude Desktop

📘

Opslevel MCP is now available on Claude connectors directory https://claude.ai/directory/connectors/opslevel

Using a custom connector

​The Anthropic documentation covers how to add the Opslevel MCP server as a custom connector for users on Team, Enterpise, Pro and Max plans. Here are the steps.

    1. Open Settings → Connectors → Add custom connector.
    1. Name it OpsLevel
    2. Enter the URL https://app.opslevel.com/mcp.
    3. Click Connect and authorize in the browser.

Get started with custom connectors using remote MCP

Claude Desktop via mcp-remote

If custom connectors are unavailable on your plan, add the following to claude_desktop_config.json:

  1. Open the claude_desktop_config.json file available at
    1. Mac OS - $HOME/Library/Application\ Support/Claude/claude_desktop_config.json
    2. Windows - %APPDATA%\Claude\claude_desktop_config.json
  2. Find the mcpServers block and add:
"opslevel": {
  "command": "npx",
  "args": [
    "mcp-remote",
    "https://app.opslevel.com/mcp"
  ]
}
  1. Restart Claude Desktop
  2. Follow the prompts to authenticate the MCP server with OpsLevel in the browser window that opens

Visual Studio Code

📘

Opslevel MCP is available on the Github MCP Registry and can be installed in VS code with a click
https://github.com/mcp/com.opslevel/mcp

Official Guide: Add and manage MCP servers in VS Code

Using the command palette:

  1. Open the Command Palatte and run MCP: Add Server.
  2. Choose HTTP (HTTP or Server Sent Events)
  3. Enter https://app.opslevel.com/mcp as the URL of the server
  4. Enter opslevel as the Server ID
  5. Follow the prompts to authenticate the MCP server with OpsLevel

Or run:

code --add-mcp "{\"name\":\"opsleve2\",\"type\": \"http\",\"url\": \"https://app.opslevel.com/mcp\"}"
⚠️

Known issue in VS Code

Some VS Code configurations call every available tool on every prompt, which
makes responses slow and lower quality.

Cursor

Official Guide: Model Context Protocol

Click the button below:

Add opslevel MCP server to Cursor

Or to manually add it:

  1. Open the Cursor menu and select Settings → Tools & MCP
  2. Under "Home MCP Servers", Click "New MCP server"
  3. Add the config below
{
  "mcpServers": {
    "opslevel": {
      "type": "http",
      "url": "https://app.opslevel.com/mcp"
    }
  }
}
  1. Click the Connect button to launch the authentication flow
  2. Click Authorize to grant Cursor access to the OpsLevel MCP server

Example of the Authorize Access Prompt

Other Tools

To use the server with other tools, enter the following information

URL: https://app.opslevel.com/mcp

Type: HTTP or Streamable HTTP

Or in the conventional MCP format:

{
  "mcpServers": {
    "opslevel": {
      "type": "http",
      "url": "
    }
  }
}

Prompts

After you have your AI tool hooked up to OpsLevel's MCP you can now ask natural language questions about the information in your software catalog. Here are some example prompts to get the ideas flowing.

  • What is the main contact method for each team? Please format it as a csv.
  • Can you build me a tree output of all the teams and their parents?
  • Can you give me just the e-mail of users who's role is "standards admin"
  • If I have a javascript service which filter should I use for my checks?
  • Can you give me just the name of the actions in my account that require form input?
  • What team is {Co-Worker Name} on?
  • What is the mission of the team "{Team Name}"?
  • What team is the owner of the component {Name}?
  • What checks do I need to pass to achieve Gold in "Security"?

Legacy stdio server

The original OpsLevel MCP server is available for download at OpsLevel/opslevel-mcp. It uses stdio for the transport instead of HTTP and authenticates with an API token instead of OAuth.





Did this page help you?