> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PopHIVE MCP

> Yale's harmonized US public health surveillance data, covering disease, vaccination, and health outcome trends.

![PopHIVE MCP logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/pophive_mcp.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=da2a23b262b5817d1f18f3d366c529ad)

* **Category:** analytics
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `POPHIVE_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Compare
>
> **Slug:** `POPHIVE_MCP_COMPARE`
>
> Side-by-side comparison of one disease across 2–5 US places, or agreement between surveillance sources in one place. For straightforward single-slice questions only (e.g. "is RSV worse in CT than NY?", "do wastewater and ED visits agree on COVID?"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "Is RSV worse in CT than NY?", "Compare diabetes in Texas vs California", "Do wastewater and ED visits agree on COVID?"
>
> Not for: one place's status (get\_current\_status), ranking many places (get\_map).
>
> Call example: compare(disease='covid', geographies=\['Texas', 'Florida'])
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **period** `string`
>
> "4w", "8w", "12w" (default), "season", "1y", "all".
>
> **source** `string`
>
> In geographies mode, pin one source by name; omit for the preferred source. Errors list valid names.
>
> **disease** `string` *required*
>
> Any PopHIVE topic or alias (e.g. "flu", "covid", "measles"). get\_data() lists all topics.
>
> **sources** `string`
>
> List of 2–5 source names to correlate within one geography.
>
> **geography** `string`
>
> In sources mode, the place to correlate within — state, county, or city (same grammar as get\_trend); omit for national.
>
> **geographies** `string`
>
> List of 2–5 geographies to compare side by side. If "US" (national) is one of them, every other geography gets a precomputed vs-national column (% above/below, or percentage-points for percent measures) so you can quote "WV is 85% above national" directly.
>
> **include\_chart** `boolean`
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.

> [accordion] Get coverage
>
> **Slug:** `POPHIVE_MCP_GET_COVERAGE`
>
> US childhood vaccination coverage — the rate for one vaccine in one place and whether it meets targets. For straightforward single-slice questions only (e.g. "kindergarten MMR rate in Idaho?", "is Texas below 95% MMR?"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "Kindergarten MMR rate in Idaho?", "Is Texas below 95% MMR?", "Polio vaccination rate in Connecticut."
>
> Not for: disease activity (get\_current\_status), trends (get\_trend), coverage rankings across states (get\_map with disease='mmr').
>
> Call example: get\_coverage(vaccine='mmr', geography='Idaho')
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **vaccine** `string`
>
> One of: combined7, dtap, hepa, hepb, hib, mmr, pcv, polio, rotavirus, vaccine\_exemptions, varicella. Aliases like "measles" or "chickenpox" also work. Default "mmr".
>
> **geo\_level** `string`
>
> "state" (default) or "county" (MMR only).
>
> **geography** `string`
>
> A state, county, or city — e.g. "ID", "New Haven County, CT", "Houston" (same grammar as get\_trend); omit for national.
>
> **include\_chart** `boolean`
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.

> [accordion] Get current status
>
> **Slug:** `POPHIVE_MCP_GET_CURRENT_STATUS`
>
> Current-status verdict for one disease in one US place — level, direction, and risk right now. For straightforward single-slice questions only (e.g. "is flu rising in Texas?", "how bad is COVID nationally?"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "Is RSV rising in Connecticut?", "How bad is flu nationally?", "What is the risk of measles in Texas?", "Current COVID situation in New York."
>
> Not for: trends over time (get\_trend), ranking geographies (get\_map), vaccination coverage (get\_coverage).
>
> Call example: get\_current\_status(disease='rsv', geography='Connecticut')
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **source** `string`
>
> Pin the headline to one source by name — e.g. "hospitalizations" when the user asks about hospital admissions rather than the default ED-visit signal. Omit for the preferred signal; errors list valid names.
>
> **disease** `string` *required*
>
> Any PopHIVE topic or alias (e.g. "flu", "covid", "measles"). get\_data() lists all topics.
>
> **geography** `string`
>
> A state, county, or city — e.g. "CT", "New Haven County, CT", "Houston" (same grammar as get\_trend); omit for national.
>
> **include\_chart** `boolean`
>
> Attach a PNG of all sources' recent trends.
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.

> [accordion] Get data
>
> **Slug:** `POPHIVE_MCP_GET_DATA`
>
> Data catalog and raw-data gateway. The six specialized tools answer single-slice questions — current status, trend, map/ranking, A-vs-B compare, coverage — with server-verified evidence; try them first, escalating here costs one call. Use get\_data when evidence can't carry the answer: multi-stratum gaps, history beyond the served window, complete lists, cross-dataset joins, custom math. Flow: (1) catalog, (2) disease='about' for the guide, (3) view schema + data\_url, (4) download and compute — results are yours but carry the caveats and aren't server-verified. include\_query=true returns a runnable pandas snippet.
>
> Topics: annual\_wellness\_visit, antimicrobial\_resistance, breast\_cancer\_screening, campylobacter, cardiovascular\_screening, cervical\_cancer\_screening, chlamydia\_screening, colorectal\_cancer\_screening, combined7, community\_health, copd, covid19, depression\_screening, diabetes, diabetes\_screening, diarrhea, dtap, enteric\_disease, firearm\_injury, flu\_vaccine\_adult, haemophilus\_influenzae, healthcare\_access, heat\_illness, hepa, hepb, hib, infant\_mortality, influenza, injury\_deaths, low\_birth\_weight, maternal\_health, maternal\_mortality, measles, mmr, obesity, opioid\_overdose, opioid\_use\_disorder, pcv, pelvic\_exam, pertussis, pneumococcal\_vaccine\_adult, polio, prostate\_cancer\_screening, rotavirus, rsv, salmonella, shigella, stec, strep, teen\_births, vaccine\_exemptions, varicella, youth\_wellbeing.
>
> Examples: "What does PopHIVE track?", "Do you have Lyme disease data?", "Vaccination gaps across insurance types", "Raw RSV data for Connecticut."
>
> Not for: 'is flu rising in Texas?' → get\_current\_status; 'rank states by COVID wastewater' → get\_map; 'is RSV worse in CT than NY?' → compare.
>
> Call example: get\_data(disease='rsv', view='overall\_trend')
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **view** `string`
>
> Optional. e.g. "overall\_trend", "geography\_map", "trends\_by\_age".
>
> **source** `string`
>
> Optional. With no disease, returns the inverse lookup — every disease that source covers ("What does Epic Cosmos track?"). Friendly names accepted ("wastewater", "google").
>
> **disease** `string`
>
> Optional. If omitted, returns the full catalog inventory. Pass "about" for the long-form reference document, "archive" for the index of upstream source files (longer history, unserved measures; download-and-compute only; add view='\<category>' for one group's files).
>
> **geography** `string`
>
> Optional, only with disease+view. A single geography ("CT"), a list (\["CT", "NY", "MA"]), or "all states" for one latest-period row per state.
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.

> [accordion] Get map
>
> **Slug:** `POPHIVE_MCP_GET_MAP`
>
> Geographic ranking — which US states or counties are highest or lowest on one disease, by current level or recent change. For straightforward single-slice questions only (e.g. "which counties have the highest RSV?", "how does Texas rank on flu?"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "What parts of the US have the highest rates of flu right now?", "How do diabetes rates differ across the US by county?", "How does Texas rank?", "Which states are improving fastest on opioid overdose?"
>
> Not for: trends over time (get\_trend), one place's status (get\_current\_status).
>
> Call example: get\_map(disease='flu', geo\_level='state', top\_n=10)
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **top\_n** `integer`
>
> 1–20. Default 10.
>
> **region** `string`
>
> Scope the ranking to part of the country — a region name ("Northeast", "Midwest", "South", "West", "New England", "Pacific Northwest", ...) or an explicit list of states (\["TX", "OK", "NM"]). County rankings keep only counties in those states. Ranks and medians are then within-region.
>
> **source** `string`
>
> Pin one source by name; omit for the preferred source. Errors list valid names.
>
> **disease** `string` *required*
>
> Any PopHIVE topic or alias (e.g. "flu", "covid", "mmr"). get\_data() lists all topics.
>
> **rank\_by** `string ("value" | "change")`
>
> "value" (default) ranks by current level. "change" ranks by recent trend direction/magnitude — direction="lowest" then means fastest-declining (most improving for incidence measures), "highest" means fastest-rising. Each row carries from\_value → to\_value + direction so you can quote "WV: 51.4→45.5 (declining)".
>
> **direction** `string`
>
> "highest" (default) or "lowest".
>
> **geo\_level** `string`
>
> "state" (default) or "county".
>
> **highlight** `string`
>
> Optional geography to locate in the ranking. The answer states its exact rank, value, and quartile so you never have to infer it from the top-N alone.
>
> **include\_chart** `boolean`
>
> Attach a PNG bar chart.
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.

> [accordion] Get overview
>
> **Slug:** `POPHIVE_MCP_GET_OVERVIEW`
>
> Cross-disease situation report for one US state or the nation — what's elevated, rising, declining, or stale across every PopHIVE topic. For straightforward single-slice questions only (e.g. "anything elevated in Connecticut?", "public health sitrep for Florida?"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "What's going on health-wise in Texas?", "Public health sitrep for Florida", "Anything elevated in Connecticut?"
>
> Not for: a single disease (get\_current\_status), time series (get\_trend), ranking states by one disease (get\_map).
>
> Call example: get\_overview(geography='Texas')
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **diseases** `string`
>
> Optional list of topics to scope to; default all. get\_data() lists topics.
>
> **geography** `string`
>
> A US state ("Connecticut", "CT"), DC, or a territory (PR, GU, VI, AS, MP); omit for national. No counties (most topics are state-level).
>
> **include\_chart** `boolean`
>
> Attach a sparkline grid (one mini chart per topic).

> [accordion] Get trend
>
> **Slug:** `POPHIVE_MCP_GET_TREND`
>
> Trend over time for one disease in one US place — direction, peak, and change, optionally stratified or pinned to one source. For straightforward single-slice questions only (e.g. "how has RSV changed since January?", "flu trend in Ohio"). If the answer needs anything beyond reading one precomputed evidence block, use get\_data.
>
> Examples: "What are the latest trends in COVID?", "How has flu changed since January?", "Diabetes trend in Ohio over 5 years."
>
> season\_over\_season evidence compares the current season to the immediately prior season only; for older seasons use get\_data.
>
> Not for: a current-status verdict (get\_current\_status), ranking geographies (get\_map), vaccination coverage (get\_coverage).
>
> Call example: get\_trend(disease='flu', geography='US', period='12w')
>
> Scope: US-only aggregate surveillance; relay the precomputed evidence, never re-derive numbers.
>
> #### Input Parameters
>
> **period** `string`
>
> "1w", "2w", "4w", "8w", "12w" (default), "season", "1y", "2y", "3y", "5y", or "all". Use "1w" for week-over-week change. Periods shorter than the dataset's cadence are rejected; periods longer than available history echo the actual span in `resolved.period_actual`.
>
> **source** `string`
>
> Pin to one upstream signal. Friendly names accepted ("Epic Cosmos", "wastewater", "hospitalizations"). When omitted, uses PopHIVE's preferred trend signal for this disease and cross-validates against the others — the answer states which signal the series is from and whether the others agree. Never describe a single signal as "the" number for the disease.
>
> **disease** `string` *required*
>
> Any PopHIVE topic or alias (e.g. "flu", "covid", "measles"). get\_data() lists all topics.
>
> **stratum** `string`
>
> With stratify\_by, pin the series to ONE value of that dimension instead of breaking out all of them — e.g. stratify\_by="age", stratum="0-4 years" for a pediatric series, or stratify\_by="insurance", stratum="Medicaid". Case-insensitive; whole-word matches and common aliases (AIAN, Pacific Islander) accepted. A value carried by a sibling signal of the same topic is routed to it automatically. Errors list the valid values.
>
> **baseline** `string`
>
> Anchor the Change block to an explicit baseline instead of the default recent window — a 4-digit year ("2020") or ISO date ("2020-03-01"). Answers "how has X changed since 2020?" with from\_value at the baseline and to\_value at the latest observation.
>
> **geography** `string`
>
> a US state ("Connecticut", "CT"), DC, a US territory (PR, GU, VI, AS, MP), a county ("New Haven County, CT", "09009"), a major US city ("Houston"), or "US" for national. Default "US".
>
> **stratify\_by** `string`
>
> Break out by a stratification dimension (one of "age", "alph\_type", "antibiotic", "antimicrobial", "antimicrobial\_class", "cause\_of\_death", "emm\_type", "ethnicity", "forecast\_day", "genus", "insurance", "measure", "onset", "outcome\_name", "pathogen", "pattern", "race", "race\_ethnicity", "serotype", "sex", "species\_serotype", "syndrome", "urban", "vaccine", "vax", "vax\_group" — varies by disease; get\_data(disease=X) lists which apply).
>
> **include\_chart** `boolean`
>
> Attach a PNG line chart.
>
> **include\_query** `boolean`
>
> Include a runnable pandas snippet + column schema.
