Skip to content

Add MCP support to Mithril - #267

Open
NeerajGodiyal wants to merge 21 commits into
Overclock-Validator:alpenglow-devfrom
NeerajGodiyal:feature/mcp
Open

Add MCP support to Mithril#267
NeerajGodiyal wants to merge 21 commits into
Overclock-Validator:alpenglow-devfrom
NeerajGodiyal:feature/mcp

Conversation

@NeerajGodiyal

@NeerajGodiyal NeerajGodiyal commented Aug 22, 2026

Copy link
Copy Markdown
Collaborator

Overview

This PR adds an MCP server to Mithril. It works with Codex, Claude Code, Cursor, VS Code, and other clients that support stdio MCP.

The server can read Mithril's RPC, metrics, logs, replay state, rewards, and host health. The default profile has 16 read-only tools. An optional diagnostic profile adds account inspection, transaction simulation, and profiling.

The default profile is read-only, and tool calls are bounded to protect node resources.

Connect a client

Codex:

mithril mcp setup codex

Claude Code:

mithril mcp setup claude

VS Code:

mithril mcp setup vscode

mithril mcp config prints the server command and arguments for Cursor and other stdio clients. The MCP guide also covers remote SSH, connection checks, and optional project instructions.

Checks run

  • Affected Go package tests
  • MCP race tests
  • go vet ./...
  • Staticcheck on the MCP packages
  • Govulncheck with no reachable vulnerabilities
  • Module tidy and checksum verification
  • Clean mithril binary build

Pull requests also run the MCP tests, affected integration tests, vet, Govulncheck, the Go build, and the Nix build in CI.

@NeerajGodiyal
NeerajGodiyal requested review from rupansh and smcio August 22, 2026 12:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant