Skip to main content
Glama

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

Tool

Description

ltl_get_fuel_surcharge

Weekly fuel surcharge % for ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt — DOE diesel price and up to 5 years of history

ltl_list_carriers

Carrier coverage metadata (SCAC codes, update schedule, extraction method)

abc_search_licenses

Search CA, TX, NY, FL license databases by trade name, owner, or address

abc_lookup_license

Point-in-time license status by state-issued license number

abc_list_states

State coverage, latency, and CAPTCHA requirements

Related MCP server: us-legal-mcp

Workflow Prompts

Prompt

Description

freight_audit_workflow

Multi-step LTL invoice audit against published carrier tariffs

license_compliance_check

Compliance verification before distributor orders, insurance binding, or merchant onboarding

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.dev
export MCP_API_KEY=sk_live_your_key_here

Run (stdio)

# LTL tools only — 3 tools, 1 prompt
nexusfeed-ltl

# ABC tools only — 3 tools, 1 prompt
nexusfeed-abc

# All tools — 5 tools, 2 prompts
nexusfeed-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)

Server

URL

LTL tools

https://api.nexusfeed.dev/mcp-ltl/

ABC tools

https://api.nexusfeed.dev/mcp-abc/

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

https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://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 the
published tariff.

Verify a liquor license before a distributor transaction:

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

Troubleshooting

Symptom

Fix

401 on every call

MCP_API_KEY is not set or is invalid

"Could not reach API server"

MCP_API_BASE_URL not set — should be https://api.nexusfeed.dev

TX endpoints return 503

TX TABC requires 2Captcha configured server-side; use CA, NY, or FL instead

extraction_confidence < 0.90

Data quality degraded — verify independently via raw_data_evidence_url

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 ops@nexusfeed.dev for enterprise SLA and licensing.

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Query 20 structured datasets from AI agents — healthcare providers (9M NPI records), SEC EDGAR filings, PACER federal courts, USPTO patents and trademarks, OFAC sanctions screening, crypto whale wallets, DeFi liquidation signals, Polymarket smart money, economic indicators (FRED/BLS), federal contracts, NOAA weather, and OTC shell risk scoring. Pay per query, no subscriptions
    Last updated
    75
    1
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    AI agent access to 11 freight calculation and reference tools — LDM, CBM, chargeable weight, pallet fitting, ADR dangerous goods (2,939 entries), airline codes (6,352), HS codes (6,940), INCOTERMS, container specs, unit converter, and ADR 1.1.3.6 exemption calculator.
    Last updated
    2
    24
    440
    4
    MIT

View all related MCP servers

Related MCP Connectors

  • US public-records intelligence for AI agents — companies, SEC, courts, spending, licenses.

  • Neutral freight reference + validation layer for AI agents: ADR, HS, UN/LOCODE, freight math

  • Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NexusFeed/nexusfeed-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server