Right Reasons MCP Server

AI agents using Markdown + RAG score 0% recall on "why?" questions. The same agents using Right Reasons score 100%. Tested across 48 sessions with 2

Local serverstdioPython

What is the Right Reasons MCP Server?

AI agents using Markdown + RAG score 0% recall on "why?" questions. The same agents using Right Reasons score 100%. Tested across 48 sessions with 2 independent

What it needs from you

  • Docker and Docker Compose - Python 3.11+

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.

ToolWhat it does
list_objectsList objects filtered by layer, type, search, validation status
get_objectFull details of a single object
list_relationsList relations with assertion explanations
get_relation_assertionFull assertion history for a relation
traverse_graphNavigate the ontology graph — trace "why?" chains
get_schema_infoAll object types (14) and relation types (20)
get_authentication_trailAudit trail: who proposed, confirmed, validated
get_explanation_packetComplete context for an object in one call
query_sqlRead-only SQL for advanced queries
create_sessionStart an EPICAL intake session
propose_objectStage a candidate object (requires authentication before promotion)
propose_relationStage a candidate relation
promote_candidatePromote authenticated candidate to canonical
generate_ops_contractAuto-generate reasoning envelope from ontology for external work
get_ops_contractRetrieve contract with resolved references
list_ops_contractsList contracts by status or kind
dolt_statusWorking set status (like git status)
dolt_diffRow-level diffs between commits (like git diff)
dolt_commitCommit changes with message

How to install the Right Reasons MCP Server

{
  "mcpServers": {
    "right-reasons": {
      "command": "/path/to/mcp-server/.venv/bin/right-reasons-mcp",
      "env": {
        "RR_DOLT_HOST": "127.0.0.1",
        "RR_DOLT_PORT": "3307",
        "RR_DOLT_DATABASE": "right_reasons"
      }
    }
  }
}

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

Configuration

  • Docker and Docker Compose - Python 3.11+
VariableDescriptionRequired
RR_DOLT_HOSTDeclared in the maintainer’s client configuration.Check documentation
RR_DOLT_PORTDeclared in the maintainer’s client configuration.Check documentation
RR_DOLT_DATABASEDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Right Reasons to list objects.”
  • “Use Right Reasons to get object.”
  • “Use Right Reasons to list relations.”

Frequently asked questions

AI agents using Markdown + RAG score 0% recall on "why?" questions. The same agents using Right Reasons score 100%. Tested across 48 sessions with 2 independent Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.