FMCSA Carrier Intelligence

{
  "name": "FMCSA Carrier Intelligence",
  "description": "US motor carrier vetting from FMCSA data, for freight brokers, shippers and 3PLs: current authority, insurance (including pending cancellations), out-of-service and safety status with change history, plus identity-linkage checks that flag chameleon carriers re-registering under a new USDOT number. Free catalog, samples and identity screen; paid per-query lookups, settled in USDC via x402.",
  "supportedInterfaces": [
    {
      "url": "https://fmcsa-a2a-843680657471.us-central1.run.app",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "url": "https://kmcto.github.io/fmcsa-carrier-intelligence",
    "organization": "4SAKE Agent Co"
  },
  "version": "0.1.0+2f756da58032",
  "documentationUrl": "https://kmcto.github.io/fmcsa-carrier-intelligence/for-agents/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extensions": [
      {
        "uri": "https://a2a-registry.org/extensions/registry/v1",
        "description": "a2a-registry.org: owning GitHub account and payment capabilities.",
        "params": {
          "identity": {
            "packageName": "github.KMCTO.fmcsa_carrier_intelligence",
            "username": "KMCTO",
            "provider": "github"
          },
          "payment": {
            "model": "freemium",
            "protocols": [
              "x402"
            ],
            "rails": [
              {
                "token": "USDC",
                "protocol": "x402",
                "caip2": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "network": "solana",
                "type": "stablecoin",
                "contractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              }
            ],
            "direction": "inbound"
          }
        }
      },
      {
        "uri": "https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.1/spec.md",
        "description": "x402 payment extension for paid skills."
      }
    ]
  },
  "securitySchemes": {
    "x402-payment": {
      "apiKeySecurityScheme": {
        "description": "x402 v2 payment required for paid skills, via the PAYMENT-SIGNATURE header (legacy X-PAYMENT also accepted); the 402 challenge arrives in the PAYMENT-REQUIRED response header.",
        "location": "header",
        "name": "PAYMENT-SIGNATURE"
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {
        "x402-payment": {}
      }
    }
  ],
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "get_catalog",
      "name": "Get Catalog",
      "description": "Free. Dataset catalog: every field and its meaning, data freshness, prices, and the billing rule. Read this before paying for anything.",
      "tags": [
        "logistics",
        "fmcsa",
        "free"
      ],
      "examples": [
        "{\"tool\": \"get_catalog\", \"arguments\": {}}"
      ]
    },
    {
      "id": "get_sample",
      "name": "Get Sample",
      "description": "Free. Sample carrier profiles, to judge data quality before paying.",
      "tags": [
        "logistics",
        "fmcsa",
        "free"
      ],
      "examples": [
        "{\"tool\": \"get_sample\", \"arguments\": {}}"
      ]
    },
    {
      "id": "get_identity_sample",
      "name": "Get Identity Sample",
      "description": "Free. Sample identity-linkage results, to judge them before paying.",
      "tags": [
        "logistics",
        "fmcsa",
        "free",
        "identity"
      ],
      "examples": [
        "{\"tool\": \"get_identity_sample\", \"arguments\": {}}"
      ]
    },
    {
      "id": "lookup_carrier",
      "name": "Lookup Carrier",
      "description": "Paid: 0.01 USDC per call; you pay only when a call returns records; a miss is free. A carrier's current profile by USDOT number: carrier_status (every status, not just Active), operating authority, insurance filings on file, pending insurance cancellation, out-of-service orders, safety rating, revocations and suspensions. Carries no contact information. To check a carrier's claimed identity (e.g. against double brokering), pass claimed_name/claimed_street/claimed_city/claimed_state/claimed_zip and get match booleans, never the value on file.",
      "tags": [
        "logistics",
        "fmcsa",
        "compliance",
        "vetting"
      ],
      "examples": [
        "{\"tool\": \"lookup_carrier\", \"arguments\": {\"usdot_number\": 2122247}}"
      ]
    },
    {
      "id": "search_carriers",
      "name": "Search Carriers",
      "description": "Paid: 0.02 USDC per call; you pay only when a call returns records; a miss is free. Filter carriers by state, safety tier, authority status or cargo type; Active only unless include_inactive is true. Up to 100 rows per call. Carries no contact information.",
      "tags": [
        "logistics",
        "fmcsa",
        "compliance",
        "search"
      ],
      "examples": [
        "{\"tool\": \"search_carriers\", \"arguments\": {\"state\": \"TX\", \"limit\": 5}}"
      ]
    },
    {
      "id": "get_safety_history",
      "name": "Safety History",
      "description": "Paid: 0.015 USDC per call; you pay only when a call returns records; a miss is free. A carrier's snapshot history and its real changes over time (authority, insurance, out-of-service, ratings). Carries no contact information.",
      "tags": [
        "logistics",
        "fmcsa",
        "compliance",
        "history"
      ],
      "examples": [
        "{\"tool\": \"get_safety_history\", \"arguments\": {\"usdot_number\": 2122247}}"
      ]
    },
    {
      "id": "screen_carrier_identity",
      "name": "Screen Carrier Identity",
      "description": "Free. Quick chameleon-carrier screen: whether the carrier shares contact identifiers with other carriers under FMCSA's own published methodology (flag, match score, cluster size, how many linked carriers carry risk signals). A corroboration signal with a known false-positive rate, not a fraud finding.",
      "tags": [
        "logistics",
        "fmcsa",
        "free",
        "identity",
        "fraud"
      ],
      "examples": [
        "{\"tool\": \"screen_carrier_identity\", \"arguments\": {\"usdot_number\": 2336804}}"
      ]
    },
    {
      "id": "check_carrier_identity",
      "name": "Check Carrier Identity",
      "description": "Paid: 0.05 USDC per call; you pay only when a call returns records; a miss is free. Full identity-linkage assessment: score breakdown, which kinds of identifier matched, linked carriers' risk signals, and a cluster_id for tracking. Never names or points at any other carrier.",
      "tags": [
        "logistics",
        "fmcsa",
        "identity",
        "fraud",
        "vetting"
      ],
      "examples": [
        "{\"tool\": \"check_carrier_identity\", \"arguments\": {\"usdot_number\": 2336804}}"
      ]
    },
    {
      "id": "check_address_consistency",
      "name": "Check Address Consistency",
      "description": "Paid: 0.01 USDC per call; you pay only when a call returns records; a miss is free. Whether a carrier's business address and phone disagree across its FMCSA filings (counts of distinct variants, never the values).",
      "tags": [
        "logistics",
        "fmcsa",
        "identity",
        "fraud"
      ],
      "examples": [
        "{\"tool\": \"check_address_consistency\", \"arguments\": {\"usdot_number\": 2122247}}"
      ]
    },
    {
      "id": "confirm_identity_link",
      "name": "Confirm Identity Link",
      "description": "Paid: 0.08 USDC per call; you pay only when a call returns records; a miss is free. You name two USDOT numbers; returns whether they belong to the same identity cluster. Discloses nothing you didn't already supply.",
      "tags": [
        "logistics",
        "fmcsa",
        "identity",
        "fraud"
      ],
      "examples": [
        "{\"tool\": \"confirm_identity_link\", \"arguments\": {\"usdot_number_a\": 2336804, \"usdot_number_b\": 2916140}}"
      ]
    },
    {
      "id": "check_applicant_against_roster",
      "name": "Check Applicant Against Roster",
      "description": "Paid: 0.08 USDC + 0.01 USDC per roster entry (1 to 100 entries); you pay only when a call returns records; a miss is free. Screen a new carrier applicant against your own list of carriers, e.g. ones you've removed, to catch a carrier returning under a new USDOT number. Matches only ever come from your list.",
      "tags": [
        "logistics",
        "fmcsa",
        "identity",
        "fraud",
        "vetting"
      ],
      "examples": [
        "{\"tool\": \"check_applicant_against_roster\", \"arguments\": {\"usdot_number\": 2336804, \"roster_usdot_numbers\": [2916140, 2122247]}}"
      ]
    }
  ],
  "iconUrl": "https://kmcto.github.io/fmcsa-carrier-intelligence/icon.png"
}