trusqo-mcp

MCP server for the Trusqo proof of address verification API. Lets AI assistants verify utility bills, bank statements, and government letters directly.

Setup

You need a Trusqo API key. Get one at app.trusqo.com/api-keys.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "trusqo": {
      "command": "npx",
      "args": ["-y", "trusqo-mcp"],
      "env": {
        "TRUSQO_API_KEY": "poa_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add trusqo -- npx -y trusqo-mcp

Then set the TRUSQO_API_KEY environment variable before running Claude Code.

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "trusqo": {
      "command": "npx",
      "args": ["-y", "trusqo-mcp"],
      "env": {
        "TRUSQO_API_KEY": "poa_your_key_here"
      }
    }
  }
}

Tools

verify_document

Submit a document for proof of address verification.

Required parameters:

• name — person's full name
• address — expected address
• filePaths — array of absolute paths to document files (images or PDFs)

Optional parameters:

• postcode — postal code to verify
• acceptedDocTypes — e.g. ["utility-bill", "bank-statement", "government-letter"]
• acceptedDateFrom / acceptedDateTo — date range (YYYY-MM-DD)
• nameMatchThreshold / addressMatchThreshold / postcodeMatchThreshold — match thresholds (0-1)
• postcodeMatchEnabled — enable postcode matching

Returns a requestId for polling the result.

get_verification_result

Get the result of a verification request. If the status is pending or processing, wait a few seconds and try again.

Parameters:

• requestId — the ID returned by verify_document

download_verification_report

Download the PDF verification report.

Parameters:

• requestId — the request ID
• outputPath — (optional) where to save the PDF, defaults to ./trusqo-report-{requestId}.pdf

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TRUSQO_API_KEY | Yes | — | Your Trusqo API key (starts with poa_) | | TRUSQO_BASE_URL | No | https://app.trusqo.com | API base URL |