How to Use CDC PLACES local health estimates in Claude Code
Returns CDC PLACES modeled adult health estimates for counties, places, census tracts, and ZIP Code Tabulation Areas. Use it to compare local chronic disease and preventive care measures for community planning.
Prompts to try with CDC PLACES local health estimates in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use CDC PLACES local health estimates to fetch Harris County, Texas, and build a table of its available adult health measures in this project's dashboard.
Use CDC PLACES local health estimates to compare matching health measures for Maricopa, Pima, and Pinal counties in Arizona, then add a comparison view to this app.
Use CDC PLACES local health estimates to retrieve Chicago, Illinois, and generate a CSV of the available health estimates for this project's reporting workflow.
Use CDC PLACES local health estimates to fetch census tracts in Los Angeles County, California, and populate this project's map with one available health measure.
Use CDC PLACES local health estimates to retrieve ZCTAs 77002 and 77003 and build a side-by-side table of their matching measures.
How to set up CDC PLACES local health estimates in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run CDC PLACES local health estimates
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "data-cdc-gov/prevalence/search", "input": { "measure": "ACCESS2" } }'
Then paste one of the prompts above: Claude Code finds CDC PLACES local health estimates on Spiral, shows the price and runs it.
CDC PLACES local health estimates providers and prices
Spiral runs CDC PLACES local health estimates through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Measure | ACCESS2, ARTHRITIS, BINGE, BPHIGH, BPMED, CANCER, CASTHMA, CHD and 37 more | PLACES measure id. Health outcomes: ARTHRITIS, BPHIGH (high blood pressure), CANCER (cancer other than skin, or melanoma), CASTHMA (current asthma), CHD (coronary heart disease), COPD, DEPRESSION, DIABETES (diagnosed), HIGHCHOL (high cholesterol among adults ever screened), OBESITY, STROKE, TEETHLOST (all teeth lost, adults 65 and older). Prevention: ACCESS2 (no health insurance, ages 18-64), BPMED (taking blood pressure medicine, among adults with high blood pressure), CHECKUP, CHOLSCREEN, COLON_SCREEN (ages 45-75), DENTAL, MAMMOUSE (women 50-74). Risk behaviors: BINGE, CSMOKING, LPA (no leisure-time physical activity), SLEEP (short sleep). Health status: GHLTH (fair or poor health), MHLTH (frequent mental distress), PHLTH (frequent physical distress). Disabilities (2023 release on): DISABILITY (any), COGNITION, HEARING, INDEPLIVE, MOBILITY, SELFCARE, VISION. Social needs (2024 release on): EMOTIONSPT, FOODINSECU, FOODSTAMP, HOUSINSECU, LACKTRPT, SHUTUTILITY; LONELINESS (2025 on); ISOLATION (2024 only). Releases up to 2023 only: CERVICAL, COREM, COREW, KIDNEY (chronic kidney disease). A measure the chosen release lacks is invalid_input naming the release's measures. | |
| Sort | value_desc, value_asc, or location | value_desc |
|
| Level | county, place, tract, or zcta | county | Geography: |
| Limit | 1 to 1000 | 100 | Locations per page. |
| Offset | 0 to 100000 | 0 | Matches to skip: |
| Release | 2020 to 2100 | PLACES release year. Default: the latest release at the chosen level. Releases before 2024 have no adult population; the 2020 county release lacks location codes and is refused. | |
| Value type | crude or age_adjusted | crude |
|
Every API field of CDC PLACES local health estimates (data.cdc.gov) · Search is on its tool page: open its card above.
What can you do with CDC PLACES local health estimates in Claude Code?
Build a local health dashboard populated with CDC's modeled estimates for counties or census tracts. A coding agent can turn the returned measures into comparison tables and add explanations of their survey sources and uncertainty.
Community health needs brief
Summarize available adult health estimates for Harris County, Texas, and its census tracts to support a community planning discussion.
County comparison report
Compare the same health measures across Maricopa, Pima, and Pinal counties in Arizona, showing uncertainty alongside the estimates.
Grant needs statement
Build a needs statement for a public health grant using Chicago's available estimates, with clear labels identifying the results as modeled.
Local health map
Populate a map of Los Angeles County census tracts with one available health measure at a time, keeping the geography consistent.
Prevention planning shortlist
Compare available preventive care estimates across Florida counties to identify areas for further local assessment and outreach planning.
Public county health dashboard
Publish county health estimates with explanations of the BRFSS, Census, and American Community Survey sources and the uncertainty in modeled results.
More on CDC PLACES local health estimates and Claude Code
Overview
CDC PLACES local health estimates in other agents
Questions about CDC PLACES local health estimates in Claude Code
Can Claude Code use CDC PLACES local health estimates?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run CDC PLACES local health estimates like any built-in tool.
How much does CDC PLACES local health estimates cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use CDC PLACES local health estimates in Claude Code?
No. Spiral runs CDC PLACES local health estimates on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up CDC PLACES local health estimates in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while CDC PLACES local health estimates runs?
CDC PLACES local health estimates runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Which places does PLACES cover?
PLACES provides US estimates for counties, incorporated and census designated places, census tracts, and ZIP Code Tabulation Areas. CDC describes coverage as areas with at least 50 adult residents.
How current are the estimates?
PLACES updates annually, but the survey data are older than the release year. The 2025 release combines 35 measures from the 2023 BRFSS with five from 2022.
Why are some Kentucky and Pennsylvania estimates missing?
The 2025 release has no Kentucky or Pennsylvania estimates for measures based on the 2023 BRFSS. The five measures based on 2022 data were carried over for those states.
Are these measured counts of local patients?
PLACES produces modeled estimates using BRFSS, Census, and American Community Survey data. CDC reports 95% confidence intervals to describe uncertainty around those estimates.
Can I get estimates for individuals or demographic groups?
PLACES publishes area aggregates, with no estimates for individual people. Breakdowns by age, gender, race or ethnicity, and poverty are unavailable.
Start using CDC PLACES local health estimates in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


