nexusfeed-mcp
nexusfeed-mcp
실시간 LTL 화물 유류 할증료 요율 및 미국 주별 ABC 주류 판매 면허 규정 준수 기록을 Model Context Protocol을 통해 AI 에이전트를 위한 정규화되고 검증 가능한 JSON 형태로 제공합니다.
데이터는 일반적인 LLM 브라우징으로는 접근이 어려운 운송업체 요금 페이지 및 주별 ABC 포털(JS 렌더링, CAPTCHA, 세션 상태 사용)에서 추출됩니다. 모든 응답에는 _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
워크플로우 프롬프트
프롬프트 | 설명 |
| 게시된 운송업체 요금표와 대조하는 다단계 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 → 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이 필요합니다.data_freshness_ttl_seconds내의source_timestamp는 데이터가 캐시에서 최신 상태임을 의미합니다.raw_data_evidence_url은 표준 소스이며, 에이전트가 독립적으로 검증할 수 있습니다.
사용 예시
LTL 화물 송장 감사:
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.유통업체 거래 전 주류 판매 면허 확인:
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