Renyi — Claude Code MCP server: what it does, how to install
Gives coding agents a toolchain to write, verify, and run Renyi scripts with explicit permission bounds. Ideal when agent-generated code needs instant auditability.
Apache-2.0 ★ 3 updated 2026-10-17
Open on GitHubWhat Renyi does
Renyi is a scripting language tailored for AI-driven automation. Through its MCP interface (renyi mcp), it equips agents in Claude Code, Codex, and Cursor with code verification, formatting, test running, and workspace indexing. Source files use the .renyi or .ry extension.
Instead of wrapping scripts in opaque process sandboxes, Renyi defines permissions inside function signatures. A function explicitly declares the required filesystem paths or network hosts. Third-party packages cannot secretly expand these permissions because the engine calculates their requirements directly from source code.
Without declaring a required resource in the signature, the code will fail at compile time. Every run produces a verifiable record containing code hashes, dependencies, and arguments, making offline replay simple.
What it helps with
- restrict agent execution to explicitly declared paths and hosts
- validate effect signatures in
.renyiscripts prior to runtime - produce semantic code diffs and chunks for agent retrieval
- replay past script runs offline using deterministic execution logs
Example prompts for the agent
- Check the effect declarations and run tests on
data_pipeline.renyi - Generate a project map and semantic diff using the Renyi toolchain
- Run
fetch_users.ryand explain the execution record
How to install Renyi
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Renyi
How do I install Renyi for Claude Code?
On Linux and macOS, download the binary with curl -fsSL https://raw.githubusercontent.com/renyi-lang/renyi/main/install.sh | sh. Once installed, configure your agent to run the MCP server via renyi mcp.
What does the Renyi MCP server do?
It connects the Renyi toolchain directly to your assistant. The agent can check syntax, run test suites, format code, and inspect the project index with semantic diffs.
How does effect checking in Renyi work?
Functions declare all filesystem paths, network calls, and operational budgets in their signature. The compiler halts execution if code or its external packages touch undeclared resources.