Skip to main content

RCA-MCP MCP connector — causal root-cause analysis, 55 tools, works with Claude, Ollama, Groq, OpenAI, Gemini, LangChain and more.

Project description

RCA-MCP Connector

Python License PulseMCP

⚠️ Early access. RCA-MCP's backend is live and this connector has been verified end-to-end against it. The api.rca-mcp.com custom domain isn't wired up yet — point RCA_MCP_API_URL at the current backend URL below. Tool schemas and documentation may still change before the first stable public launch.

What is RCA-MCP?

The only MCP server purpose-built for causal Root Cause Analysis. 55 tools covering causal graph construction, 13 RCA model families (including Salesforce PyRCA algorithms), multi-model consensus, and PDF/HTML/Excel/Markdown report generation. Works with Claude, Ollama, Groq, OpenAI, Gemini, LangChain — 9 providers.


Quick Start (2 minutes)

git clone https://github.com/dave1362/rca-mcp-connector.git
cd rca-mcp-connector
pip install -r requirements.txt
cp .env.example .env
# Edit .env: set RCA_MCP_API_KEY to a key created via the dashboard below

Get an API key at rca-mcp.pages.dev — a free tier is available, no credit card required.


Claude Code Setup

Add to .mcp.json in your workspace root:

{
  "mcpServers": {
    "rca-mcp": {
      "command": "python",
      "args": ["/absolute/path/to/rca-mcp-connector/connector/server.py"],
      "env": {
        "RCA_MCP_API_URL": "https://rcamcp-production.up.railway.app",
        "RCA_MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Ollama Setup

go install github.com/mark3labs/mcphost@latest
mcphost -m ollama:qwen3:14b --config providers/mcp-servers.json

OpenAI Agents SDK

from agents import Agent, MCPServerStdio
import asyncio

async def main():
    async with MCPServerStdio(
        params={
            "command": "python",
            "args": ["connector/server.py"],
            "env": {"RCA_MCP_API_KEY": "your_key"},
        }
    ) as rca_server:
        agent = Agent(name="RCA Agent", model="gpt-4o", mcp_servers=[rca_server])
        result = await agent.run("Find the root cause of the API latency spike.")
        print(result.final_output)

asyncio.run(main())

LangChain

from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain_anthropic import ChatAnthropic
from langgraph.prebuilt import create_react_agent
import asyncio

async def main():
    async with MultiServerMCPClient({
        "rca-mcp": {
            "command": "python", "args": ["connector/server.py"],
            "env": {"RCA_MCP_API_KEY": "your_key"}, "transport": "stdio",
        }
    }) as client:
        tools = await client.get_tools()
        agent = create_react_agent(ChatAnthropic(model="claude-sonnet-4-6"), tools)
        result = await agent.ainvoke({"messages": [{"role": "user", "content": "Run an FMEA analysis"}]})
        print(result["messages"][-1].content)

asyncio.run(main())

See providers/ for ready-to-use config templates and full examples (Groq, Gemini, OpenRouter, Claude Desktop).


Third-Party Licences

PyRCA (Salesforce): BSD-3-Clause Copyright (c) 2022, salesforce.com, inc. https://github.com/salesforce/PyRCA

Algorithms in rca_pyrca_* tools are independently-written adaptations of PyRCA's published methods (Zheng et al. 2023, arXiv:2306.11417), not direct copies of PyRCA source code, per the private API's models/pyrca_adapter.py.


Citing RCA-MCP

@software{rcamcp2026,
  title  = {RCA-MCP: An MCP Server for Causal Root Cause Analysis},
  author = {davetj},
  year   = {2026},
  url    = {https://github.com/dave1362/rca-mcp-connector},
  note   = {v4.1.9}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rca_mcp_connector-4.1.9.tar.gz (21.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rca_mcp_connector-4.1.9-py3-none-any.whl (22.2 kB view details)

Uploaded Python 3

File details

Details for the file rca_mcp_connector-4.1.9.tar.gz.

File metadata

  • Download URL: rca_mcp_connector-4.1.9.tar.gz
  • Upload date:
  • Size: 21.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for rca_mcp_connector-4.1.9.tar.gz
Algorithm Hash digest
SHA256 01aab710220b3969cd48744ec00e4d4cb43f4f98dceb5755e4f984954050da2c
MD5 663baf0173a836e56c1e016d99340988
BLAKE2b-256 c62683190e52eda8001f7ee1799ddcc9e722652b529f5aa9336284ed80c88dea

See more details on using hashes here.

File details

Details for the file rca_mcp_connector-4.1.9-py3-none-any.whl.

File metadata

File hashes

Hashes for rca_mcp_connector-4.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 c53925ac1a401240453129dcaabbe556d775219d1633d00d933b8c407df6ccbe
MD5 f8b1386a09bf519c5a8230f46ac871c3
BLAKE2b-256 4c611463484beeec2489aa10e14cd18775e2e195a30b16250eaeacabd47a7d6f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page