@agentreserve/mcp-tools

Standalone MCP server for AgentReserve — lets any MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.) execute, cancel, modify, and query actions through the AgentReserve API.

Tools

| Tool | Description | |------|-------------| | execute_action | Execute an action through a governed tool | | cancel_action | Cancel an existing action | | modify_action | Modify an existing action's parameters | | get_action | Get full action details with audit trail | | list_actions | List actions with optional filters | | list_connector_templates | List available connector templates (developer-facing) | | list_tools | Discover available governed tools for the organization | | get_tool_schema | Get parameter schema for a specific tool |

Prerequisites

• Node.js 18+
• An AgentReserve API key (get one from your dashboard)

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentreserve": {
      "command": "npx",
      "args": ["-y", "@agentreserve/mcp-tools"],
      "env": {
        "AGENTRESERVE_API_KEY": "your-api-key-here",
        "AGENTRESERVE_BASE_URL": "https://agentreserve.com"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "agentreserve": {
      "command": "npx",
      "args": ["-y", "@agentreserve/mcp-tools"],
      "env": {
        "AGENTRESERVE_API_KEY": "your-api-key-here",
        "AGENTRESERVE_BASE_URL": "https://agentreserve.com"
      }
    }
  }
}

Windsurf

Add to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agentreserve": {
      "command": "npx",
      "args": ["-y", "@agentreserve/mcp-tools"],
      "env": {
        "AGENTRESERVE_API_KEY": "your-api-key-here",
        "AGENTRESERVE_BASE_URL": "https://agentreserve.com"
      }
    }
  }
}

Claude Code

claude mcp add agentreserve -- npx -y @agentreserve/mcp-tools

Set the environment variables AGENTRESERVE_API_KEY and AGENTRESERVE_BASE_URL before launching.

Any MCP Client

The server uses stdio transport. Run:

AGENTRESERVE_API_KEY=your-key npx @agentreserve/mcp-tools

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AGENTRESERVE_API_KEY | Yes | — | Your AgentReserve API key | | AGENTRESERVE_BASE_URL | No | https://agentreserve.com | API base URL (override for self-hosted) |

How It Works

This package is a thin MCP-to-HTTP bridge. It does not contain any business logic — every tool call is forwarded to the hosted AgentReserve API at /api/v1/mcp. Authentication, policy enforcement, audit logging, and all action logic are handled server-side.

MCP Client → stdio → @agentreserve/mcp-tools → HTTPS → AgentReserve API

License

MIT