{
  "markdown": "# nexusfeed-mcp\n\n[![PyPI version](https://img.shields.io/pypi/v/nexusfeed-mcp)](https://pypi.org/project/nexusfeed-mcp/)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\nReal-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.\n\nData 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.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `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 |\n| `ltl_list_carriers` | Carrier coverage metadata (SCAC codes, update schedule, extraction method) |\n| `abc_search_licenses` | Search CA, TX, NY, FL license databases by trade name, owner, or address |\n| `abc_lookup_license` | Point-in-time license status by state-issued license number |\n| `abc_list_states` | State coverage, latency, and CAPTCHA requirements |\n\n## Workflow Prompts\n\n| Prompt | Description |\n|--------|-------------|\n| `freight_audit_workflow` | Multi-step LTL invoice audit against published carrier tariffs |\n| `license_compliance_check` | Compliance verification before distributor orders, insurance binding, or merchant onboarding |\n\n## Get API Access\n\nSubscribe via RapidAPI to receive your `X-API-Key`. Freemium plans available (10 req/day free).\n\n| Product | RapidAPI Listing |\n|---------|-----------------|\n| **LTL Fuel Surcharge** | [rapidapi.com/ladourv/api/ltl-fuel-surcharge-api](https://rapidapi.com/ladourv/api/ltl-fuel-surcharge-api) |\n| **ABC License Compliance** | [rapidapi.com/ladourv/api/abc-license-compliance-api](https://rapidapi.com/ladourv/api/abc-license-compliance-api) |\n\n## Install\n\n```bash\npip install nexusfeed-mcp\n# or with uv/uvx (no install needed):\nuvx nexusfeed-mcp\n```\n\n## Configure\n\n```bash\nexport MCP_API_BASE_URL=https://api.nexusfeed.dev\nexport MCP_API_KEY=sk_live_your_key_here\n```\n\n## Run (stdio)\n\n```bash\n# LTL tools only — 3 tools, 1 prompt\nnexusfeed-ltl\n\n# ABC tools only — 3 tools, 1 prompt\nnexusfeed-abc\n\n# All tools — 5 tools, 2 prompts\nnexusfeed-mcp\n```\n\n## Claude Desktop Configuration\n\n**LTL fuel surcharge only:**\n```json\n{\n  \"mcpServers\": {\n    \"nexusfeed-ltl\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"nexusfeed-mcp\", \"nexusfeed-ltl\"],\n      \"env\": {\n        \"MCP_API_BASE_URL\": \"https://api.nexusfeed.dev\",\n        \"MCP_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**ABC license compliance only:**\n```json\n{\n  \"mcpServers\": {\n    \"nexusfeed-abc\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"nexusfeed-mcp\", \"nexusfeed-abc\"],\n      \"env\": {\n        \"MCP_API_BASE_URL\": \"https://api.nexusfeed.dev\",\n        \"MCP_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**All tools:**\n```json\n{\n  \"mcpServers\": {\n    \"nexusfeed-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nexusfeed-mcp\"],\n      \"env\": {\n        \"MCP_API_BASE_URL\": \"https://api.nexusfeed.dev\",\n        \"MCP_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Cline (VS Code) Configuration\n\nOpen Cline settings → MCP Servers → Add Server manually:\n\n**LTL only:**\n```json\n{\n  \"nexusfeed-ltl\": {\n    \"command\": \"uvx\",\n    \"args\": [\"--from\", \"nexusfeed-mcp\", \"nexusfeed-ltl\"],\n    \"env\": {\n      \"MCP_API_BASE_URL\": \"https://api.nexusfeed.dev\",\n      \"MCP_API_KEY\": \"sk_live_your_key_here\"\n    }\n  }\n}\n```\n\n**ABC only:**\n```json\n{\n  \"nexusfeed-abc\": {\n    \"command\": \"uvx\",\n    \"args\": [\"--from\", \"nexusfeed-mcp\", \"nexusfeed-abc\"],\n    \"env\": {\n      \"MCP_API_BASE_URL\": \"https://api.nexusfeed.dev\",\n      \"MCP_API_KEY\": \"sk_live_your_key_here\"\n    }\n  }\n}\n```\n\n## Streamable HTTP (Smithery / remote clients)\n\n| Server | URL |\n|--------|-----|\n| LTL tools | `https://api.nexusfeed.dev/mcp-ltl/` |\n| ABC tools | `https://api.nexusfeed.dev/mcp-abc/` |\n\nPass your `X-API-Key` header on every request. Server metadata (no auth):\n```\nhttps://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json\nhttps://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json\n```\n\n## Verifiability\n\nEvery tool response includes:\n\n```json\n\"_verifiability\": {\n  \"source_timestamp\": \"2026-04-05T09:00:00Z\",\n  \"extraction_confidence\": 0.97,\n  \"raw_data_evidence_url\": \"https://odfl.com/...\",\n  \"extraction_method\": \"api_mirror\",\n  \"data_freshness_ttl_seconds\": 604800\n}\n```\n\n- `extraction_confidence >= 0.90` is required before using data in compliance-critical decisions\n- `source_timestamp` within `data_freshness_ttl_seconds` means data is fresh from cache\n- `raw_data_evidence_url` is the canonical source — agents can independently verify\n\n## Example Usage\n\n**Audit an LTL freight invoice:**\n```\nUse the freight_audit_workflow prompt with carrier=\"ODFL\", invoice_date=\"2026-04-01\",\ninvoiced_fuel_surcharge_pct=\"23.5\" to check whether the billed rate matches the\npublished tariff.\n```\n\n**Verify a liquor license before a distributor transaction:**\n```\nUse abc_search_licenses with state=\"CA\" and trade_name=\"Total Wine\" to check\ncurrent license status, then abc_lookup_license for the full record with suspension history.\n```\n\n## Troubleshooting\n\n| Symptom | Fix |\n|---------|-----|\n| 401 on every call | `MCP_API_KEY` is not set or is invalid |\n| \"Could not reach API server\" | `MCP_API_BASE_URL` not set — should be `https://api.nexusfeed.dev` |\n| TX endpoints return 503 | TX TABC requires 2Captcha configured server-side; use CA, NY, or FL instead |\n| `extraction_confidence` < 0.90 | Data quality degraded — verify independently via `raw_data_evidence_url` |\n\n## License\n\n**Client code (this repository): MIT.** See [LICENSE](LICENSE).\n\n**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](mailto:ops@nexusfeed.dev) for enterprise SLA and licensing.\n\n<!-- mcp-name: io.github.NexusFeed/nexusfeed-ltl -->\n<!-- mcp-name: io.github.NexusFeed/nexusfeed-abc -->\n",
  "bytes": 6495,
  "sha": "bac29324000c38eb64896aba3cbf50af18eca0afad26a6518ca93f0ca628844f",
  "repo_slug": "nexusfeed/nexusfeed-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nexusfeed_nexusfeed_ltl_a1b7c1ac/readme"
}