# runx

> runx is an open-source MCP server for governance tooling. Governed runtime for agent skills: search and inspect before you run. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Self-hosted
- **Website:** https://runx.ai
- **Repository:** https://github.com/runxhq/runx
- **MCP Registry name:** ai.runx/runx
- **Categories:** [governance tooling](https://ai-powered.com/categories/governance-tooling), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-21

## About

runx treats a skill as a portable SKILL.md file: an operating manual with the method, the evidence to look for and the tools a job needs. Skills can call other skills, so a product launch or a market study can unfold as a chain of steps.

The runtime admits each call under explicit authority, hands credentials over only at the tool boundary and seals a signed receipt of what happened. Your own agent supplies the judgment while runx owns the execution boundary.

Through this MCP server an agent can search the skill catalogue and inspect a skill before running it. The runtime is written in Rust under Apache-2.0, with execution and receipt signing running locally and hosted registry services optional.

## Features

- **Skills as files:** Each skill is a SKILL.md describing method, evidence, decisions and required tools.
- **Catalogue search:** Agents search the skill catalogue and inspect a skill before executing it.
- **Narrowing authority:** Calls are admitted under explicit authority that narrows rather than passes through.
- **Signed receipts:** Every act produces a verifiable record sealed by the runtime.
- **Credentials at the boundary:** Secrets are delivered at the tool boundary, not handed to the agent.
- **Local execution:** Execution, state and receipt signing run on your machine; hosted services are optional.

## Good for

- Run a product launch across docs, release notes and customer updates
- Investigate organic traffic with Search Console and analytics skills
- Audit what an agent did with signed receipts
- Share reusable expert procedures between agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http runx https://api.runx.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.runx.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "runx": {
      "url": "https://api.runx.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "runx": {
      "type": "http",
      "url": "https://api.runx.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "runx": {
      "serverUrl": "https://api.runx.ai/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.runx.ai/mcp
```

Enter a Name (for example "runx"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "runx": {
      "type": "http",
      "url": "https://api.runx.ai/mcp"
    }
  }
}
```

## FAQ

### Is runx open source?

Yes, the Rust runtime is licensed under Apache-2.0.

### Does runx run locally?

Execution, state and receipt signing run locally; the hosted registry, credential custody and notary services are optional.

### How can I use runx?

Through the CLI, MCP or a language client alongside the agent or framework you already use.

### Is runx free?

Yes. runx is open source, so you can use and self-host it for free.

### How do I add runx to Claude Code?

Run this command in your terminal: claude mcp add --transport http runx https://api.runx.ai/mcp

### What are the best alternatives to runx?

The closest alternatives to runx are Rokha, SkillGild and LoopSkill.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Rokha](https://ai-powered.com/mcp/rokha): Rokha is a freemium MCP server for ai models and llm tooling.
- [SkillGild](https://ai-powered.com/mcp/skillgild): SkillGild is a freemium MCP server for ai models and llm tooling.
- [LoopSkill](https://ai-powered.com/mcp/loopskill): LoopSkill is a freemium MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/runx
