Server definition

Hash: sha256:bc36ddd5f0d782a519e0b027f3bd2434d86150a4bd7d0d04e454f5362ea6657f
What it is: What a remote MCP server returned when asked what it offers: 12 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "Compare up to 25 certified skilled nursing facilities by CMS CCN or web slug. Returns the same decision fields as search_facilities (ratings, nurse hours, turnover, inspection score, beds, fines, maps) as a table. Prefer this over looping get_facility against the 60 requests/minute limit.",
      "inputSchema": {
        "properties": {
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "ids": {
            "description": "CMS CCNs (provnum) or web slugs. Max 25.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "name": "compare_facilities",
      "outputSchema": null
    },
    {
      "description": "Get latest source dataset dates and row counts. For prior months, call list_file_dates and pass filedate to other tools.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_data_freshness",
      "outputSchema": null
    },
    {
      "description": "Get one certified skilled nursing facility by CMS CCN (provnum) or web slug. Returns the same decision fields as search_facilities: ratings, nurse hours (HPRD), nurse/RN turnover, weighted inspection score, beds, fines, abuse/SFF flags, and maps deep-links. Use data_as_of as the CMS vintage; do not invent ratings or hours that are missing. Defaults to the latest monthly snapshot; pass filedate from list_file_dates for a prior month.",
      "inputSchema": {
        "properties": {
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_facility",
      "outputSchema": null
    },
    {
      "description": "Monitor one skilled nursing facility across two CMS monthly files. Defaults to latest vs the prior snapshot. Returns field-level diffs for stars, nurse hours, turnover, inspection score, abuse icon, fines, and occupancy. Care Compare shows this month only — rerun after the next file.",
      "inputSchema": {
        "properties": {
          "from": {
            "description": "Earlier filedate YYYY-MM-DD. Omit to use the snapshot before to.",
            "type": "string"
          },
          "id": {
            "description": "CMS CCN (provnum) or web slug",
            "type": "string"
          },
          "to": {
            "description": "Later filedate. Omit to use the latest CMS file.",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_facility_changes",
      "outputSchema": null
    },
    {
      "description": "Get CMS ownership records for one facility — who owns or manages the building. Defaults to the latest CMS monthly snapshot; pass filedate from list_file_dates to query a prior month.",
      "inputSchema": {
        "properties": {
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_facility_ownership",
      "outputSchema": null
    },
    {
      "description": "Get an owner portfolio by web_owner slug, including facility names, locations, and overall stars. Defaults to the latest CMS monthly snapshot; pass filedate from list_file_dates to query a prior month.",
      "inputSchema": {
        "properties": {
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "web_owner": {
            "type": "string"
          }
        },
        "required": [
          "web_owner"
        ],
        "type": "object"
      },
      "name": "get_owner",
      "outputSchema": null
    },
    {
      "description": "List distinct CMS ProviderInfo values and counts for a field. Omit field to see the catalog. Use field=ownership before search_facilities to get the 13 ownership types. city requires state.",
      "inputSchema": {
        "properties": {
          "field": {
            "description": "ProviderInfo field. Omit to list allowed fields. ownership is the search_facilities filter.",
            "enum": [
              "ownership",
              "state",
              "city",
              "sffstatus",
              "abuse_icon",
              "certification",
              "inhosp",
              "ccrc_facil",
              "overall_rating",
              "survey_rating",
              "quality_rating",
              "staffing_rating",
              "oldsurvey",
              "chow_last_12mos",
              "chainname",
              "chain_name",
              "chainid",
              "chain_id"
            ],
            "type": "string"
          },
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "state": {
            "description": "Optional two-letter state. Required when field=city.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_distinct_values",
      "outputSchema": null
    },
    {
      "description": "List CMS monthly snapshot dates available in the database (newest first), plus the current filedate and known unpublished months. Use a returned date as filedate on other tools to retrieve a prior month instead of the latest data.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_file_dates",
      "outputSchema": null
    },
    {
      "description": "Find certified US skilled nursing facilities near an address or in a city. Filter by CMS ownership type (call list_distinct_values field=ownership first), star rating, abuse flag, or Special Focus status. Returns ownership, ratings, nurse hours (HPRD), nurse/RN turnover, weighted inspection score, beds, fines, straight-line distance_miles, and maps deep-links. distance_miles is crow-flies, not drive time — use maps.google_dir / a mapping service for minutes.",
      "inputSchema": {
        "properties": {
          "abuse_icon": {
            "description": "CMS abuse icon filter. Y/yes/true/1 keeps only flagged homes; other values keep homes without the flag.",
            "type": "string"
          },
          "address": {
            "description": "Street address with city and state, or a street and ZIP. Geocoded by the Census Bureau as the distance origin. A city, place name, or ZIP alone will not match.",
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "limit": {
            "type": "integer"
          },
          "max_overall_rating": {
            "description": "Maximum CMS overall star rating (1-5).",
            "type": "integer"
          },
          "min_overall_rating": {
            "description": "Minimum CMS overall star rating (1-5).",
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "ownership": {
            "description": "CMS ownership type from ProviderInfo.ownership. Case-insensitive. Prefixes For profit, Non profit, and Government match that kind. Call list_distinct_values with field=ownership for the 13 exact values (e.g. \"For profit - Limited Liability company\").",
            "type": "string"
          },
          "q": {
            "type": "string"
          },
          "radius_miles": {
            "type": "number"
          },
          "sffstatus": {
            "description": "When truthy, keep only Special Focus Facility or candidate homes (non-empty sffstatus).",
            "type": "string"
          },
          "sort": {
            "description": "Sort key: overall_rating (default, desc), survey_rating, quality_rating, staffing_rating, distance (asc, straight-line miles), tothrd or total_nurse_hours (desc), totalnursingstaffturnover or nurse_turnover (asc), weighted_all_cycles_score or survey_score (asc). Unknown values fall back to overall_rating.",
            "enum": [
              "overall_rating",
              "survey_rating",
              "quality_rating",
              "staffing_rating",
              "distance",
              "tothrd",
              "total_nurse_hours",
              "totalnursingstaffturnover",
              "nurse_turnover",
              "weighted_all_cycles_score",
              "survey_score"
            ],
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "zip": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_facilities",
      "outputSchema": null
    },
    {
      "description": "Find certified US SNFs by CMS ownership type (ProviderInfo.ownership). Call list_distinct_values with field=ownership first. Same result schema as search_facilities; combine with state, city, ZIP, or address.",
      "inputSchema": {
        "properties": {
          "address": {
            "description": "Street address with city and state, or a street and ZIP. Geocoded by the Census Bureau as the distance origin. A city, place name, or ZIP alone will not match.",
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "limit": {
            "type": "integer"
          },
          "max_overall_rating": {
            "type": "integer"
          },
          "min_overall_rating": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "ownership": {
            "description": "CMS ownership type. Case-insensitive. Prefixes For profit, Non profit, and Government match that kind. Exact values from list_distinct_values field=ownership, e.g. \"For profit - Limited Liability company\".",
            "type": "string"
          },
          "q": {
            "type": "string"
          },
          "radius_miles": {
            "type": "number"
          },
          "sort": {
            "enum": [
              "overall_rating",
              "survey_rating",
              "quality_rating",
              "staffing_rating",
              "distance",
              "tothrd",
              "total_nurse_hours",
              "totalnursingstaffturnover",
              "nurse_turnover",
              "weighted_all_cycles_score",
              "survey_score"
            ],
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "zip": {
            "type": "string"
          }
        },
        "required": [
          "ownership"
        ],
        "type": "object"
      },
      "name": "search_facilities_by_ownership",
      "outputSchema": null
    },
    {
      "description": "Search nursing-home owners by name. Defaults to the latest CMS monthly snapshot; pass filedate from list_file_dates to query a prior month.",
      "inputSchema": {
        "properties": {
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "q": {
            "type": "string"
          }
        },
        "required": [
          "q"
        ],
        "type": "object"
      },
      "name": "search_owners",
      "outputSchema": null
    },
    {
      "description": "Aggregate numeric CMS ProviderInfo fields (n, mean, min, max; optional median) across certified SNFs. Prefer this over paging search_facilities for national or grouped stats. Call list_distinct_values for ownership catalogs; call list_file_dates for filedate. Facility-equal means — not bed-weighted. Missing values excluded per metric. Not causal. Not a substitute for get_facility on a named home. Rate limit 60 requests/minute.",
      "inputSchema": {
        "properties": {
          "abuse_icon": {
            "type": "string"
          },
          "city": {
            "description": "City filter. Requires state.",
            "type": "string"
          },
          "filedate": {
            "description": "Optional CMS monthly snapshot (YYYY-MM-DD or YYYY-MM). Defaults to the latest file. Call list_file_dates first for available dates.",
            "type": "string"
          },
          "group_by": {
            "description": "Omit for one national (or filter-scoped) row per metric. ownership_kind is Government | For profit | Non profit.",
            "enum": [
              "ownership",
              "ownership_kind",
              "state",
              "overall_rating",
              "staffing_rating",
              "survey_rating",
              "quality_rating",
              "sffstatus",
              "abuse_icon"
            ],
            "type": "string"
          },
          "include_median": {
            "description": "When true, each stats object also includes median. Default false.",
            "type": "boolean"
          },
          "max_overall_rating": {
            "type": "integer"
          },
          "metrics": {
            "description": "Metric keys: tothrd, rnhrd, weekend_tothrd, weekend_rnhrd, totalnursingstaffturnover, registerednurseturnover, weighted_all_cycles_score, overall_rating, survey_rating, staffing_rating, quality_rating, bedcert, restot, fine_tot, fine_cnt, occupancy (and documented synonyms).",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "type": "array"
          },
          "min_overall_rating": {
            "type": "integer"
          },
          "ownership": {
            "description": "CMS ownership type. Prefixes For profit, Non profit, and Government match that kind. Applied before aggregation.",
            "type": "string"
          },
          "sffstatus": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "zip": {
            "type": "string"
          }
        },
        "required": [
          "metrics"
        ],
        "type": "object"
      },
      "name": "summarize_facilities",
      "outputSchema": null
    }
  ]
}

Verify it yourself

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