Skip to main content
Glama
nexusfeed-mcp

nexusfeed-mcp

by NexusFeed

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.

Available Tools

6 tools
abc_list_statesA

Returns metadata for all US states currently supported by the ABC License API, including the agency name, data freshness SLA, extraction method, and whether CAPTCHA is present. Use this first when building a multi-state compliance workflow to understand coverage.

Inputs: no named parameters. Returns: result

abc_lookup_licenseA

Looks up a specific liquor license by its state-issued license number and returns the full current record including status, expiration, address, conditions, and suspension history. Faster and more precise than abc_search_licenses when you already have the license number. Use this for point-in-time verification (e.g., 'Is license CA-20-621547 currently ACTIVE?'). The _verifiability block contains the exact source URL — agents can independently verify the result by fetching that URL.

Inputs: license_number (required), state (required). Returns: result

abc_search_licensesA

Searches a US state ABC (Alcoholic Beverage Control) board database for liquor licenses matching a business name, owner name, or address. Returns license type, current status (ACTIVE / SUSPENDED / EXPIRED / REVOKED), expiration date, and any suspension history. Use this before approving a distributor order, binding an insurance policy, or onboarding a merchant to verify they hold a valid liquor license. Supports CA, TX, NY, and FL (TX requires TWOCAPTCHA_API_KEY configured server-side; NY uses NY Open Data API — active licenses only; FL searches the DBPR licensing portal across all board types). Always check the _verifiability block: extraction_confidence >= 0.90 and source_timestamp within data_freshness_ttl_seconds are required for compliance decisions. Note: city, county, zip, and license_status filters are accepted but not yet applied server-side — results may need post-filtering.

Inputs: state (required), trade_name, owner_name, address, +5 more. Returns: result

ltl_get_accessorialsB

[COMING SOON] Returns the current accessorial fee schedule for LTL carriers — liftgate, residential delivery, re-delivery, inside delivery, limited access, notification, appointment fees, and more. This tool is not yet available and will return an unavailability message. Use ltl_get_fuel_surcharge for current carrier data.

Inputs: carriers, fee_types. Returns: result

ltl_get_fuel_surchargeA

Returns current LTL carrier fuel surcharge percentages and the DOE diesel price that triggered each rate. Data is extracted weekly from carrier tariff pages and cached — response time <500ms. Use this instead of browsing carrier websites: those pages are JS-rendered, PDFs, or require session state that makes raw browsing unreliable. Covers ODFL and SAIA (Sprint 1-2); Estes, ABF, R+L, TForce arriving in Sprint 4. Each response includes a _verifiability block with extraction timestamp and confidence score — check this before using the data in a freight cost calculation or invoice audit.

Inputs: carriers, weeks, include_doe_price. Returns: result

ltl_list_carriersA

Returns metadata for all LTL carriers supported by this API, including their SCAC code, which data products are available, fuel surcharge update day, and extraction method. Use this to discover coverage before building a carrier comparison workflow.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct domain and action: ABC tools handle license verification (list states, search by business, lookup by license number), while LTL tools cover carrier information (list carriers, fuel surcharge, accessorials). Clear descriptions prevent confusion.

    Naming Consistency5/5

    All tool names follow a consistent 'domain_verb_noun' pattern in snake_case (abc_list_states, ltl_get_fuel_surcharge). The naming is predictable and uniform across both domains.

    Tool Count4/5

    Six tools is a reasonable count for the two domains. However, one tool (ltl_get_accessorials) is non-functional (returns 'coming soon'), slightly reducing its value. Still, the count is appropriate for the scope.

    Completeness3/5

    The ABC domain is well-covered with list, search, and lookup operations. The LTL domain has a gap: accessorial fees are not yet available. Additionally, abc_search_licenses notes that some filters are not applied server-side, limiting its completeness.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers