runx — Claude Code MCP server: use skills
runx lets an agent find, inspect, and run skills through an MCP connection, while recording a verifiable receipt for each execution.
claude mcp add --transport http runx https://api.runx.ai/mcpWhat runx does
runx gives an agent a controlled way to execute skills from a local directory, a URL, or a catalog. The agent can discover a skill, inspect what it needs, connect selected tools, and pass its result into the next step. Each run keeps state and produces a receipt that the CLI can verify.
The MCP server works with Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed. Execution, state, and receipt signing happen locally; a hosted registry, credential storage, and notary services are separate options. The repository example requires Git and Node.js 20 or newer. It does not require a Runx account, model, or provider key.
For Claude Code, add the server with one command. After cloning the repository, the local example runs with runx skill ./examples/hello-world --run-id first-run -i message="Hello, Runx." --json. You can inspect it with runx history first-run --json and verify the returned receipt using runx verify <receipt-id> --json.
What it helps with
- inspect a skill before execution
- pass one skill’s result into the next step
- limit a run to selected tools
- verify the receipt produced by a run
Example prompts for the agent
- Connect runx and find a skill that can examine where users leave our funnel.
- Run the skill in
./examples/hello-worldwith run IDfirst-runand the message “Hello, Runx.”. - Read the history for
first-run, then verify its receipt.
How to install runx
Platform CLI: remote server
claude mcp add --transport http runx https://api.runx.ai/mcpPlatform CLI: remote server
codex mcp add runx --url https://api.runx.ai/mcpConfig file
{
"mcpServers": {
"runx": {
"url": "https://api.runx.ai/mcp"
}
}
}Config file
{
"servers": {
"runx": {
"type": "http",
"url": "https://api.runx.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http runx https://api.runx.ai/mcpStep 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 runx
How do I install runx in Claude Code?
Run claude mcp add --transport http runx https://api.runx.ai/mcp.
What does the runx MCP server do?
It lets an agent discover and inspect skills, run them with chosen tools, and pass outputs to later steps. Each execution gets a receipt that can be verified.
What is required for the local runx example?
The example needs Git and Node.js 20 or newer. A Runx account, model, and provider key are not required for it.
