@vorim/mcp-server

MCP server for AI agent identity, permissions, and audit trails.

Gives Claude, Cursor, VS Code, Windsurf, and any MCP-compatible client 17 tools to manage AI agent identities through Vorim — register agents, check permissions, emit audit events, verify trust scores, and delegate credentials.

vorim.ai — Create a free account and get your API key in 30 seconds. Documentation — Full API reference and guides.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vorim": {
      "command": "npx",
      "args": ["@vorim/mcp-server"],
      "env": {
        "VORIM_API_KEY": "agid_sk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add vorim -- npx @vorim/mcp-server

Set the API key in your environment:

export VORIM_API_KEY=agid_sk_live_...

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "vorim": {
      "command": "npx",
      "args": ["@vorim/mcp-server"],
      "env": {
        "VORIM_API_KEY": "agid_sk_live_..."
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "vorim": {
      "command": "npx",
      "args": ["@vorim/mcp-server"],
      "env": {
        "VORIM_API_KEY": "agid_sk_live_..."
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "vorim": {
      "command": "npx",
      "args": ["@vorim/mcp-server"],
      "env": {
        "VORIM_API_KEY": "agid_sk_live_..."
      }
    }
  }
}

Tools

The server exposes 17 tools across six categories:

Health

| Tool | Description | |------|-------------| | vorim_ping | Check API health and connectivity |

Agent Identity

| Tool | Description | |------|-------------| | vorim_register_agent | Register a new agent with an Ed25519 keypair | | vorim_get_agent | Get agent details by ID | | vorim_list_agents | List all agents (with pagination and status filter) | | vorim_update_agent | Update agent metadata | | vorim_revoke_agent | Permanently revoke an agent |

Permissions

| Tool | Description | |------|-------------| | vorim_check_permission | Check if an agent has a permission (sub-5ms via Redis) | | vorim_grant_permission | Grant a scoped permission with optional expiry and rate limits | | vorim_list_permissions | List all active permissions for an agent | | vorim_revoke_permission | Revoke a permission from an agent |

Audit

| Tool | Description | |------|-------------| | vorim_emit_event | Log a tamper-evident audit event | | vorim_export_audit | Export a signed audit bundle (SHA-256 manifest) |

Trust

| Tool | Description | |------|-------------| | vorim_verify_trust | Verify an agent's identity and trust score (0-100) |

Credential Delegation

| Tool | Description | |------|-------------| | vorim_register_ephemeral | Register a short-lived agent with did:key identity | | vorim_delegate_credential | Delegate a scoped credential to an agent | | vorim_request_token | Request a short-lived access token | | vorim_list_delegations | List credential delegations |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | VORIM_API_KEY | Your Vorim API key (agid_sk_...) | Required | | VORIM_BASE_URL | API base URL | https://api.vorim.ai |

Example Prompts

Once the MCP server is connected, you can ask your AI assistant:

• "Register a new agent called invoice-processor with read and execute permissions"
• "Check if agent agid_acme_a1b2c3d4 has agent:execute permission"
• "Show me the trust score for agent agid_acme_a1b2c3d4"
• "List all active agents"
• "Emit an audit event for agent agid_acme_a1b2c3d4 performing search_documents"
• "Export audit logs from the last 7 days"
• "Grant agent:transact permission to agid_acme_a1b2c3d4 with a rate limit of 100 per hour"
• "Create an ephemeral agent with a 1-hour TTL for a one-off task"

Running Standalone

VORIM_API_KEY=agid_sk_live_... npx @vorim/mcp-server

Or install globally:

npm install -g @vorim/mcp-server
VORIM_API_KEY=agid_sk_live_... vorim-mcp-server

Related

• @vorim/sdk — TypeScript SDK
• vorim (PyPI) — Python SDK
• @vorim/cli — CLI tool
• vorim.ai/docs — Documentation

License

MIT