idcanopy-aletheia-mcp

MCP server for the IDCanopy forensic-scoring-api — a document-fraud-detection service for bank onboarding. Exposes the analysis API as MCP tools that an AI agent (Claude Desktop, Cline, codexx, …) can call to score applicant documents for fraud and pull back auditable findings and PDF reports.

This package is standalone: it depends only on the mcp SDK and the Python standard library — not on the forensic engine itself. It talks to a running forensic-scoring-api instance over HTTP.

Install

pip install idcanopy-aletheia-mcp

Run

export FORENSIC_API_TOKEN=<bearer>                    # required; env only, never logged
export FORENSIC_API_BASE_URL=https://forensic.s1.cindrla.world
idcanopy-aletheia-mcp

Or wire it into an MCP client (~/.claude/mcp.json, Cline, codexx — see the full config snippets in the project portal at https://forensic.s1.cindrla.world/portal/):

{
  "servers": {
    "forensic": {
      "command": "idcanopy-aletheia-mcp",
      "env": {
        "FORENSIC_API_TOKEN": "<bearer>",
        "FORENSIC_API_BASE_URL": "https://forensic.s1.cindrla.world"
      }
    }
  }
}

Tools

analyze_documents and get_applicant_result emit MCP progress notifications on long calls when the client supplies a progressToken.

Security

The bearer token is read from FORENSIC_API_TOKEN only. It is never logged, echoed, or included in any tool's return value or error text.

License

Proprietary — © IDCanopy / CINDR.LA.