Server definition

Hash: sha256:650ce3f219f5e30f23ca63180f4d19232ebf926bcf5d233281be920042804ab5
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "FMCSA carrier safety and authority data. Call get_catalog first to see what's available and current pricing, and get_sample to evaluate data quality before paying for lookup_carrier, search_carriers, or get_safety_history.",
  "tools": [
    {
      "description": "How many distinct business addresses and phones this carrier\nreports across FMCSA's independent records of it (census\nregistration, licensing and insurance filings, and its own\nself-reported crash records). Mailing addresses are excluded —\ndiffering from the physical address there is normal.\n\nPaid. Cheaper than either identity tool; one row, no graph.\n",
      "inputSchema": {
        "properties": {
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number"
        ],
        "title": "check_address_consistencyArguments",
        "type": "object"
      },
      "name": "check_address_consistency",
      "outputSchema": null
    },
    {
      "description": "Screens one applicant carrier against a roster of carriers you\nalready do business with (or are vetting) — the batch generalization\nof confirm_identity_link, for the real-world case of catching a\ncarrier that was previously cut from your network (revoked,\nsuspended, or otherwise let go) trying to re-enter under a new USDOT\nnumber. usdot_number is the applicant; roster_usdot_numbers is your\nown list, supplied by you.\n\nReturns linked (true if the applicant shares an identity cluster with\nANY roster member) and matched_roster_usdot_numbers (which ones,\nalways a subset of what you supplied — never a carrier you didn't\nalready name). roster_not_found lists any roster entries that simply\ndon't resolve to a known carrier (still your own input, not a new\ndisclosure). usdot_number's own cluster_id is always included, same\nas check_carrier_identity's convention — it's the applicant's own\ndata, not something withheld pending a match.\n\nusdot_number must not also appear in roster_usdot_numbers, and\nroster_usdot_numbers must be a non-empty list of at most\nsettings.roster_screen_max_size distinct entries (currently 100) —\neither violation is a free invalid_arguments; split a larger roster\ninto multiple calls rather than expecting it to be truncated for you.\nAn unresolved usdot_number (the applicant itself) is a free not_found,\nsame as confirm_identity_link/check_carrier_identity.\n\nPaid, metered: price = price_check_applicant_against_roster_base +\nprice_check_applicant_against_roster_per_entry * (the deduped roster\nsize) — see get_catalog for current rates. A \"not linked to anything\non your roster\" result is a complete, valuable answer and bills the\nsame as a match, same reasoning as check_carrier_identity's\ncluster_size == 1.\n",
      "inputSchema": {
        "properties": {
          "roster_usdot_numbers": {
            "items": {
              "type": "integer"
            },
            "title": "Roster Usdot Numbers",
            "type": "array"
          },
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number",
          "roster_usdot_numbers"
        ],
        "title": "check_applicant_against_rosterArguments",
        "type": "object"
      },
      "name": "check_applicant_against_roster",
      "outputSchema": null
    },
    {
      "description": "Full identity-linkage detail for a carrier: why it's flagged and how\nconfident that is. Priced meaningfully above the free\nscreen_carrier_identity — call that first if you only need the flag\nand a count.\n\nNever names or points at another carrier (redesigned 2026-09-18 — see\nschemas.IdentityAssessment's docstring): no linked USDOT number, legal\nname, or shared-identifier hash. A linked carrier's own identity was\nnever this caller's to receive, and an unsalted hash of a low-entropy\nvalue like a phone number or address doesn't meaningfully withhold it\nfrom a determined party anyway (confirmed by reading Truckin's own\nhashing code). Every field here is either the subject carrier's own\ndata or a derivative signal — a score, a match-term-type label\n(which *kind* of identifier matched, never the value), a count, a\nboolean.\n\nSSN and EIN matches carry weight 2.0 each in FMCSA's ARCHI methodology\nand are not present in public data; D&B is nominally weight 2.0 too\nbut is only genuinely available for ~4% of carriers, and officer data\n(needed for the name x officer term) is missing for another ~15%. So\nscore_provenance.match_score_ceiling is computed per carrier, not a\nflat 4.5 — most responses cap out at 2.5 or lower. It also states\nplainly that recall against FMCSA's own declared-predecessor label\nset is not measurable. flagged applies FMCSA's own ARCHI flag rule\n(match_score >= 1.5 AND a linked motive >= 1); it is not a fraud\ndetermination and must not be presented as one. Note flagged and\nmatch_score >= 1.5 are NOT the same condition — clustering requires\n2+ independent identifier-type families to agree, so materially more\ncarriers clear the score threshold than are ever flagged.\n\nPaid. A carrier with no linked carriers is a complete answer and\nbills; an unknown USDOT number is a free not_found.\n",
      "inputSchema": {
        "properties": {
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number"
        ],
        "title": "check_carrier_identityArguments",
        "type": "object"
      },
      "name": "check_carrier_identity",
      "outputSchema": null
    },
    {
      "description": "Confirms or denies that two carriers YOU ALREADY SUSPECT are linked\nin fact share an identity cluster — the lower-risk alternative to\ncheck_carrier_identity's removed linked_carriers field (see\nschemas.IdentityAssessment's docstring for why that was removed\n2026-09-18).\n\nThis never discloses a carrier's identity to a caller who didn't\nalready have it: both usdot_number_a and usdot_number_b are supplied\nby you. It only ever answers \"do these two specific carriers share a\ncluster?\", never \"who is linked to this carrier?\" — call\ncheck_carrier_identity for that, which stops at a score and a count\nfor exactly this reason. cluster_id is returned only when linked is\ntrue, and isn't new information even then — you could obtain the same\nvalue directly from either carrier's own check_carrier_identity or\nscreen_carrier_identity response.\n\nusdot_number_a and usdot_number_b must differ (invalid_arguments,\nfree — there is no comparison to make). Either number failing to\nresolve in carrier_identity_cluster is a free not_found, same as\ncheck_carrier_identity.\n\nPaid — pricier than check_carrier_identity, since it resolves two\ncarriers' clusters per call, not one. A \"not linked\" result is a\ncomplete, valuable answer and bills the same as \"linked\", same\nreasoning as check_carrier_identity's cluster_size == 1.\n",
      "inputSchema": {
        "properties": {
          "usdot_number_a": {
            "title": "Usdot Number A",
            "type": "integer"
          },
          "usdot_number_b": {
            "title": "Usdot Number B",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number_a",
          "usdot_number_b"
        ],
        "title": "confirm_identity_linkArguments",
        "type": "object"
      },
      "name": "confirm_identity_link",
      "outputSchema": null
    },
    {
      "description": "Free, unauthenticated dataset catalog.\n\nDescribes every table this service sells, its fields, current pricing,\nand freshness. Read this before paying for anything.\n",
      "inputSchema": {
        "properties": {},
        "title": "get_catalogArguments",
        "type": "object"
      },
      "name": "get_catalog",
      "outputSchema": null
    },
    {
      "description": "Free, unauthenticated sample of identity/fraud responses, covering\nboth screen_carrier_identity's free IdentityScreen shape and\ncheck_carrier_identity's paid IdentityAssessment shape.\n\nLets a buying agent see the paid response shape and evaluate data\nquality before spending USDC on check_carrier_identity.\n",
      "inputSchema": {
        "properties": {},
        "title": "get_identity_sampleArguments",
        "type": "object"
      },
      "name": "get_identity_sample",
      "outputSchema": null
    },
    {
      "description": "Historical snapshots and changelog entries for a carrier. Paid —\nyou pay only when a call returns records; an exact-key miss is free.\n\nchangelog may legitimately be empty for a carrier without two\ndistinct-date snapshots yet — a diff needs both. authority_types,\noos_orders_active, insurance_bipd_on_file, insurance_cargo_on_file,\ninsurance_bond_on_file, has_been_revoked, and last_revocation_date are\nnull (not false/empty) on a history row recorded before 2026-09-02 —\ncarrier_history wasn't tracking those fields yet, so null there means\n\"not tracked on this date,\" not a negative answer. Likewise\nhas_been_suspended/last_suspension_date are null before 2026-09-06,\nand has_authority_reinstated/last_reinstatement_date/\nhas_insurance_identity_mismatch are null before 2026-09-12. Carries no\ncontact information (legal_name, dba_name, addresses, phone, email —\nremoved 2026-09-19, see schemas.CarrierProfile); changelog excludes\nfield_name in {legal_name, dba_name, phone, email} for the same reason\n— a changed value is still the value.\n",
      "inputSchema": {
        "properties": {
          "since_date": {
            "anyOf": [
              {
                "format": "date",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Since Date"
          },
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number"
        ],
        "title": "get_safety_historyArguments",
        "type": "object"
      },
      "name": "get_safety_history",
      "outputSchema": null
    },
    {
      "description": "Free, unauthenticated sample of carrier_profile rows.\n\nLets a buying agent evaluate data quality before spending USDC on the\npaid tools.\n",
      "inputSchema": {
        "properties": {},
        "title": "get_sampleArguments",
        "type": "object"
      },
      "name": "get_sample",
      "outputSchema": null
    },
    {
      "description": "Look up a single carrier's current profile by USDOT number. Paid —\nyou pay only when a call returns records; an exact-key miss is free.\n\nReturns every carrier_status (Active, Inactive, Pending) — check the\ncarrier_status field, don't assume Active.\n\nCarries no contact information (legal_name, dba_name, addresses,\nphone, email — removed 2026-09-19, see schemas.CarrierProfile). The one\nlegitimate use those fields served — confirming a carrier's claimed\nidentity against records, e.g. to catch a carrier-identity-theft\n(\"double brokering\") attempt — is available instead via claimed_name\n(matched against legal_name OR dba_name) and claimed_street/\nclaimed_city/claimed_state/claimed_zip (matched against\nphysical_address; supply any subset). Returns name_match/\nphysical_address_match as a boolean per claim actually supplied, `null`\nfor a claim not supplied — never the value on file itself.\n",
      "inputSchema": {
        "properties": {
          "claimed_city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Claimed City"
          },
          "claimed_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Claimed Name"
          },
          "claimed_state": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Claimed State"
          },
          "claimed_street": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Claimed Street"
          },
          "claimed_zip": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Claimed Zip"
          },
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number"
        ],
        "title": "lookup_carrierArguments",
        "type": "object"
      },
      "name": "lookup_carrier",
      "outputSchema": null
    },
    {
      "description": "Free triage screen for a carrier: whether it's flagged under FMCSA's\nown chameleon-carrier methodology, how big its identity cluster is,\nand how many linked carriers carry a motive — with no member detail.\nCall check_carrier_identity (paid) for that.\n\nThis is the entire discovery/sales motion in an agent-only channel,\nnot a discount tier — free by design (Identity-API-Revision-\n2026-09-06.md Section 1), so it never bills and never requires\npayment. By the same design, it withholds anything that identifies a\nlinked carrier: no member USDOT number, no legal name, no link type,\nno identifier hash. A caller learns THAT there is something to look\nat here, not WHAT.\n\nconfidence_caveat discloses the known ~6% artifact rate and that\nrecall is not measurable in FMCSA's public data — read it, don't just\ncheck the flagged boolean. match_score_practical_ceiling is computed\nper carrier from which ARCHI terms were actually available for it,\nnot a flat constant — most carriers cap out well below the\ntheoretical 8.5.\n\nAn unknown USDOT number returns a not_found error.\n",
      "inputSchema": {
        "properties": {
          "usdot_number": {
            "title": "Usdot Number",
            "type": "integer"
          }
        },
        "required": [
          "usdot_number"
        ],
        "title": "screen_carrier_identityArguments",
        "type": "object"
      },
      "name": "screen_carrier_identity",
      "outputSchema": null
    },
    {
      "description": "Filtered carrier search. Paid — you pay only when a call returns\nrecords; a zero-row result is free, same as an exact-key miss.\n\nDefaults to Active carriers only — pass include_inactive=true to also\nsee Inactive/Pending. Capped at 100 rows per response regardless of the\nrequested limit; never a full-table dump. Carries no contact\ninformation (legal_name, dba_name, addresses, phone, email — removed\n2026-09-19, see schemas.CarrierProfile) — a filterable, multi-result\nendpoint returning personal contact details for whoever matched a\nfilter was the sharpest version of that risk in this product; use\nlookup_carrier's claimed_name/claimed_street/etc. if you need to\nconfirm a specific carrier's claimed identity.\n",
      "inputSchema": {
        "properties": {
          "authority_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Authority Status"
          },
          "cargo_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Cargo Type"
          },
          "include_inactive": {
            "default": false,
            "title": "Include Inactive",
            "type": "boolean"
          },
          "limit": {
            "default": 20,
            "title": "Limit",
            "type": "integer"
          },
          "safety_tier": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Safety Tier"
          },
          "state": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "State"
          }
        },
        "title": "search_carriersArguments",
        "type": "object"
      },
      "name": "search_carriers",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:650ce3f219f5e30f23ca63180f4d19232ebf926bcf5d233281be920042804ab5 | sha256sum