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

Sign up at https://qorenext-app.azurewebsites.net/signup to get your QORENEXT_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)

---

Support

• Issues: https://github.com/QoreNext-IT/QoreNextMCP/issues
• Email: support@qorenext.com
• Docs: https://qorenext.com

---

License

MIT