🛡️ Nooxus-AI: Sourcing Edge for Claude Desktop (MCP)
Nooxus-MCP is the official Model Context Protocol (MCP) gateway connecting AI models (Claude, Gemini, Cursor, Cherry Studio) to real-time, verified global supply chain data.
By installing this, you instantly upgrade your AI from a conversational chatbot into a Forensic Sourcing Analyst. It cross-references the AII-NOO verified database to expose shell companies, verify real manufacturers, and completely eliminate B2B trade hallucinations.
✨ The "Aha Moment" (Key Features)
- Zero-Hallucination Sourcing: Direct access to Nooxus Edge nodes. If a factory is a fake trading proxy, the AI will know.
- Forensic UI Rendering: Forces the LLM to generate professional UI dashboards (Trust Scores, Red Flags, Capacity) instead of boring text.
- Edge Native Architecture: Pure Cloudflare Zero-Backend architecture featuring L1 memory caching and CRC32 payload security.
- Out-of-the-Box Trial: Includes a built-in global public trial key (1,000,000-query quota). No sign-up required to start!
🚀 Quick Start (Zero Config)
You DO NOT need an API key to start. The system will automatically use the built-in trial token. We use uvx for a lightning-fast, zero-install experience.
For Claude Desktop (Recommended)
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"nooxus-edge": {
"command": "uvx",
"args": ["nooxus-mcp@latest"]
}
}
}
(Restart Claude Desktop. You will see the 🔨 hammer icon indicating Nooxus tools are loaded.)
🔄 How to Force Upgrade
Because the uv package manager uses aggressive local caching for speed, you might not get the newest update immediately even with the @latest tag. To force an upgrade to the newest version, open your terminal and run:
uvx --refresh nooxus-mcp@latest --version
🎯 The Playbook (How to trigger the Sourcing Agent)
To guarantee the AI uses the verified database and renders the professional UI, always start your prompts with our cheat code: Use Nooxus |
1. Market Scanning & Discovery
"Use Nooxus | I am looking for verified suppliers of 'terminal testing equipment' in Nanjing. Please search your network."
2. The Deep-Dive Forensic Audit (Killer Feature 🔥)
"Use Nooxus | Give me a deep-dive forensic audit on this node: NOO-PFJ77WGLNYHRXDZE. Show me the red flags and trust scores."
🔑 Advanced: Upgrading Your Quota
Once you exhaust the generous daily limits of the global trial key, you can seamlessly plug in your own developer API key for unlimited deep-dive audits.
- Register for free at SmartGSC.com or Nooxus.com.
- Generate your
NOOXUS_API_KEY. - Update your MCP config by adding the
envblock:
{
"mcpServers": {
"nooxus-edge": {
"command": "uvx",
"args": ["nooxus-mcp@latest"],
"env": {
"NOOXUS_API_KEY": "your_personal_key_here"
}
}
}
}
🔍 Available AI Tools (Under the hood)
semantic_search_nooxus(query): Lightning-fast semantic search optimized for manufacturing entities. Returns potential partners and their NOO-IDs.get_nooxus_node(noo_id): Retrieves the full verification profile. Triggers Strategy D to force the AI to act as a Risk Analyst and render a visual warning dashboard.
👨💻 Developer & Troubleshooting
1. Command Line Testing (MCP Inspector)
Use the official inspector to visualize and test tools in your browser without Claude:
npx @modelcontextprotocol/inspector uvx --refresh nooxus-mcp
2. Local Debug Mode
To generate a local log file mcp-logs.txt for deep troubleshooting:
NOOXUS_DEBUG=true uvx nooxus-mcp
3. macOS Path Conflicts (realpath missing)
If you encounter realpath: command not found on older macOS versions:
brew install coreutils
export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"
📈 Release History
- V0.1.6: Documentation overhaul, introduced "Cheat Code" prompting strategies, explicit upgrade commands, and API Quota instructions.
- V0.1.5: Updated semantic search and node retrieval logic for higher UI conversion.
- V0.1.2: Fixed protocol pollution, enforced stderr logging.
Official Portal: SmartGSC.com | Protocol Details: Nooxus.com