{
  "schema": "https://googleapis.github.io/A2A/specification/",
  "schemaVersion": "0.2.9",
  "name": "Fonteum — Multi-vertical public-records MCP",
  "description": "Fonteum is a multi-vertical public-records platform spanning healthcare, federal procurement, sanctions and watchlists, federal enforcement, intellectual property, securities filings, and global open-data corporate registers. Source, observation-date, provenance, and retained-history fields are nullable and source-specific. Snapshot digests do not create deterministic fact-to-signature links. Dated platform coverage is available from the live platform-stats endpoint; integrated registry status does not establish loaded, fresh, displayable, or complete coverage. Public records only: no PHI, no consumer-reporting dossiers, and no risk scores or labels.",
  "url": "https://fonteum.com/api/mcp",
  "documentationUrl": "https://fonteum.com/api",
  "provider": {
    "organization": "Fonteum LLC",
    "url": "https://fonteum.com",
    "email": "api@fonteum.com"
  },
  "version": "1.1.0",
  "mcp": {
    "package": "@fonteum/mcp",
    "version": "1.1.0",
    "package_version": "0.5.0",
    "package_status": "source-only; pending operator publication; npm currently serves 0.4.0",
    "package_rest_base": "https://fonteum.com/api",
    "endpoint": "https://fonteum.com/api/mcp",
    "discovery": "https://fonteum.com/.well-known/mcp.json",
    "auth": {
      "type": "apiKey",
      "header": "x-fonteum-mcp-key",
      "optional": true,
      "description": "Fonteum may separately issue a hosted transport key. Anonymous hosted MCP access is rate-limited; do not substitute a pre-release sample header or key."
    },
    "tools": [
      "fonteum_lookup_npi",
      "fonteum_lookup_contractor",
      "fonteum_search_providers",
      "fonteum_check_exclusion",
      "fonteum_search_sanctions",
      "fonteum_lookup_contractor_history",
      "fonteum_recheck_snapshot",
      "fonteum_list_sources",
      "fonteum_get_dataset_info"
    ],
    "output_contract": {
      "format": "JSON text plus matching MCP structuredContent",
      "always_present": ["source_file", "as_of_date", "snapshot_digest", "verifiable_url"],
      "nullable": ["source_file", "as_of_date", "snapshot_digest"]
    }
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "fonteum_lookup_npi",
      "name": "fonteum_lookup_npi",
      "description": "Look up a US healthcare provider by 10-digit NPI in CMS NPPES and return the available provider record plus exclusion and program-integrity context. Returns dated source context; source_file and snapshot_digest are nullable when no single retained snapshot represents the response. Use for NPI lookup, provider identity, taxonomy, practice-location, or provider due-diligence questions.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_lookup_contractor",
      "name": "fonteum_lookup_contractor",
      "description": "Look up a US federal contractor by UEI or CAGE in available SAM.gov, USASpending, FAPIIS, and FAR 4.18 records. Returns dated source context; source_file and snapshot_digest are nullable when no single retained snapshot represents the response. Use for contractor identity, registration, award, responsibility, or ownership due diligence.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_search_providers",
      "name": "fonteum_search_providers",
      "description": "Search US healthcare providers in loaded CMS NPPES specialty caches by vertical and state, with optional county context. Returns dated source context and up to 100 records; source_file and snapshot_digest may be null. Use for provider discovery by specialty and geography.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_check_exclusion",
      "name": "fonteum_check_exclusion",
      "description": "Check whether a US healthcare provider by NPI appears in available exclusion or integrity sources: OIG LEIE, SAM.gov exclusions, available state Medicaid lists, OIG Corporate Integrity Agreements, and CMS Civil Money Penalties. Returns dated source context and fail-closed coverage; source_file and snapshot_digest may be null for the multi-source result. Use for exclusion screening, provider or vendor due diligence, or any ‘is this NPI excluded?’ question.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_search_sanctions",
      "name": "fonteum_search_sanctions",
      "description": "Search a person or organization name across available sanctions and watchlist data from OFAC, the EU, the UK, and the UN, plus named exclusion sources held by Fonteum. Returns dated matches with source context; source_file and snapshot_digest may be null for the multi-source result. Use for sanctions screening, entity due diligence, or any ‘is this entity sanctioned?’ question.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_lookup_contractor_history",
      "name": "fonteum_lookup_contractor_history",
      "description": "Look up a US federal contractor record as of a requested date using UEI or CAGE. Retained history is currently limited to USASpending award rows; other fields may be current, absent, or nullable. Returns dated source context. Use for historical award research or contractor change questions.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_recheck_snapshot",
      "name": "fonteum_recheck_snapshot",
      "description": "Recheck a Fonteum snapshot by snapshot id and return its as_of_date, snapshot_digest, public verifiable_url, and source_file only when explicit retained-artifact metadata is available. Without an id, returns chain status without treating the chain head as a snapshot digest. Use for snapshot integrity checks, citation support, or reproducing a retained source file.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_list_sources",
      "name": "fonteum_list_sources",
      "description": "List Fonteum’s public-record source catalog with available authority, vertical, cadence, official URL, and separately dated platform coverage. Catalog presence does not prove loaded, fresh, or complete coverage. Use for source discovery, coverage questions, or choosing a dataset before a lookup.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "fonteum_get_dataset_info",
      "name": "fonteum_get_dataset_info",
      "description": "Get Fonteum API and MCP methodology, provenance-field definitions, generated source catalog, and separately dated platform coverage. Field population varies by source and response. Use for interpreting Fonteum outputs, citation fields, dataset limitations, or integration planning.",
      "endpointUrl": "https://fonteum.com/api/mcp",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    }
  ],
  "authentication": {
    "scheme": "optional",
    "note": "Hosted MCP permits anonymous, rate-limited access. For REST routes that require credentials, use an issued key: Authorization: Bearer $FONTEUM_API_KEY. Follow the hosted MCP discovery document for the optional transport-key details."
  },
  "platformCoverage": null,
  "dataProvenance": {
    "methodologyUrl": "https://fonteum.com/methodology",
    "sourceContext": "nullable source, observation date, coverage, and limitation metadata; population varies by source and result",
    "citationGuidance": "Include only source, observation-date, coverage, and limitation values actually returned; do not infer absent metadata or a signature relationship.",
    "signatureScope": "A snapshot digest covers only its identified snapshot object and does not sign individual facts.",
    "reuseTerms": "reuse terms are source-specific; inspect the returned source metadata and upstream terms."
  },
  "tags": [
    "public-records",
    "healthcare",
    "federal-procurement",
    "sanctions",
    "federal-enforcement",
    "intellectual-property",
    "securities",
    "global-company-registers"
  ]
}