@expunct/mcp

MCP (Model Context Protocol) server for Expunct. Exposes PII detection and redaction tools for Claude Code, Claude Desktop, and other MCP-compatible clients.

Quick Start

{
  "mcpServers": {
    "expunct": {
      "command": "npx",
      "args": ["@expunct/mcp"],
      "env": {
        "EXPUNCT_API_KEY": "pk_live_...",
        "EXPUNCT_BASE_URL": "https://api.expunct.ai"
      }
    }
  }
}

Add this to:

• Claude Code: .mcp.json in your project root or ~/.claude/.mcp.json globally
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | EXPUNCT_API_KEY | Yes | — | Your API key (pk_live_... or pk_test_...) | | EXPUNCT_BASE_URL | No | https://api.expunct.ai | API endpoint URL |

Tools

| Tool | Description | Sync | |------|-------------|------| | expunct_sanitize_text | Redact PII from text (27+ entity types) | Yes | | expunct_sanitize_file | Submit file/URI for async redaction (PDF, DOCX, images, video, audio) | No | | expunct_sanitize_batch | Batch redact 1-100 URIs | No | | expunct_check_status | Poll job progress | Read-only | | expunct_list_entity_types | List all supported entity types | Read-only | | expunct_get_findings | Get detected PII for a completed job | Read-only |

Development

# Install
npm install

# Type check
npm run typecheck

# Test
npm test

# Build
npm run build

# Run locally
EXPUNCT_API_KEY=pk_test_... node dist/index.js

CI Secrets

The CI workflow requires:

• GH_PAT — GitHub PAT with repo scope (for cross-repo access to the Node SDK)

The publish workflow additionally requires:

• NPM_TOKEN — npm access token for publishing

License

MIT