Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@vorim/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@vorim/mcp-server
MCP server for AI agent identity, permissions, and audit trails.
Gives Claude, Cursor, VS Code, Windsurf, and any MCP-compatible client 13 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-serverSet 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 13 tools across five 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-serverOr install globally:
npm install -g @vorim/mcp-server
VORIM_API_KEY=agid_sk_live_... vorim-mcp-serverRelated
- @vorim/sdk — TypeScript SDK
- vorim (PyPI) — Python SDK
- @vorim/cli — CLI tool
- vorim.ai/docs — Documentation
License
MIT