nexusfeed-mcp
nexusfeed-mcp
实时 LTL(零担)货运燃油附加费费率和美国各州 ABC 酒类许可证合规记录——通过模型上下文协议(Model Context Protocol)为 AI 代理提供标准化、可验证的 JSON 数据。
数据从承运商费率页面和州 ABC 门户网站(涉及 JS 渲染、验证码、会话状态)中提取,这些页面对于原始 LLM 浏览来说在结构上是不可访问的。每个响应都包含一个 _verifiability 区块——包含提取时间戳、置信度分数和源 URL——以便代理在采取行动前评估数据质量。
工具
工具 | 描述 |
| ODFL、Saia、Estes、ABF、R+L、TForce、XPO、SEFL、Averitt 的每周燃油附加费百分比 — 包含 DOE 柴油价格及长达 5 年的历史数据 |
| 承运商覆盖范围元数据(SCAC 代码、更新计划、提取方法) |
| 按商号、所有者或地址搜索加利福尼亚州、德克萨斯州、纽约州、佛罗里达州的许可证数据库 |
| 按州颁发的许可证编号查询特定时间点的许可证状态 |
| 州覆盖范围、延迟和验证码要求 |
Related MCP server: us-legal-mcp
工作流提示词
提示词 | 描述 |
| 针对已发布承运商费率的多步骤 LTL 发票审计 |
| 在分销商订单、保险绑定或商户入驻前的合规性验证 |
获取 API 访问权限
通过 RapidAPI 订阅以获取您的 X-API-Key。提供免费增值计划(每天免费 10 次请求)。
产品 | RapidAPI 列表 |
LTL 燃油附加费 | |
ABC 许可证合规性 |
安装
pip install nexusfeed-mcp
# or with uv/uvx (no install needed):
uvx nexusfeed-mcp配置
export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_here运行 (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 配置
仅 LTL 燃油附加费:
{
"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 许可证合规性:
{
"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"
}
}
}
}所有工具:
{
"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) 配置
打开 Cline 设置 → MCP Servers → 手动添加服务器:
仅 LTL:
{
"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:
{
"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"
}
}
}可流式传输 HTTP (Smithery / 远程客户端)
服务器 | URL |
LTL 工具 |
|
ABC 工具 |
|
在每次请求时传递您的 X-API-Key 请求头。服务器元数据(无需认证):
https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json可验证性
每个工具响应都包含:
"_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.90source_timestamp在data_freshness_ttl_seconds范围内意味着数据是从缓存中获取的最新数据raw_data_evidence_url是权威来源 — 代理可以独立验证
使用示例
审计 LTL 货运发票:
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.在分销商交易前验证酒类许可证:
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.故障排除
症状 | 修复 |
每次调用返回 401 |
|
"Could not reach API server" |
|
TX 端点返回 503 | TX TABC 需要在服务器端配置 2Captcha;请改用 CA、NY 或 FL |
| 数据质量下降 — 通过 |
许可证
客户端代码(本仓库):MIT。 请参阅 LICENSE。
NexusFeed 后端服务 (https://api.nexusfeed.dev):商业用途。 上述 MIT 许可证仅涵盖本仓库中的 Python 客户端封装。它不授予对数据服务的使用权,该服务需要付费 API 密钥,并受单独的服务条款约束。如需企业级 SLA 和许可,请联系 ops@nexusfeed.dev。
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 and brokers on FMCSA data and get alerts when authority or insurance changes.
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.13212 PyPI28MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that provides comprehensive US legislation.34 npm38MIT
- AlicenseNot gradedqualityCmaintenanceProvides keyless access to US FMCSA motor-carrier registry data, enabling lookup of DOT/MC numbers, names, operating authority, and safety information.92 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