Docs/Skills/US County Data Skill

US County Data Skill

Get data about US counties

OperationalCredits 10 per callp50 846msGeography

Overview

County Data works by analyzing the county name provided and getting data about the US county. It uses advanced algorithms to get data such as average income, area, and more based on the county name and returns the county data.

Live Test US County Data Skill Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as USCountyDataSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call
{
  "name": "USCountyDataSkill",
  "arguments": {
    "state": "MO",
    "county": "Jackson"
  }
}

You do not name the tool yourself; the model picks it. Asking about MO in the terms this skill covers is enough for it to reach for USCountyDataSkill on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

ArgumentTypeDescription
stateRequiredstringThe two letter name of the US state the county is in (e.g., MO)
length 2–2
countyRequiredstringThe name of the US county to get data about (e.g. Jackson)

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "name": "jackson county",
    "state": "MO",
    "age": {
      "0-4": 0.0644100874666257,
      "5-9": 0.06532756955438819,
      "10-14": 0.06595060390235714,
      "15-19": 0.05967616438434107,
      "20-24": 0.059725950234064615,
      "25-29": 0.08192474939936928,
      "30-34": 0.07523353119652466,
      "35-39": 0.06868029092005673,
      "40-44": 0.05831060964906666,
      "45-49": 0.058805623240603636,
      "50-54": 0.05858087569042305,
      "55-59": 0.0674783182624454,
      "60-64": 0.06208437705811146,
      "65-69": 0.05099777955110233,
      "70-74": 0.03891546504962227,
      "75-79": 0.026437708656052324,
      "80-84": 0.01748905778145719,
      "85+": 0.01997123800338828
    },
    "male": 339932,
    "female": 363079,
    "health": {
      "poorhealth": 20.588989742,
      "physicallyunhealthydays": 4.247736361,
      "mentallyunhealthydays": 4.8111015035,
      "lowbirthweightpercent": 9.1518749808,
      "smokerspercent": 20.957241772,
      "obesitypercent": 31.5,
      "foodenvindex": 7.5,
      "physicallyinactivepercent": 23.2,
      "excessivedrinkingpercent": 18.940103365,
      "alcoholimpaireddrivingdeaths": 152,
      "teenbirthrate": 31.109351559,
      "uninsured": 12.486314662,
      "withannualmammogram": 45,
      "vaccinated": 51,
      "childreninpoverty": 19.6,
      "80thpercentileincome": 108296,
      "20thpercentileincome": 23275,
      "childreninsingleparenthouseholds": 33.224850811,
      "violentcrimerate": 941.43198334,
      "averagedailypm25": 9.1,
      "severehousingproblems": 15.347550638,
      "drivealonetowork": 83.470246386,
      "longcommutedrivesalone": 33.7
    },
    "longitude": -94.34749665503394,
    "latitude": 39.016701918102484,
    "education": {
      "lessthanhighschool": 9.4,
      "highschool": 28.3,
      "somecollege": 30.7,
      "bachelors": 31.6
    },
    "zipcodes": [
      "64137",
      "64111",
      "64053",
      "64055",
      "64064",
      "64029",
      "64106",
      "64108",
      "64034",
      "64118",
      "64136",
      "64139",
      "64125",
      "64030",
      "64014",
      "64066",
      "64080",
      "64123",
      "64131",
      "64145",
      "64128",
      "64121",
      "64170",
      "64050",
      "64057",
      "64133",
      "64109",
      "64130",
      "64134",
      "64129",
      "64158",
      "64163",
      "64070",
      "64102",
      "64105",
      "64086",
      "64101",
      "64124",
      "64157",
      "64088",
      "64061",
      "64051",
      "64002",
      "64081",
      "64013",
      "64016",
      "64112",
      "64114",
      "64110",
      "64152",
      "64127",
      "64147",
      "64120",
      "64146",
      "64199",
      "64058",
      "64054",
      "64074",
      "64119",
      "64138",
      "64149",
      "64156",
      "64132",
      "64171",
      "64148",
      "64141",
      "64999",
      "64052",
      "64015",
      "64063",
      "64075",
      "64056",
      "64082",
      "64113",
      "64155",
      "64126",
      "64197",
      "64065",
      "64198"
    ],
    "lifeexpectancy": 77.19,
    "avgincome": 47054,
    "povertyrate": 13.7,
    "costofliving": {
      "livingwage": 14.55,
      "foodcosts": 3246,
      "medicalcosts": 2681,
      "housingcosts": 8136,
      "taxcosts": 6263
    },
    "landareakm2": 1565.601892,
    "areakm2": 1596.319707
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
namestringjackson countyCounty name in lowercase format
statestringMOTwo-letter state code where county is located
agePremiumobject{…}Age distribution percentages by age groups
age.0-4Premiumnumber0.0644100874666257Percentage of population aged 0-4 years
age.5-9Premiumnumber0.06532756955438819Percentage of population aged 5-9 years
age.10-14Premiumnumber0.06595060390235714Percentage of population aged 10-14 years
age.15-19Premiumnumber0.05967616438434107Percentage of population aged 15-19 years
age.20-24Premiumnumber0.059725950234064615Percentage of population aged 20-24 years
age.25-29Premiumnumber0.08192474939936928Percentage of population aged 25-29 years
age.30-34Premiumnumber0.07523353119652466Percentage of population aged 30-34 years
age.35-39Premiumnumber0.06868029092005673Percentage of population aged 35-39 years
age.40-44Premiumnumber0.05831060964906666Percentage of population aged 40-44 years
age.45-49Premiumnumber0.058805623240603636Percentage of population aged 45-49 years
age.50-54Premiumnumber0.05858087569042305Percentage of population aged 50-54 years
age.55-59Premiumnumber0.0674783182624454Percentage of population aged 55-59 years
age.60-64Premiumnumber0.06208437705811146Percentage of population aged 60-64 years
age.65-69Premiumnumber0.05099777955110233Percentage of population aged 65-69 years
age.70-74Premiumnumber0.03891546504962227Percentage of population aged 70-74 years
age.75-79Premiumnumber0.026437708656052324Percentage of population aged 75-79 years
age.80-84Premiumnumber0.01748905778145719Percentage of population aged 80-84 years
age.85+Premiumnumber0.01997123800338828Percentage of population aged 85 years and older
malePremiumnumber339932Total male population count in county
femalePremiumnumber363079Total female population count in county
healthPremiumobject{…}Health metrics and indicators for the county
health.poorhealthPremiumnumber20.588989742Percentage of population reporting poor health status
health.physicallyunhealthydaysPremiumnumber4.247736361Average physically unhealthy days per month
health.mentallyunhealthydaysPremiumnumber4.8111015035Average mentally unhealthy days per month
health.lowbirthweightpercentPremiumnumber9.1518749808Percentage of low birth weight births
health.smokerspercentPremiumnumber20.957241772Percentage of population that smokes
health.obesitypercentPremiumnumber31.5Percentage of population classified as obese
health.foodenvindexPremiumnumber7.5Food environment index rating for county
health.physicallyinactivepercentPremiumnumber23.2Percentage of physically inactive population
health.excessivedrinkingpercentPremiumnumber18.940103365Percentage of excessive alcohol drinkers
health.alcoholimpaireddrivingdeathsPremiumnumber152Annual alcohol-impaired driving deaths in county
health.teenbirthratePremiumnumber31.109351559Birth rate among teenage population
health.uninsuredPremiumnumber12.486314662Percentage of uninsured population
health.withannualmammogramPremiumnumber45Percentage receiving annual mammogram screening
health.vaccinatedPremiumnumber51Percentage of vaccinated population
health.childreninpovertyPremiumnumber19.6Percentage of children living in poverty
health.80thpercentileincomePremiumnumber10829680th percentile income level in dollars
health.20thpercentileincomePremiumnumber2327520th percentile income level in dollars
health.childreninsingleparenthouseholdsPremiumnumber33.224850811Percentage of children in single-parent households
health.violentcrimeratePremiumnumber941.43198334Violent crime rate per 100,000 people
health.averagedailypm25Premiumnumber9.1Average daily PM2.5 air pollution level
health.severehousingproblemsPremiumnumber15.347550638Percentage with severe housing cost burden
health.drivealonetoworkPremiumnumber83.470246386Percentage driving alone to work
health.longcommutedrivesalonePremiumnumber33.7Percentage with long commute driving alone
longitudePremiumnumber-94.34749665503394Geographic longitude coordinate of county
latitudePremiumnumber39.016701918102484Geographic latitude coordinate of county
educationPremiumobject{…}Educational attainment distribution for county
education.lessthanhighschoolPremiumnumber9.4Percentage with less than high school education
education.highschoolPremiumnumber28.3Percentage with high school education
education.somecollegePremiumnumber30.7Percentage with some college education
education.bachelorsPremiumnumber31.6Percentage with bachelor's degree or higher
zipcodesPremiumarray["64137","64111","64053"]Array of all ZIP codes within the county
lifeexpectancynumber77.19Average life expectancy in years
avgincomenumber47054Average annual household income in dollars
povertyratenumber13.7Percentage of population below poverty line
costoflivingPremiumobject{…}Cost of living metrics for the county
costofliving.livingwagePremiumnumber14.55Living wage per hour in dollars
costofliving.foodcostsPremiumnumber3246Average annual food costs in dollars
costofliving.medicalcostsPremiumnumber2681Average annual medical costs in dollars
costofliving.housingcostsPremiumnumber8136Average annual housing costs in dollars
costofliving.taxcostsPremiumnumber6263Average annual tax costs in dollars
landareakm2Premiumnumber1565.601892Land area of county in square kilometers
areakm2Premiumnumber1596.319707Total area of county in square kilometers

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out of credits, or a brief rate limit. The message tells them apart.

A call costs 10 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

Mortgage Applicant Benchmarking
Mortgage lenders check local poverty rates and average household income to benchmark applicant earnings against county economic baselines.
Public Health Screening
To prioritize regional health initiatives, medical researchers compare county life expectancy figures with state poverty rates.
Retail Site Selection
When evaluating new storefront locations, commercial real estate developers review county average income and poverty levels to assess consumer spending capacity.
Grant Resource Allocation
Nonprofit program managers distribute community development grants by evaluating county poverty rates and average household income against national benchmarks.

Other ways to use US County Data Skill

Set up US County Data Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Geography:

Was this page helpful?