{"_id":"@actalumen/mcp-server","name":"@actalumen/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@actalumen/mcp-server","version":"0.1.0","description":"MCP server for ActaLumen — verify documents for compliance from Claude Desktop, Cursor, and Claude Code.","type":"module","bin":{"actalumen-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","health":"node dist/index.js --health","test":"vitest run"},"engines":{"node":">=18.17"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.23.8","zod-to-json-schema":"^3.23.0"},"devDependencies":{"@types/node":"^20.14.0","typescript":"^5.5.0","vitest":"^2.0.0"},"publishConfig":{"access":"public"},"_id":"@actalumen/mcp-server@0.1.0","gitHead":"c8dc3384ef1e771d714738bde5ef7038ad5f7501","_nodeVersion":"20.19.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-/YEgDWIijYQI+ELtsd7M7TwYgV2oHoM/W73yvE1pyARDEcu0+wYs3y0ncxRofinh+LGXAkrWiSCkKmZBroUrCg==","shasum":"a447d8ac048a0d311f70e7f2fc4430d8031994b0","tarball":"https://registry.npmjs.org/@actalumen/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":28,"unpackedSize":19385,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC441Zi71POSkyYha2C3lyIx81uKGOGUrhyaIKqo7suHgIhAJIxSZaIIlztDy/dpKT3bSxS7Xc+2/YQedIeW5BvXDAY"}]},"_npmUser":{"name":"actalumen","email":"whutchinson@actalumen.com"},"directories":{},"maintainers":[{"name":"actalumen","email":"whutchinson@actalumen.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1779066180388_0.3273153823281698"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T01:03:00.286Z","0.1.0":"2026-05-18T01:03:00.535Z","modified":"2026-05-18T01:03:00.731Z"},"maintainers":[{"name":"actalumen","email":"whutchinson@actalumen.com"}],"description":"MCP server for ActaLumen — verify documents for compliance from Claude Desktop, Cursor, and Claude Code.","readme":"# @actalumen/mcp-server\n\nMCP server for [ActaLumen](https://actalumen.com) — verify documents for compliance from Claude Desktop, Cursor, and Claude Code.\n\n## What it does\n\nExposes ActaLumen's verification, chat, and document tooling to any MCP-compatible AI agent. Your agent can upload a contract, run it against a compliance template (SOC2, GDPR, custom), and chat with the document — all grounded in citations.\n\n**PII is redacted server-side before storage.** Agents never see un-redacted content, even when explicitly asked.\n\n## Install\n\n### Prerequisites\n\n1. An ActaLumen API key with `read`, `write`, and `verify` scopes. Create one at **app.actalumen.com → Settings → API Keys**.\n2. Node.js 18.17 or newer.\n3. A directory the agent is allowed to upload from. Default: `~/actalumen-inbox` (create it: `mkdir ~/actalumen-inbox`).\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"actalumen\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@actalumen/mcp-server\"],\n      \"env\": {\n        \"ACTALUMEN_API_KEY\": \"ak_live_...\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see the ActaLumen tools in the tools menu.\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"actalumen\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@actalumen/mcp-server\"],\n      \"env\": { \"ACTALUMEN_API_KEY\": \"ak_live_...\" }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add actalumen -- npx -y @actalumen/mcp-server\n# then set the key in your shell or settings:\nexport ACTALUMEN_API_KEY=ak_live_...\n```\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `ACTALUMEN_API_KEY` | (required) | Org-scoped API key. |\n| `ACTALUMEN_BASE_URL` | `https://api.actalumen.com` | Override for self-hosted or staging. |\n| `ACTALUMEN_UPLOAD_DIR` | `~/actalumen-inbox` | Path allowlist — agents can only upload files from inside this directory. |\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `upload_document` | Upload a PDF (must be inside `ACTALUMEN_UPLOAD_DIR`). Returns a document ID; PII is redacted on the server before storage. |\n| `get_document` | Poll a document's status — wait for `READY` before verifying or chatting. |\n| `list_documents` | Find existing documents by name without re-uploading. |\n| `list_templates` | Discover available compliance templates (e.g., SOC2 Vendor). |\n| `start_verification` | Run a document against a template. Returns a `jobId`. |\n| `get_verification` | Fetch report status and findings. |\n| `chat_with_document` | Ask grounded questions about one or more documents. |\n| `get_usage` | Check plan quota before batch operations. |\n\n## Example agent flow\n\n> \"Check whether `~/actalumen-inbox/acme-msa.pdf` meets our SOC2 vendor requirements and summarize the gaps.\"\n\nThe agent will:\n\n1. `list_templates` → find the SOC2 template.\n2. `upload_document` → get a document ID, wait for `READY` via `get_document`.\n3. `start_verification` → get a `jobId`.\n4. `get_verification` (polling) → receive the full report.\n5. Summarize the failed criteria back to you with page citations.\n\n## Verify your install\n\n```bash\nACTALUMEN_API_KEY=ak_live_... npx -y @actalumen/mcp-server --health\n# → ok — https://api.actalumen.com — org Acme Inc — upload dir /Users/.../actalumen-inbox\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-4fbc9bacb1851727af6dcac783f84ecd"}