nexusfeed-mcp
nexusfeed-mcp
Актуальные ставки топливных надбавок для LTL-перевозок и записи о соответствии лицензий на алкоголь ABC в штатах США — предоставляются в виде нормализованного, верифицируемого JSON для ИИ-агентов через протокол Model Context Protocol.
Данные извлекаются со страниц тарифов перевозчиков и порталов ABC штатов (с использованием JS-рендеринга, обхода CAPTCHA и сессионных состояний), которые структурно недоступны для обычного парсинга LLM. Каждый ответ включает блок _verifiability — временную метку извлечения, показатель достоверности и исходный URL — чтобы агенты могли оценить качество данных перед принятием решений.
Инструменты
Инструмент | Описание |
| Еженедельный % топливной надбавки для ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt — цена на дизельное топливо DOE и история до 5 лет |
| Метаданные покрытия перевозчиков (коды SCAC, график обновлений, метод извлечения) |
| Поиск в базах данных лицензий CA, TX, NY, FL по торговому наименованию, владельцу или адресу |
| Статус лицензии на определенный момент времени по номеру лицензии, выданному штатом |
| Покрытие штатов, задержки и требования к CAPTCHA |
Related MCP server: us-legal-mcp
Рабочие сценарии (Workflow Prompts)
Промпт | Описание |
| Многоэтапный аудит счетов LTL-перевозок на соответствие опубликованным тарифам перевозчиков |
| Проверка соответствия требованиям перед заказом у дистрибьютора, оформлением страховки или регистрацией продавца |
Получение доступа к API
Подпишитесь через RapidAPI, чтобы получить ваш X-API-Key. Доступны Freemium-планы (10 запросов в день бесплатно).
Продукт | Страница на RapidAPI |
LTL Fuel Surcharge | |
ABC License Compliance |
Установка
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-mcpКонфигурация Claude 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 → Add Server manually:
Только 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.90требуется перед использованием данных в критически важных для комплаенса решенияхsource_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-ключа и регулируется отдельными Условиями использования (Terms of Service). Свяжитесь с ops@nexusfeed.dev для получения корпоративного SLA и лицензирования.
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