Skip to main content
Glama
nexusfeed-mcp

nexusfeed-mcp

by NexusFeed

nexusfeed-mcp

PyPI version Python 3.12+ License: MIT

실시간 LTL 화물 유류 할증료 요율 및 미국 주별 ABC 주류 판매 면허 규정 준수 기록을 Model Context Protocol을 통해 AI 에이전트를 위한 정규화되고 검증 가능한 JSON 형태로 제공합니다.

데이터는 일반적인 LLM 브라우징으로는 접근이 어려운 운송업체 요금 페이지 및 주별 ABC 포털(JS 렌더링, CAPTCHA, 세션 상태 사용)에서 추출됩니다. 모든 응답에는 _verifiability 블록(추출 타임스탬프, 신뢰도 점수, 소스 URL)이 포함되어 있어 에이전트가 데이터를 사용하기 전에 품질을 평가할 수 있습니다.

도구

도구

설명

ltl_get_fuel_surcharge

ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt의 주간 유류 할증료 % — DOE 디젤 가격 및 최대 5년치 이력 제공

ltl_list_carriers

운송업체 커버리지 메타데이터 (SCAC 코드, 업데이트 일정, 추출 방식)

abc_search_licenses

상호, 소유자 또는 주소로 CA, TX, NY, FL 면허 데이터베이스 검색

abc_lookup_license

주에서 발행한 면허 번호를 통한 특정 시점의 면허 상태 조회

abc_list_states

주별 커버리지, 지연 시간 및 CAPTCHA 요구 사항

Related MCP server: us-legal-mcp

워크플로우 프롬프트

프롬프트

설명

freight_audit_workflow

게시된 운송업체 요금표와 대조하는 다단계 LTL 송장 감사

license_compliance_check

유통업체 주문, 보험 계약 또는 가맹점 온보딩 전 규정 준수 확인

API 액세스 권한 얻기

RapidAPI를 통해 구독하여 X-API-Key를 받으세요. 프리미엄 플랜이 제공됩니다(일일 10회 요청 무료).

설치

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 도구

https://api.nexusfeed.dev/mcp-ltl/

ABC 도구

https://api.nexusfeed.dev/mcp-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 오류

MCP_API_KEY가 설정되지 않았거나 유효하지 않음

"Could not reach API server"

MCP_API_BASE_URL이 설정되지 않음 — https://api.nexusfeed.dev여야 함

TX 엔드포인트에서 503 반환

TX TABC는 서버 측에서 2Captcha 구성이 필요함; 대신 CA, NY 또는 FL 사용

extraction_confidence < 0.90

데이터 품질 저하 — raw_data_evidence_url을 통해 독립적으로 검증

라이선스

클라이언트 코드 (본 저장소): MIT. LICENSE를 참조하세요.

NexusFeed 백엔드 서비스 (https://api.nexusfeed.dev): 상업용. 위의 MIT 라이선스는 이 저장소의 Python 클라이언트 래퍼에만 적용됩니다. 유료 API 키가 필요하며 별도의 서비스 약관이 적용되는 데이터 서비스에 대한 권한은 부여하지 않습니다. 기업용 SLA 및 라이선스 문의는 ops@nexusfeed.dev로 연락하십시오.

Available Tools

6 tools
abc_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

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers