nexusfeed-mcp
nexusfeed-mcp provides real-time LTL freight fuel surcharge data and US state ABC liquor license compliance records to AI agents via the Model Context Protocol.
LTL Freight Tools:
ltl_get_fuel_surcharge— Current weekly fuel surcharge percentages for major carriers (ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt), including the DOE diesel price that triggered each rate and up to 5 years of historyltl_list_carriers— Metadata for all supported LTL carriers: SCAC codes, available data products, update schedules, and extraction methodsltl_get_accessorials(coming soon) — Accessorial fee schedules (liftgate, residential delivery, re-delivery, etc.) — not yet available
ABC Liquor License Tools:
abc_search_licenses— Search CA, TX, NY, and FL ABC license databases by trade name, owner name, or address; returns license type, status (ACTIVE/SUSPENDED/EXPIRED/REVOKED), expiration date, and suspension historyabc_lookup_license— Point-in-time lookup of a specific license by state-issued license numberabc_list_states— State coverage metadata: agency name, data freshness SLA, extraction method, and CAPTCHA requirements
Key Features:
Every response includes a
_verifiabilityblock with extraction timestamp, confidence score, source URL, and freshness TTL for data quality assessmentExtracts data from JS-rendered pages, PDFs, and CAPTCHA-protected portals inaccessible to raw LLM browsing
Built-in workflow prompts:
freight_audit_workflowfor LTL invoice auditing andlicense_compliance_checkfor multi-state compliance verificationResponse times <500ms for cached data; freemium access with 10 requests/day free tier
Provides API access via RapidAPI subscriptions for LTL fuel surcharge and ABC license compliance data, enabling integration with external systems through RapidAPI marketplace listings.
nexusfeed-mcp
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 |
| Weekly fuel surcharge % for ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt — DOE diesel price and up to 5 years of history |
| Carrier coverage metadata (SCAC codes, update schedule, extraction method) |
| Search CA, TX, NY, FL license databases by trade name, owner, or address |
| Point-in-time license status by state-issued license number |
| State coverage, latency, and CAPTCHA requirements |
Related MCP server: us-legal-mcp
Workflow Prompts
Prompt | Description |
| Multi-step LTL invoice audit against published carrier tariffs |
| 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).
Product | RapidAPI Listing |
LTL Fuel Surcharge | |
ABC License Compliance |
Install
pip install nexusfeed-mcp
# or with uv/uvx (no install needed):
uvx nexusfeed-mcpConfigure
export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_hereRun (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-mcpClaude 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 |
|
ABC tools |
|
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.jsonVerifiability
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.90is required before using data in compliance-critical decisionssource_timestampwithindata_freshness_ttl_secondsmeans data is fresh from cacheraw_data_evidence_urlis 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 |
|
"Could not reach API server" |
|
TX endpoints return 503 | TX TABC requires 2Captcha configured server-side; use CA, NY, or FL instead |
| Data quality degraded — verify independently via |
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 toolsabc_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Sub-50ms verification for FMCSA USDOT/MC, CMS NPI, OFAC/OIG/SAM sanctions, and TCPA phone risk.
FMCSA carrier vetting API + MCP: authority, insurance, OOS. Keys $19/mo; 50 free calls/day.
Freight carrier intel: new FMCSA authority feed, carrier lookup by DOT/MC, safety screen (CSA/SMS).
Vet US motor carriers by USDOT or MC number: PASS/REVIEW/FAIL verdict, authority, insurance, OOS.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server using the AviationStack API to fetch real-time flight data, including airline flights, airport schedules, future flights and aircraft types.13134 PyPI28MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that provides comprehensive US legislation.16 npm38MIT
- AlicenseNot gradedqualityBmaintenanceProvides keyless access to US FMCSA motor-carrier registry data, enabling lookup of DOT/MC numbers, names, operating authority, and safety information.311 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides FMCSA motor-carrier risk intelligence over MCP, with tools for carrier lookup, risk scoring, and timestamped evidence reports for AI agents and freight brokers.MIT