{"_id":"@arelis-ai/mcp-server","_rev":"3-af6eadd448dd4e223152a537aff32522","name":"@arelis-ai/mcp-server","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@arelis-ai/mcp-server","version":"0.1.0","_id":"@arelis-ai/mcp-server@0.1.0","maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"bin":{"arelis-mcp":"dist/index.js"},"dist":{"shasum":"0d80db2d78e074dd12d17e75d7299a7cdd556016","tarball":"https://registry.npmjs.org/@arelis-ai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":90,"integrity":"sha512-Xo+MrnS6+PjfCOtq2MDAw9efug2LVbr8Q5xwFJKafmSioj4qQmIuOZGElo5KC6TUsjTAnaImTShjU2qcoUhlIQ==","signatures":[{"sig":"MEYCIQCLwARjrVwTVbu3i0hCTzRhfO5FUMYdTiU3mxkguVLbhAIhAN2sAGmSLjIDoDTYvX2Li2G4+NOF2U8xrg7VPz+q6Yo7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102942},"main":"./dist/index.js","type":"module","_from":"file:arelis-ai-mcp-server-0.1.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src/","test":"vitest run","build":"tsc","type-check":"tsc --noEmit","test:integration":"vitest run --config vitest.integration.config.ts"},"_npmUser":{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"},"_resolved":"/private/var/folders/kk/d764pt8s4jd889qgz7tp5fbr0000gn/T/4d3f7fce82e22ce1541e5ce69c13bf5f/arelis-ai-mcp-server-0.1.0.tgz","_integrity":"sha512-Xo+MrnS6+PjfCOtq2MDAw9efug2LVbr8Q5xwFJKafmSioj4qQmIuOZGElo5KC6TUsjTAnaImTShjU2qcoUhlIQ==","_npmVersion":"10.8.2","description":"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.","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1","@arelis-ai/arelis-governance-sdk":"1.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1771583079807_0.8527274809622847","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arelis-ai/mcp-server","version":"0.1.1","_id":"@arelis-ai/mcp-server@0.1.1","maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"bin":{"arelis-mcp":"dist/index.js"},"dist":{"shasum":"39eb56941f0c020e2054f7c856167873b07e0aae","tarball":"https://registry.npmjs.org/@arelis-ai/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":90,"integrity":"sha512-M7/t6MDk8H67TKCh4fiRYkV8G8GWu6nJLvYDhDfR6eaPvEYC3kmaVgpp/UX0brQwxG/yYohGNn/mIowsh8KMVA==","signatures":[{"sig":"MEQCIEBh9bR6XcMj6k4uApOtcsP1j7EmMrmq+yLwW1Sr9LtOAiBM5GnGFO/TXI38xKl18fLP/+GIa94XNag2AK9/EdjmLA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102955},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"91f3826c0885a8221bbe59cc3a3fc205582f9805","scripts":{"dev":"tsc --watch","lint":"eslint src/","test":"vitest run","build":"tsc","type-check":"tsc --noEmit","test:integration":"vitest run --config vitest.integration.config.ts"},"_npmUser":{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"},"_npmVersion":"10.8.2","description":"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.","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1","@arelis-ai/arelis-governance-sdk":"1.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1771585318542_0.7148462884694426","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@arelis-ai/mcp-server","version":"0.1.2","type":"module","bin":{"arelis-mcp":"dist/index.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"publishConfig":{"access":"public"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"vitest run","test:integration":"vitest run --config vitest.integration.config.ts","lint":"eslint src/","type-check":"tsc --noEmit"},"dependencies":{"@arelis-ai/arelis-governance-sdk":"1.1.1","@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"@arelis-ai/mcp-server@0.1.2","gitHead":"1e54c26df820185e3c5a9327911577623c053745","description":"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.","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-KD2Gs2MAaUTITuxZezXICPnjpQ9SEX0IHz4k8NFTLj9QgQa/4CFFOcZmxdJ9EoZ03ccnOstZcO3nVWTv8odirw==","shasum":"bc41179934ac3c5148c56aa3fa25c110d81d643e","tarball":"https://registry.npmjs.org/@arelis-ai/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":90,"unpackedSize":106387,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFsZ1v6nWJ8vkt3NA4s9Xy3AdpV3nN2R7cCRCwJQh27nAiA1lKGcQLa/SNl0xLHbiur6cQ8Ux5gN6faTWN/BYWXayw=="}]},"_npmUser":{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"},"directories":{},"maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.2_1771586484262_0.138500339023804"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T10:24:39.746Z","modified":"2026-02-20T11:21:24.524Z","0.1.0":"2026-02-20T10:24:39.953Z","0.1.1":"2026-02-20T11:01:58.684Z","0.1.2":"2026-02-20T11:21:24.388Z"},"description":"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.","maintainers":[{"name":"arelis-ai","email":"ramon.marrero@arelis.digital"}],"readme":"# @arelis-ai/mcp-server\n\nMCP (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.\n\n## Quick Start\n\n### STDIO (default)\n\n```bash\nARELIS_API_KEY=sk_live_... npx @arelis-ai/mcp-server\n```\n\n### HTTP with Bearer auth\n\n```bash\nARELIS_API_KEY=sk_live_... ARELIS_MCP_SECRET=my-secret \\\n  npx @arelis-ai/mcp-server --transport http --port 3100\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `ARELIS_API_KEY` | Yes | — | Arelis platform API key |\n| `ARELIS_BASE_URL` | No | `https://api.arelis.digital` | Arelis API base URL |\n| `ARELIS_MCP_SECRET` | No | — | Bearer token for HTTP transport auth |\n| `DEBUG` | No | `false` | Enable verbose logging |\n\n## Claude Desktop Setup\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"arelis-governance\": {\n      \"command\": \"npx\",\n      \"args\": [\"@arelis-ai/mcp-server\"],\n      \"env\": {\n        \"ARELIS_API_KEY\": \"sk_live_...\"\n      }\n    }\n  }\n}\n```\n\n## Tools (40)\n\n### Events (4)\n| Tool | Description |\n|---|---|\n| `arelis_events_create` | Log an audit event |\n| `arelis_events_list` | List audit events with filters |\n| `arelis_events_get` | Get a single audit event by ID |\n| `arelis_events_count` | Count events matching filters |\n\n### AI Systems (5)\n| Tool | Description |\n|---|---|\n| `arelis_ai_systems_register` | Register a new AI system |\n| `arelis_ai_systems_list` | List registered AI systems |\n| `arelis_ai_systems_get` | Get AI system details |\n| `arelis_ai_systems_update` | Update an AI system |\n| `arelis_ai_systems_set_default` | Set the default AI system |\n\n### Jobs (3)\n| Tool | Description |\n|---|---|\n| `arelis_jobs_list` | List async jobs |\n| `arelis_jobs_get` | Get job status and result |\n| `arelis_jobs_retry` | Retry a failed job |\n\n### Governance (9)\n| Tool | Description |\n|---|---|\n| `arelis_governance_policies_create` | Create a governance policy |\n| `arelis_governance_policies_list` | List governance policies |\n| `arelis_governance_policies_get` | Get policy details |\n| `arelis_governance_policies_update` | Update a policy |\n| `arelis_governance_policies_create_version` | Create a new policy version |\n| `arelis_governance_policies_list_versions` | List versions of a policy |\n| `arelis_governance_policies_activate_version` | Activate a specific version |\n| `arelis_governance_policies_simulate` | Simulate policy evaluation |\n| `arelis_governance_evaluations_list` | List policy evaluations |\n\n### Risk (6)\n| Tool | Description |\n|---|---|\n| `arelis_risk_config_get` | Get current risk configuration |\n| `arelis_risk_config_save_draft` | Save a risk config draft |\n| `arelis_risk_config_clear_draft` | Discard the current draft |\n| `arelis_risk_config_publish` | Publish draft as active config |\n| `arelis_risk_config_rollback` | Rollback to a previous version |\n| `arelis_risk_simulate` | Simulate a risk assessment |\n\n### Proofs (3)\n| Tool | Description |\n|---|---|\n| `arelis_proofs_request` | Request a compliance proof |\n| `arelis_proofs_get` | Get proof details |\n| `arelis_proofs_verify` | Verify a compliance proof |\n\n### Approvals (2)\n| Tool | Description |\n|---|---|\n| `arelis_approvals_list` | List pending approvals |\n| `arelis_approvals_resolve` | Approve or reject an approval |\n\n### Replay (4)\n| Tool | Description |\n|---|---|\n| `arelis_replay_create` | Create a replay verification |\n| `arelis_replay_get` | Get replay result |\n| `arelis_replay_templates_list` | List replay templates |\n| `arelis_replay_templates_save` | Save a replay template |\n\n### Exports (4)\n| Tool | Description |\n|---|---|\n| `arelis_exports_create` | Create a data export |\n| `arelis_exports_list` | List exports |\n| `arelis_exports_get` | Get export details |\n| `arelis_exports_download` | Get export download URL |\n\n## Resources (5)\n\n| URI | Description |\n|---|---|\n| `arelis://governance/policies` | Active governance policies |\n| `arelis://risk/config` | Current risk configuration |\n| `arelis://context/environment` | Environment information |\n| `arelis://ai-systems/registry` | Registered AI systems |\n| `arelis://usage/quotas` | Usage quotas and limits |\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Build\npnpm --filter @arelis-ai/mcp-server build\n\n# Run unit tests (155 tests)\npnpm --filter @arelis-ai/mcp-server test\n\n# Run integration tests\npnpm --filter @arelis-ai/mcp-server test:integration\n\n# Lint\npnpm --filter @arelis-ai/mcp-server lint\n\n# Type check\npnpm --filter @arelis-ai/mcp-server type-check\n```\n\n### Integration Tests\n\nThe integration test suite includes:\n\n- **In-process startup test**: Uses `InMemoryTransport` to verify the server registers all 40 tools and 5 resources\n- **HTTP transport test**: Spawns the server with `--transport http` and verifies auth rejection (401) and successful initialization\n- **API smoke tests**: Skipped unless `ARELIS_TEST_API_KEY` is set; tests actual API calls through the MCP server\n\n```bash\n# Run with a live API key for full coverage\nARELIS_TEST_API_KEY=sk_test_... pnpm --filter @arelis-ai/mcp-server test:integration\n```\n\n## Architecture\n\n```\nsrc/\n  index.ts          # CLI entry point (STDIO/HTTP transport)\n  server.ts         # McpServer creation and tool/resource registration\n  client.ts         # Lazy singleton ArelisPlatform SDK client\n  config.ts         # Environment variable configuration\n  errors.ts         # Unified error formatting for MCP responses\n  tools/            # 40 tools across 9 categories\n  resources/        # 5 read-only resources\n  integration/      # Integration test suite\n```\n","readmeFilename":"README.md"}