Relia MCP server

Production, in your AI assistant.

Connect Claude Code, Cursor or VS Code to Relia once. Then ask “what broke in production?” from your editor: your assistant reads Relia's incidents, evidence and fix plans, and makes the change where you code. It can only read, and it's included in every plan.

What MCP is

MCP (Model Context Protocol) is the open standard AI assistants use to call tools from other services.

Without it, you open Relia, read the incident, copy the fix plan and paste it into your assistant. With Relia's MCP server, your assistant does that itself: you ask a question in plain words, the assistant decides which Relia tool to call, Relia answers from your project's data, and the assistant uses the answer to explain the problem or edit your code.

  1. You ask your assistant

    “Use Relia: what's broken in production?”

  2. It calls Relia

    relia_status, then relia_get_fix_plan for the incident it found. Relia checks your token and your access to the project on every call.

  3. It fixes it where you code

    “Checkout orders fail since 10:02 for 38 shoppers: service.pyline 88 reads a missing field. Here's the change.” After you deploy, Relia checks live traffic and tells you whether the fix worked.

What your assistant can do

Seven tools, all read-only. Your assistant picks the right one from your question.

What needs attention right now

relia_status

Relia's verdict for your product, one line per part (users, APIs, database, servers, uptime, page speed, AI agents) and the incidents that need a fix.

Free

List incidents

relia_list_incidents

Open or resolved problems, most important first, with how many users each one hit and whether a fix is being checked.

Free

Incident details

relia_get_incident

What happened in plain words, the impact, what to do next, how it unfolded, the evidence per layer with example request traces, and the deploys around it.

Free

How to fix it

relia_get_fix_plan

Concrete steps written from the evidence: the root cause, the file and line, the change, and how to confirm it worked.

Uses your plan's monthly fix plans the first time, then cached

Ask Relia

relia_ask

Any question about your product's live data, answered with its sources: "Is checkout working?", "Which API is slowest today?"

Uses your plan's monthly Ask Relia questions

Set up Relia in this repository

relia_setup

This project's exact setup steps for the code in your editor: which files to add, what to load first, source maps, and where to name signed-in users.

Free

Check what Relia receives

relia_check_setup

What has arrived so far (requests per service, visits, source maps, signed-in users, AI runs) and the one step left for anything missing.

Free

1. Create a token

One token per project. It acts as you, can only read, and is shown once.

  1. Open your project in Relia

    Settings, then Advanced, then Integrations. The card Use Relia in your AI assistant is at the top. You can also get there from the Ask Relia page or from any fix plan.

  2. Name it and press Create a token

    For example “Cursor on my laptop”. Relia shows the exact setup line for your tool with the token filled in. Copy it now: it is never shown again.

2. Add it to Claude Code

Run this once in your terminal, inside the project's folder. It stays private to you and to that folder. Don't add --scope project: that writes the token into a file you commit.

Terminal
claude mcp add --transport http relia https://devreliaapi.tryrelia.com/mcp --header "Authorization: Bearer relia_mcp_…"

2. Or add it to Cursor

Put this in .cursor/mcp.json inside the project's folder, and add that file to .gitignore (it holds the token). Not the global ~/.cursor/mcp.json: a token is for one Relia project.

.cursor/mcp.json
{
  "mcpServers": {
    "relia": {
      "url": "https://devreliaapi.tryrelia.com/mcp",
      "headers": {
        "Authorization": "Bearer relia_mcp_…"
      }
    }
  }
}

2. Or add it to VS Code

Put this in .vscode/mcp.json inside the project's folder. VS Code asks for the token once and keeps it out of the file, so the file is safe to commit.

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "relia-token",
      "description": "Relia token",
      "password": true
    }
  ],
  "servers": {
    "relia": {
      "type": "http",
      "url": "https://devreliaapi.tryrelia.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:relia-token}"
      }
    }
  }
}

2. Or any other client

Windsurf, Zed, your own agent: anything that supports a remote MCP server with a header.

Connection
URL:        https://devreliaapi.tryrelia.com/mcp
Header:     Authorization: Bearer relia_mcp_…
Transport:  Streamable HTTP

Set up Relia from your editor

Haven't installed Relia in this repository yet? Your assistant can do it: say “Set up Relia”.

  1. It asks you two questions first

    Record screen replays? (Relia's agent doesn't need them; recommended no.) Tell Relia who your users are? (Incidents then name customers and plans; recommended yes.)

  2. It shows every change before writing it

    Relia's relia_setupgives it this project's exact steps for your stack (Node, Next.js, web apps, Python). With yes to users, it finds your sign-in code and adds the lines there. Nothing is committed.

  3. It checks the result

    Start your app and use it once; relia_check_setup says what arrived and what is left. In Claude Code it is also a ready-made prompt: /mcp__relia__setup.

Things to ask

Start with “Use Relia” so your assistant knows where to look.

  • “Set up Relia.”
  • “Use Relia: what needs my attention in production?”
  • “What broke in checkout today, and how do I fix it?”
  • “Get Relia's fix plan for that incident and apply it.”
  • “Is the orders API still failing after my deploy?”
  • “Which API is slowest today, and why?”

Safety and limits

  • Read-only. No tool can change anything in Relia or on your servers. Your assistant edits your code only in your editor, with your approval.
  • One project per token. Another project's incidents are “not found”, even when you can see them in Relia.
  • It acts as you. Lose access to the project and the token stops working. Viewers can't create tokens.
  • Stored safely. Relia keeps only a hash of the token. Revoke it any time from the same card; it also expires after 90 days without use.
  • Every read is logged. Each tool call is an entry in your project's audit log: who, which tool, when.
  • Fair use. 300 calls an hour per token. Fix plans and Ask Relia count against your plan's monthly allowance, like in the app.

Questions

What is the Relia MCP server?

A remote MCP (Model Context Protocol) server built into Relia. AI coding assistants such as Claude Code, Cursor and VS Code connect to it and can read your project's status, incidents, evidence and fix plans, and ask Relia questions about your product's live data.

Which AI tools work with it?

Claude Code, Cursor and VS Code, with the exact setup shown in Relia, and any other MCP client that supports a remote server over HTTP with an Authorization header.

Can my assistant change anything through it?

Not in Relia or on your servers: every tool only reads. Your assistant edits code in your own editor, as it always does, and shows you the change first. When it sets Relia up for you, that is also an edit in your editor that you approve.

Does it cost extra?

No. It is included in every plan, Free too. Fix plans and Ask Relia answers fetched through it count against your plan's monthly allowance, exactly as in the app.

Do I need to install anything?

No package. It is a remote server: create a token in Relia and add one line or one small config file to your tool.

Where does the data go?

Relia answers your assistant over HTTPS. What your assistant reads is then sent to the model your tool uses (for example Anthropic for Claude Code), like any other context you give it. Relia never includes the identities of your users in these answers.

Relia's SDKs are open on npm (relia-sdk) and PyPI (relia-sdk). New to Relia? Set it up in five minutes.