Nexusfeed Ltl

nexusfeed-mcp

[PyPI version] [Python 3.12+] [License: MIT]

Real-time LTL freight fuel surcharge rates and US state ABC liquor license compliance records — served as normalized, verifiable JSON for AI agents via the Model Context Protocol.

Data is extracted from carrier tariff pages and state ABC portals (JS-rendered, CAPTCHAs, session state) that are structurally inaccessible to raw LLM browsing. Every response includes a _verifiability block — extraction timestamp, confidence score, and source URL — so agents can assess data quality before acting.

Tools

Workflow Prompts

Get API Access

Subscribe via RapidAPI to receive your X-API-Key. Freemium plans available (10 req/day free).

Install

pip install nexusfeed-mcp# or with uv/uvx (no install needed):uvx nexusfeed-mcp

Configure

export MCP_API_BASE_URL=https://api.nexusfeed.devexport MCP_API_KEY=sk_live_your_key_here

Run (stdio)

# LTL tools only — 3 tools, 1 promptnexusfeed-ltl
# ABC tools only — 3 tools, 1 promptnexusfeed-abc
# All tools — 5 tools, 2 promptsnexusfeed-mcp

Claude Desktop Configuration

LTL fuel surcharge only:

{  "mcpServers": {    "nexusfeed-ltl": {      "command": "uvx",      "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],      "env": {        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",        "MCP_API_KEY": "sk_live_your_key_here"      }    }  }}

ABC license compliance only:

{  "mcpServers": {    "nexusfeed-abc": {      "command": "uvx",      "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],      "env": {        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",        "MCP_API_KEY": "sk_live_your_key_here"      }    }  }}

All tools:

{  "mcpServers": {    "nexusfeed-mcp": {      "command": "uvx",      "args": ["nexusfeed-mcp"],      "env": {        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",        "MCP_API_KEY": "sk_live_your_key_here"      }    }  }}

Cline (VS Code) Configuration

Open Cline settings → MCP Servers → Add Server manually:

LTL only:

{  "nexusfeed-ltl": {    "command": "uvx",    "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],    "env": {      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",      "MCP_API_KEY": "sk_live_your_key_here"    }  }}

ABC only:

{  "nexusfeed-abc": {    "command": "uvx",    "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],    "env": {      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",      "MCP_API_KEY": "sk_live_your_key_here"    }  }}

Streamable HTTP (Smithery / remote clients)

Pass your X-API-Key header on every request. Server metadata (no auth):

https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.jsonhttps://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json

Verifiability

Every tool response includes:

"_verifiability": {  "source_timestamp": "2026-04-05T09:00:00Z",  "extraction_confidence": 0.97,  "raw_data_evidence_url": "https://odfl.com/...",  "extraction_method": "api_mirror",  "data_freshness_ttl_seconds": 604800}

• extraction_confidence >= 0.90 is required before using data in compliance-critical decisions
• source_timestamp within data_freshness_ttl_seconds means data is fresh from cache
• raw_data_evidence_url is the canonical source — agents can independently verify

Example Usage

Audit an LTL freight invoice:

Use the freight_audit_workflow prompt with carrier="ODFL", invoice_date="2026-04-01",invoiced_fuel_surcharge_pct="23.5" to check whether the billed rate matches thepublished tariff.

Verify a liquor license before a distributor transaction:

Use abc_search_licenses with state="CA" and trade_name="Total Wine" to checkcurrent license status, then abc_lookup_license for the full record with suspension history.

Troubleshooting

License

Client code (this repository): MIT. See LICENSE.

NexusFeed backend service (https://api.nexusfeed.dev): commercial. The MIT license above covers only the Python client wrapper in this repo. It does not grant rights to the data service, which requires a paid API key and is governed by a separate Terms of Service. Contact [email protected] for enterprise SLA and licensing.