Introduction to PortNexus

PortNexus is an autonomous trade compliance and documentary credit risk-management platform designed for exporters, freight forwarders, and trade finance institutions. It automates the cross-examination of commercial trade documents (Commercial Invoices, Bills of Lading, Packing Lists, Certificates of Origin) against international commercial credit stipulations governed by ICC UCP 600 rules.

By identifying typographical deviations, goods description mismatches, and deadline violations before container dispatch, PortNexus eliminates port demurrage fines and bank payment rejections.

System Architecture

PortNexus is built on a high-throughput, microservice-ready Node.js engine exposed via standard HTTP REST and Model Context Protocol (MCP) Server-Sent Events (SSE). It features three core analytical engines:

  • ICC UCP 600 Discrepancy Engine: Deterministic 14-point audit framework executing verbatim reconciliation across commercial invoices, bills of lading, and letters of credit.
  • WCO HS Code & Tariff Engine: Natural language commodity classifier mapping items to 6-digit and 8-digit Harmonized System codes with full statutory duty calculations (CD, RD, VAT, AIT).
  • Graph RAG Multi-Hop Engine: Relational knowledge graph connecting commodities, ports, international shipping corridors, bilateral free trade agreements (FTAs), and carbon compliance regulations (EU CBAM/CSDDD).

AI Agent Integration via Model Context Protocol (MCP)

PortNexus acts as a dedicated Model Context Protocol (MCP) server. External AI agents such as Claude Desktop, Gemini Spark, Cursor, or autonomous orchestration pipelines (e.g. n8n, LangGraph) can connect directly to PortNexus over Server-Sent Events (SSE) to audit trade files or query tariffs.

Live MCP SSE Endpoint URL https://portnexus.equisaas-bd.com/api/mcp/sse

Claude Desktop Configuration

To connect Claude Desktop to PortNexus, add the following entry to your claude_desktop_config.json file:

{
  "mcpServers": {
    "portnexus": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://portnexus.equisaas-bd.com/api/mcp/sse"]
    }
  }
}

Cursor & Gemini Spark Integration

In Cursor Settings or Gemini Spark Custom Tools, register a new MCP tool with:

  • Type: SSE (Server-Sent Events)
  • URL: https://portnexus.equisaas-bd.com/api/mcp/sse

Exposed MCP Tools

Tool Name Description Input Schema
audit_letter_of_credit Audits multi-document trade packages against ICC UCP 600 banking rules. { lc: Object, invoice: Object, bl: Object }
classify_hs_code Predicts 8-digit HS Code and computes statutory customs duties. { commodityDescription: String, invoiceValueUsd: Number }
query_trade_graph Traverses Graph RAG for transit times, FTAs, and compliance directives. { commodityId: String, destinationPortId: String }
search_trade_regulations Performs Contextual RAG search across international trade statutes. { query: String }

ICC UCP 600 Core Standards

The Uniform Customs and Practice for Documentary Credits (UCP 600) is the official set of rules issued by the International Chamber of Commerce (ICC) governing documentary letters of credit worldwide.

Article 18(c) : Goods Description Requirement

The description of goods, services, or performance in a commercial invoice must correspond strictly with that appearing in the credit. Unlike other stipulated documents (which may use general terms not in conflict), the commercial invoice must reflect the exact wording of Field 45A without alteration or abbreviation.

Article 20 : Marine Transport Document Inspection

The bill of lading must indicate that goods have been shipped on board a named vessel at the designated port of loading on or before the latest shipment date specified in Field 44C.

REST API Reference

POST /api/audit/trade-package

Evaluates an export documentation packet for UCP 600 compliance.

curl -X POST https://portnexus.equisaas-bd.com/api/audit/trade-package \
  -H "Content-Type: application/json" \
  -d '{
    "lc": {
      "beneficiary": "Apex Textile Mills Ltd, Dhaka, Bangladesh",
      "applicant": "H&M Hennes & Mauritz GBC AB, Stockholm, Sweden",
      "goodsDescription": "100% Combed Cotton Knitted T-Shirts in Assorted Sizes (Export Quality)",
      "amount": 125000,
      "currency": "USD",
      "portOfLoading": "Chattogram Port, Bangladesh",
      "portOfDischarge": "Port of Rotterdam, Netherlands",
      "latestShipmentDate": "2026-11-15"
    },
    "invoice": {
      "beneficiary": "Apex Textile Mills Ltd, Dhaka, Bangladesh",
      "applicant": "H&M Hennes & Mauritz GBC AB, Stockholm, Sweden",
      "goodsDescription": "100% Combed Cotton Knitted T-Shirts in Assorted Sizes (Export Quality)",
      "amount": 125000,
      "currency": "USD"
    },
    "bl": {
      "portOfLoading": "Chattogram Port, Bangladesh",
      "portOfDischarge": "Port of Rotterdam, Netherlands",
      "onBoardDate": "2026-11-10"
    }
  }'