io.github.QoreNext-IT/qorenext-mcp

Official3 toolsLive

by QoreNext-IT

Company hierarchy analysis and address verification via MCP

QoreNext-IT/qorenext-mcp (MCP Server)

QorenextMCP is a Model Context Protocol (MCP) server that lets Claude and other AI clients perform company hierarchy analysis and address verification directly in chat. The server is published as io.github.QoreNext-IT/qorenext-mcp and is available via an HTTP transport endpoint.

🛠️ Key Features

Company hierarchy analysis via MCP
Address verification via MCP
3 tools provided

🚀 Use Cases

Analyze a company’s hierarchy in an AI chat workflow
Verify addresses through an AI client using MCP

⚡ Developer Benefits

Works with Claude and other MCP clients
Requires an API key header (X-API-Key: YOUR_API_KEY)
Connects over HTTP using the configured endpoint URL

⚠️ Limitations

Setup requires signing up to obtain QORENEXT_API_KEY
The provided information is limited to connectivity and high-level capabilities

Captured live from the server via tools/list.

health_check

Check MCP server health status. Verify this server is operational and get basic server information (name, version, auth method). Use for connectivity testing and diagnostics. No authentication required.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

submit_entities

Submit companies for address verification or hierarchy creation. Submit companies/organizations for address verification or organizational hierarchy analysis. Returns entity IDs for tracking.

Parameters1

entities

array

required

Raw schema

{
  "type": "object",
  "properties": {
    "entities": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "entities"
  ],
  "additionalProperties": false
}

get_request_status

Get screening request status and results. Check if request is complete (PENDING/PROCESSING/COMPLETE/FAILED) and retrieve results (HIERARCHY, VERIFICATION, TS). Returns organizational hierarchy, company verification, or sanctions screening data.

Parameters1

request_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "integer"
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}

README.md6 KBView on GitHub

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

bash

claude mcp add --transport http qorenext-mcp \
  "https://mcp.qorenext.com/crm" \
  --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):

json

{
  "mcpServers": {
    "qorenext-mcp": {
      "url": "https://mcp.qorenext.com/crm",
      "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:

json

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

Tools

Tool	Auth	Description
`health_check`	❌ Public	Verify server is running, get version info
`submit_address_verification`	✅ API Key	Submit companies for address verification and validation
`submit_hierarchy_creation`	✅ API Key	Submit companies for organizational hierarchy analysis
`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.

code

check if QorenextMCP is running

`submit_address_verification`

Submit companies for address verification and legitimacy validation.

Required per entity: companyName, country, address

Optional: crmid, website

code

verify Acme Corp at 123 Main Street, New York, USA
validate Apple Inc at 1 Apple Park Way, Cupertino, USA
check Samsung at Samsung Tower, Seoul, South Korea

`submit_hierarchy_creation`

Submit companies for organizational hierarchy analysis to identify parent-subsidiary relationships.

Required per entity: companyName, country

Optional: crmid, address, website

code

create hierarchy for Acme Corp from USA
analyze organizational structure for Apple Inc from USA
map corporate relationships for Samsung from South Korea

`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 in CSV and Excel files):

crmAccountId - Account identifier
crmAccountName - Account/Company name
addressLine1 - Street address
country - Country name

Optional Fields:

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

File Format Requirements:

JSON Array:

json

[
  {
    "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-00002",
    "crmAccountName": "Blue Ridge Software",
    "addressLine1": "456 Oak Avenue",
    "country": "United States"
  }
]

CSV with Headers:

code

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
Required columns: crmAccountId, crmAccountName, addressLine1, country
Optional columns: addressLine2, city, stateProvince, postalCode, website

Examples:

code

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):

json

{
  "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

code

get status of request 1001
check if screening 5042 is complete

Example workflow

Address Verification:

code

You:    Verify Apple Inc at 1 Apple Park Way, Cupertino, USA.

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

You:    Get status of request 1042

Claude: [calls get_request_status]
        Status: COMPLETE
        Address Verified: ✅ Yes
        Business Status: ACTIVE

Hierarchy Creation:

code

You:    Create hierarchy for Acme Corp from USA.

Claude: [calls submit_hierarchy_creation]
        ✅ Submitted. Entity ID: 1043

You:    Get status of request 1043

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

Install

Tools (3)

health_checksubmit_entitiesget_request_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.qorenext.com/mcp/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "qorenext-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.qorenext.com/mcp/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

QoreNext-IT/qorenext-mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

health_check

submit_entities

get_request_status

QorenextMCP

Get your API key

Connect

Claude Code

Claude Desktop

Cursor / Windsurf

Tools

health_check

submit_address_verification

submit_hierarchy_creation

submit_duplicates

get_request_status

Example workflow

Support

License

Install

Remote endpoint

Related servers

`health_check`

`submit_address_verification`

`submit_hierarchy_creation`

`submit_duplicates`

`get_request_status`