@sourceverify/mcp-server

MCP server for the SourceVerify citation verification API. Lets AI assistants (Claude Code, Cursor, etc.) verify scholarly references directly.

For a command-line tool, see sourceverify.

Setup

Claude Code — add to .mcp.json in your project root:

{
  "mcpServers": {
    "sourceverify": {
      "command": "npx",
      "args": ["-y", "@sourceverify/mcp-server"],
      "env": {
        "SOURCEVERIFY_API_KEY": "sk_..."
      }
    }
  }
}

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "sourceverify": {
      "command": "npx",
      "args": ["-y", "@sourceverify/mcp-server"],
      "env": {
        "SOURCEVERIFY_API_KEY": "sk_..."
      }
    }
  }
}

Generic MCP client:

SOURCEVERIFY_API_KEY=sk_... npx @sourceverify/mcp-server

Get your API key at sourceverify.ai/account/api-keys.

Environment Variables

| Variable | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------- | | SOURCEVERIFY_API_KEY | Yes | Your API key | | SOURCEVERIFY_BASE_URL | No | Override API base URL (defaults to https://sourceverify.ai) |

Tools

verify_references (primary)

Submit references and wait for verification results. Handles polling automatically.

references: string[]       # 1-20 references, each 8-1200 chars
timeout_seconds?: number   # Max wait time (default 120, max 300)

submit_references

Submit references without waiting. Returns job IDs for async polling.

references: string[]       # 1-20 references, each 8-1200 chars

get_results

Check status of previously submitted jobs.

job_ids: string[]          # 1-50 job IDs

get_balance

Check token balance and plan info. No parameters.

get_history

Browse past verification history.

limit?: number             # Results per page (default 20, max 50)
offset?: number            # Pagination offset (default 0)

cancel_verification

Cancel in-progress jobs and refund tokens.

document_id?: string       # Cancel all jobs in a document
job_ids?: string[]         # Cancel specific jobs (max 50)

Token Usage

Each reference submitted costs 1 token. Tokens are reserved on submission and committed when verification completes. Failed or cancelled verifications are refunded.

Development

cd packages/mcp-server
npm install
npm run build        # Build
npm run typecheck    # Type check
npm test             # Run tests