RunAgents MCP Server

Model Context Protocol server for the RunAgents AI agent platform. Gives AI coding assistants (Claude Code, Cursor, Codex) direct access to deploy agents, manage tools, monitor runs, and handle approvals.

Install

pip install runagents-mcp

Configure

Claude Code

Add to your settings.json or project .mcp.json:

{
  "mcpServers": {
    "runagents": {
      "command": "runagents-mcp",
      "env": {
        "RUNAGENTS_ENDPOINT": "https://YOUR_WORKSPACE.try.runagents.io",
        "RUNAGENTS_API_KEY": "YOUR_API_KEY",
        "RUNAGENTS_NAMESPACE": "default"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "runagents": {
      "command": "runagents-mcp",
      "env": {
        "RUNAGENTS_ENDPOINT": "https://YOUR_WORKSPACE.try.runagents.io",
        "RUNAGENTS_API_KEY": "YOUR_API_KEY",
        "RUNAGENTS_NAMESPACE": "default"
      }
    }
  }
}

Configuration

The server reads configuration from environment variables, falling back to ~/.runagents/config.json (shared with the RunAgents CLI):

Tools

Documentation

• AI Assistant Setup — Full setup guide
• RunAgents Docs — Platform documentation
• CLI Reference — CLI commands