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(MCP)を介して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 を取得してください。フリーミアムプランも利用可能です(1日10リクエストまで無料)。

プロダクト

RapidAPIリスティング

LTL燃料サーチャージ

rapidapi.com/ladourv/api/ltl-fuel-surcharge-api

ABCライセンスコンプライアンス

rapidapi.com/ladourv/api/abc-license-compliance-api

インストール

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