@arelis-ai/mcp-server

MCP (Model Context Protocol) server for the Arelis Governance API. Exposes 40 tools and 5 resources that let AI assistants interact with audit events, governance policies, risk configuration, compliance proofs, replay verification, and more.

Quick Start

STDIO (default)

ARELIS_API_KEY=sk_live_... npx @arelis-ai/mcp-server

HTTP with Bearer auth

ARELIS_API_KEY=sk_live_... ARELIS_MCP_SECRET=my-secret \
  npx @arelis-ai/mcp-server --transport http --port 3100

Configuration

| Variable | Required | Default | Description | |---|---|---|---| | ARELIS_API_KEY | Yes | — | Arelis platform API key | | ARELIS_BASE_URL | No | https://api.arelis.digital | Arelis API base URL | | ARELIS_MCP_SECRET | No | — | Bearer token for HTTP transport auth | | DEBUG | No | false | Enable verbose logging |

Claude Desktop Setup

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "arelis-governance": {
      "command": "npx",
      "args": ["@arelis-ai/mcp-server"],
      "env": {
        "ARELIS_API_KEY": "sk_live_..."
      }
    }
  }
}

Tools (40)

Events (4)

| Tool | Description | |---|---| | arelis_events_create | Log an audit event | | arelis_events_list | List audit events with filters | | arelis_events_get | Get a single audit event by ID | | arelis_events_count | Count events matching filters |

AI Systems (5)

| Tool | Description | |---|---| | arelis_ai_systems_register | Register a new AI system | | arelis_ai_systems_list | List registered AI systems | | arelis_ai_systems_get | Get AI system details | | arelis_ai_systems_update | Update an AI system | | arelis_ai_systems_set_default | Set the default AI system |

Jobs (3)

| Tool | Description | |---|---| | arelis_jobs_list | List async jobs | | arelis_jobs_get | Get job status and result | | arelis_jobs_retry | Retry a failed job |

Governance (9)

| Tool | Description | |---|---| | arelis_governance_policies_create | Create a governance policy | | arelis_governance_policies_list | List governance policies | | arelis_governance_policies_get | Get policy details | | arelis_governance_policies_update | Update a policy | | arelis_governance_policies_create_version | Create a new policy version | | arelis_governance_policies_list_versions | List versions of a policy | | arelis_governance_policies_activate_version | Activate a specific version | | arelis_governance_policies_simulate | Simulate policy evaluation | | arelis_governance_evaluations_list | List policy evaluations |

Risk (6)

| Tool | Description | |---|---| | arelis_risk_config_get | Get current risk configuration | | arelis_risk_config_save_draft | Save a risk config draft | | arelis_risk_config_clear_draft | Discard the current draft | | arelis_risk_config_publish | Publish draft as active config | | arelis_risk_config_rollback | Rollback to a previous version | | arelis_risk_simulate | Simulate a risk assessment |

Proofs (3)

| Tool | Description | |---|---| | arelis_proofs_request | Request a compliance proof | | arelis_proofs_get | Get proof details | | arelis_proofs_verify | Verify a compliance proof |

Approvals (2)

| Tool | Description | |---|---| | arelis_approvals_list | List pending approvals | | arelis_approvals_resolve | Approve or reject an approval |

Replay (4)

| Tool | Description | |---|---| | arelis_replay_create | Create a replay verification | | arelis_replay_get | Get replay result | | arelis_replay_templates_list | List replay templates | | arelis_replay_templates_save | Save a replay template |

Exports (4)

| Tool | Description | |---|---| | arelis_exports_create | Create a data export | | arelis_exports_list | List exports | | arelis_exports_get | Get export details | | arelis_exports_download | Get export download URL |

Resources (5)

| URI | Description | |---|---| | arelis://governance/policies | Active governance policies | | arelis://risk/config | Current risk configuration | | arelis://context/environment | Environment information | | arelis://ai-systems/registry | Registered AI systems | | arelis://usage/quotas | Usage quotas and limits |

Development

# Install dependencies
pnpm install

# Build
pnpm --filter @arelis-ai/mcp-server build

# Run unit tests (155 tests)
pnpm --filter @arelis-ai/mcp-server test

# Run integration tests
pnpm --filter @arelis-ai/mcp-server test:integration

# Lint
pnpm --filter @arelis-ai/mcp-server lint

# Type check
pnpm --filter @arelis-ai/mcp-server type-check

Integration Tests

The integration test suite includes:

• In-process startup test: Uses InMemoryTransport to verify the server registers all 40 tools and 5 resources
• HTTP transport test: Spawns the server with --transport http and verifies auth rejection (401) and successful initialization
• API smoke tests: Skipped unless ARELIS_TEST_API_KEY is set; tests actual API calls through the MCP server

# Run with a live API key for full coverage
ARELIS_TEST_API_KEY=sk_test_... pnpm --filter @arelis-ai/mcp-server test:integration

Architecture

src/
  index.ts          # CLI entry point (STDIO/HTTP transport)
  server.ts         # McpServer creation and tool/resource registration
  client.ts         # Lazy singleton ArelisPlatform SDK client
  config.ts         # Environment variable configuration
  errors.ts         # Unified error formatting for MCP responses
  tools/            # 40 tools across 9 categories
  resources/        # 5 read-only resources
  integration/      # Integration test suite