nexusfeed-mcp 1.1.0

MCP server for NexusFeed — real-time B2B data (LTL fuel surcharges, ABC license compliance) for AI agents

nexusfeed-mcp — MCP Server

Real-time LTL freight fuel surcharge rates and state ABC liquor license compliance records for AI agents.

Data is extracted from carrier tariff pages and state ABC portals (JS-rendered, CAPTCHAs, session state) and served as normalized, cache-backed JSON with a mandatory _verifiability block — extraction timestamp, confidence score, and source URL on every response.

Tools

Tool	Description
ltl_get_fuel_surcharge	Weekly fuel surcharge % for ODFL, Saia, Estes, ABF, R+L, TForce — includes 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 expectations, and CAPTCHA requirements

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

Setup

Prerequisites

• Python 3.12+
• A NexusFeed API key (X-API-Key) — get one at api.nexusfeed.dev

Install

Install only the tools you need:

# LTL freight fuel surcharge tools only
pip install nexusfeed-mcp   # then run: nexusfeed-ltl

# ABC liquor license compliance tools only
pip install nexusfeed-mcp   # then run: nexusfeed-abc

# All tools (LTL + ABC)
pip install nexusfeed-mcp   # then run: nexusfeed-mcp

Configure

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

Run (stdio transport)

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

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

# All tools — 5 tools, 2 prompts
nexusfeed-mcp

Each command uses stdio transport — it reads from stdin and writes to stdout. Designed for use with Claude Desktop, Cursor, Cline, or any MCP-compatible client.

Streamable HTTP (Smithery / remote clients)

The NexusFeed production server also exposes the MCP endpoint over Streamable HTTP:

https://api.nexusfeed.dev/mcp

Connect any MCP-compatible HTTP client by pointing it at this URL with your X-API-Key header. For Smithery, this is the URL to enter at submission time.

Server metadata (no auth required):

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

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"
      }
    }
  }
}

Example Usage

Fuel surcharge for invoice audit:

Use ltl_get_fuel_surcharge with carriers=["ODFL"] and weeks=4 to get the last month of ODFL fuel surcharge rates.

License compliance check before a transaction:

Use abc_search_licenses with state="CA" and trade_name="Total Wine" to verify the license is currently ACTIVE.

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
}

Check extraction_confidence >= 0.90 and source_timestamp within data_freshness_ttl_seconds before using data in compliance-critical decisions.

Troubleshooting

401 errors on every call MCP_API_KEY is not set or is invalid. Confirm the env var is exported and matches a valid key from your NexusFeed account.

Connection refused / could not reach API server MCP_API_BASE_URL is wrong or not set. It should be https://api.nexusfeed.dev (no trailing slash).

TX TABC endpoints return 503 The API server does not have TWOCAPTCHA_API_KEY configured. TX endpoints require a 2Captcha account to solve image CAPTCHAs. CA, NY, and FL have no CAPTCHA requirement.

extraction_confidence below 0.90 in response Data quality is degraded — the extraction ran but some fields may be missing or stale. Do not use in compliance-critical decisions without verifying independently via the raw_data_evidence_url in the _verifiability block.

License

Commercial. Contact [e-mail] for enterprise SLA and licensing.