MCP 服务器

QoreNextMCP

Enables company hierarchy analysis and address verification through MCP, allowing submission of entities for screening, duplicate detection, and status polling.

README

QorenextMCP

Company hierarchy analysis and address verification — via MCP

QorenextMCP is a Model Context Protocol server that enables Claude and other AI clients to perform company hierarchy analysis and address verification directly in chat.

Get your API key

Connect

Claude Code

claude mcp add --transport http qorenext-mcp \
  "https://mcp.qorenext.com/mcp/" \
  --header "X-API-Key: YOUR_API_KEY"

Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "qorenext-mcp": {
      "url": "https://mcp.qorenext.com/mcp/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
        "Accept": "application/json"
      }
    }
  }
}

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json:

{
  "mcpServers": {
    "qorenext-mcp": {
      "url": "https://mcp.qorenext.com/mcp/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools

Tool	Auth	Description
`health_check`	❌ Public	Verify server is running, get version info
`submit_entities`	✅ API Key	Submit companies for address verification or hierarchy creation
`submit_duplicates`	✅ API Key	Submit duplicate entities from JSON, CSV, or Excel files
`get_request_status`	✅ API Key	Poll status and retrieve results of any screening request

`health_check`

Verify the server is running. No API key required.

check if QorenextMCP is running

`submit_entities`

Submit companies for Hierarchy creation or Address verification.

Required per entity: entityName, country, address, screeningType ("Hierarchy" or "Address verification")

Optional: crmid, website

submit Acme Corp from USA for Hierarchy creation
submit Apple Inc from USA at 1 Apple Park Way, Cupertino for Address verification
submit Samsung from South Korea at Samsung Tower, Seoul for Address verification

`submit_duplicates`

Submit duplicate account records from files (JSON, CSV, or Excel) for deduplication detection.

Required: file_content, file_type

Optional: file_name

Supported File Types:

json - JSON array format
csv - Comma-separated values with headers
excel or xlsx - Microsoft Excel workbooks

Required Fields (per record):

crmAccountId - Account identifier
crmAccountName - Account/Company name
country - Country name

Optional Fields:

addressLine1 - Street address
addressLine2 - Suite, apt, unit, etc.
city - City name
stateProvince - State or Province
postalCode - ZIP/Postal code
website - Website URL

File Format Requirements:

JSON Array:

[
  {
    "crmAccountId": "CRM-00001",
    "crmAccountName": "Acme Technologies",
    "addressLine1": "123 Main Street",
    "addressLine2": "Suite 100",
    "city": "New York",
    "stateProvince": "NY",
    "country": "United States",
    "postalCode": "10001",
    "website": "www.acmetech.com"
  },
  {
    "crmAccountId": "CRM-00001-B",
    "crmAccountName": "Acme Tech",
    "addressLine1": "123 Main St",
    "city": "New York",
    "stateProvince": "NY",
    "country": "United States",
    "postalCode": "10001"
  }
]

CSV with Headers:

crmAccountId,crmAccountName,addressLine1,city,stateProvince,country,postalCode,website
CRM-00001,Acme Technologies,123 Main Street,New York,NY,United States,10001,www.acmetech.com
CRM-00002,Blue Ridge Software,456 Oak Avenue,Los Angeles,CA,United States,90001,www.blueridgesoftware.com

Excel Workbook:

First row: Column headers
Data rows: Account records
Supports any of the field names listed above

Examples:

submit deduplication for CSV file with 50 company records
detect duplicates from Excel file of CRM accounts
process JSON file to find similar companies

Returns:

data: Number of duplicate pairs detected
message: Description of results
details: Record count and duplicate pair count

Example Response (Status 200):

{
  "success": true,
  "status_code": 200,
  "data": 66,
  "message": "Successfully detected 66 duplicate pairs from 8 records",
  "details": {
    "records_submitted": 8,
    "duplicate_pairs_found": 66,
    "file_name": "accounts.csv",
    "file_type": "csv"
  }
}

`get_request_status`

Poll a screening request for status and results.

Parameter: request_id (int)

Status values: PENDING · PROCESSING · COMPLETE · FAILED

get status of request 1001
check if screening 5042 is complete

Example workflow

You:    Submit Acme Corp from USA for Hierarchy creation.

Claude: [calls submit_entities]
        ✅ Submitted. Entity ID: 1042

You:    Get status of request 1042

Claude: [calls get_request_status]
        Status: COMPLETE
        Hierarchy: Acme Corp → Acme Holdings (USA) → GlobalCorp (UK)