Qorenext Trade Screening MCP

Sanctions and trade-screening due-diligence — via MCP

Qorenext Trade screening MCP is a Model Context Protocol server that enables Claude and other AI clients to run sanctions screening and trade-screening due-diligence directly in chat.

Prerequisites:

• Node.js and npm installed (npm is used to install the connector package).
• A QoreNext Trade Screening api key.
• An active product subscription is required to use Qore MCP.
• Administrator or standard access to edit files in your user profile.

Related MCP server: Vala-Fi MCP Server

Get your API key

Sign up at https://qorenext-app.azurewebsites.net/signup to get your QORENEXT_API_KEY.

Steps to get your API Key

1. Sign up at https://qorenext-app.azurewebsites.net/signup.

2. Select Trade Screening.

3. Buy your subscription plan.

4. Open Profile → APIs.

5. Click Generate API Key.

6. Give your API key a name and click Create.

7. Copy the API key for use in Claude.

How To Connect:

A) Claude Code

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

B) Claude Desktop

Prerequisites:

• Claude Desktop installed on Windows.
• Node.js and npm installed (npm is used to install the connector package).
• A QoreNext Trade Screening api key.
• An active product subscription is required to use Qore MCP.
• Administrator or standard access to edit files in your user profile.

Install Node.js

• Download and install the LTS version from nodejs.org.

• The installation includes npm and npx.

• Open Terminal (Mac) or Command Prompt/PowerShell (Windows).

• Verify the installation: `bash below commands
  node -v
  npx -v

Both commands should display a version number.
If you see "command not found", restart your terminal and try again.

## Steps to Setup the Claude Desktop

1. Open Claude Desktop

Launch the Claude Desktop application on your computer.

2. Open Settings

Go to: Menu → File → Settings

3. Open Developer Settings

In the Settings window, select Developer from the left-side menu.

4. Open the Config File

Click Edit Config to open the claude_desktop_config.json file.
Remove the existing command in the file and paste the configuration provided below in Json.

Windows default location:
C:\Users<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

5. Add the QoreNext MCP Server

Add the following configuration to claude_desktop_config.json and replace qore_xxxxx with your real API key.

{
  "mcpServers": {
    "qorenext-mcp-ts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.qorenext.com/tradescreening",
        "--header",
        "X-API-Key:qore_xxxxx"
      ]
    }
  }
}

Watch your JSON syntax Make sure the JSON braces and commas match exactly — one missing comma will break the file.

6. Save the file

Save your changes (Ctrl+S) and close the editor.

7. Restart Claude Desktop

Fully quit Claude Desktop by closing it, exiting it from the system tray/taskbar, and using Task Manager to End Task for any remaining Claude processes running in the background; then reopen Claude Desktop.

C) ChatGPT Desktop

This guide explains how to configure the QoreNext MCP Server in the ChatGPT Desktop application.

Prerequisites

• ChatGPT Desktop installed on your computer.

• A valid QoreNext API key.

• Internet connectivity.

Step 1: Open ChatGPT Desktop

1. Launch the ChatGPT Desktop application.

2. At the top of the ChatGPT window, locate the mode dropdown above the New Chat icon.

3. Change the mode to Codex.

Step 2: Open Settings

1. Click your profile icon in the bottom-left corner of the ChatGPT window.

2. Select Settings.

Step 3: Open Plugins

Navigate to:

Integrations → Plugins

Step 4: Add an MCP Server

1. In the Plugins window, click the Add dropdown.

2. Select Add MCP Server.

Step 5: Configure the QoreNext MCP Server

Name

QoreNext MCP Server

Command to Launch

npx

Arguments

Add the following arguments one by one:

-y
mcp-remote
https://mcp.qorenext.com/tradescreening
--header
X-API-Key: YOUR_API_KEY

**Replace YOUR_API_KEY with your actual QoreNext API key.

Step 6: Save the MCP Server

1. Verify all fields and arguments.

2. Click Save.

3. Close the configuration window.

Step 7: Restart ChatGPT Desktop

1. Close ChatGPT Desktop completely.

2. Open Task Manager and end any remaining ChatGPT processes.

3. Reopen ChatGPT Desktop.

4. After ChatGPT Desktop opens, Switch the mode from Codex to ChatGPT

D) Cursor / Windsurf

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

{
  "mcpServers": {
    "qorenext-mcp-ts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.qorenext.com/tradescreening",
        "--header",
        "X-API-Key:qore_xxxxx"
      ]
    }
  }
}

Tools

health_check

Verify the server is running. No API key required.

check if Qorenext Trade Screening MCP is running

submit_sanctions_screening

Submit entities for sanctions screening against USA sanctions lists (OFAC, MEU, EntityList, etc.).

Required per entity: entityEnglishName or entityNativeName (at least one)

Optional: country, address

Screen Acme trading LLC أكمي للتجار at 123 Azadi Street, Tehran for sanctions 

Returns: one result per submitted entity, each with matchFound, bestMatchScore, and matches.

Example Response (Status 200):

{
  "success": true,
  "status_code": 200,
  "data": [
    {
      "entityEnglishName": "Acme Trading LLC",
      "entityNativeName": "أكمي للتجارة",
      "country": "Iran",
      "address": "123 Azadi Street, Tehran",
      "matchFound": false,
      "bestMatchScore": 0,
      "matches": []
    }
  ],
  "message": ""
}

submit_trade_screening

Submit a company for trade screening due-diligence: denied/restricted-party list checks, red-flag keyword analysis, risk assessment, and negative-news findings.

Required: address, website, and companyEnglishName or companyNativeName (at least one)

Optional: parentEntityEnglishName, parentEntityWebsite

Qore's /trade-screening/add-company endpoint internally requires several additional fields (Labs, LabsWebsite, Department, DepartmentWebsite, Professors, Product, EndUse, ParentEntity, referenceNumber) beyond what this tool asks for — the tool sends them as blank strings automatically, callers never need to supply them.

Example Input:

{
  "companyEnglishName": "Changchun New Industries Optoelectronics Tech. Co., Ltd.",
  "companyNativeName": "长春新产业光电技术有限公司",
  "address": "No.888 Jinhu Road High-tech Zone, Changchun 130103, P.R.China",
  "website": "https://test.com",
  "parentEntityEnglishName": "",
  "parentEntityWebsite": ""
}

companyNativeName may be omitted if companyEnglishName is provided (and vice versa). parentEntityEnglishName/parentEntityWebsite are optional.

run trade screening on Acme Corp at 1 Main St, https://acme.com
due-diligence check for Changchun New Industries Optoelectronics, https://cnilaser.com

Returns:

• data: Tracking id (NativeId) — use with get_trade_screening_status

• message: Description or error message

Example Response (Status 200):

{
  "success": true,
  "status_code": 200,
  "data": 424,
  "message": ""
}

Known issue (Qore backend, not this server): new submissions currently fail intermittently with "Object reference not set to an instance of an object." (status_code: 422) — a server-side null-reference exception in Qore's request-processing pipeline, not a client-side validation problem. Duplicate submissions of already-known companies are unaffected. Confirmed via direct testing against the live API as of 2026-08-19; pending a fix from the Qore API team.

get_trade_screening_status

Poll a trade screening request for status and the full due-diligence report.

Parameter: request_id (int) — the NativeId returned by submit_trade_screening

Status values: Pending · Processing · Completed · Failed

get status of trade screening request 424
check if screening 322 is complete

output (risk assessment, red-flag findings, restricted-party matches, recommendation) is only present once status is Completed.

Example workflow

Sanctions Screening:

You:    Screen Acme Trading LLC in Iran for sanctions.

Claude: [calls submit_sanctions_screening]
        ✅ Screened. No match found (score: 0)

Trade Screening:

You:    Run trade screening on Changchun New Industries Optoelectronics Tech. Co., Ltd, No.888 Jinhu Road High-tech Zone,Changchun 130103, P.R.China, https://www.cnilaser.com/C-profile.htm

Claude: [calls submit_trade_screening]
        ✅ Submitted. Tracking ID: 424

You:    Get status of trade screening request 424

Claude: [calls get_trade_screening_status]
        Status: Completed
        Risk Level: Medium
        Recommendation: Proceed with standard due diligence.

# Risk Assessment Summary
 
## Changchun New Industries Optoelectronics Tech. Co., Ltd. (CNI)
 
- **Country:** China
- **Industry:** Optoelectronics and Laser Systems Manufacturing
- **Risk Level:** High
 
### Company Overview
 
Changchun New Industries Optoelectronics Tech. Co., Ltd. is a Chinese manufacturer of lasers, laser systems, spectrum analyzers, and optical equipment. The company was founded by Changchun Institute of Optics, Fine Mechanics and Physics, Chinese Academy of Sciences and exports its products globally.
 
### Negative Findings
 
- Products are used in national defense equipment, aerospace, aviation, and satellite-related applications.
- Produces laser products used for semiconductor-related applications, including semiconductor cutting.
- Founded by Changchun Institute of Optics, Fine Mechanics and Physics, Chinese Academy of Sciences, which is present on a Restricted Party List.
- Awarded a procurement project by Beijing University of Aeronautics and Astronautics (BUAA), which is present on a Restricted Party List.
- Participated in a high-power semiconductor laser project involving Huawei Technologies Co., Ltd., Tsinghua University, Jilin University, and Sichuan University, which are identified as restricted or high-risk entities in the report.
 
### Recommendation
 
**High Risk. Proceed with caution and conduct enhanced due diligence before engagement. Particular attention should be given to the company's defense, aerospace, satellite, semiconductor-related activities, and its associations with restricted or high-risk entities.**

Support

• Issues: https://github.com/QoreNext/qorenext-tradescreening-mcp/issues

• Email: support@qorenext.com

• Docs: https://qorenext.com

License

MIT