Skip to content

census-mcp-server

io.github.cyanheads/census-mcp-servercyanheadsstreamable-httpv0.8.0Scanned

Query U.S. Census Bureau data, variables, and geography via MCP.

8 tools: 8 only read.

Tools: 0 delete, 0 irreversible, 0 write, 8 read.
  • Reads private data · 1
  • Reads text others write · 1
  • Can send data out · 0
  • 1 finding

Tools listed without sign-in. Remote posture

With Anlyon

Decide which of this server's tools your agent can use.

  • Anlyon lists the tools and adopts none.
  • Each tool you adopt gets approvals and receipts.
  • Your agent never holds the key.
Govern this server →

A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.

What the census-mcp-server can do

The census-mcp-server is published by the GitHub account cyanheads. It has 8 tools. Every one of them only reads: going by their definitions, none of them creates, changes, sends or deletes anything.

1 tool reads private data (census_get_variable); 1 tool brings in text other people can write (census_list_datasets).

The fixed checks matched 1 finding (long-description). Each one comes with the text it matched.

Its remote endpoint lists its tools without sign-in, and its tools changed 3 times since Anlyon Radar first saw them.

Last scanned Nov 16, 2026, version 0.8.0.

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

8 tools

Only reads 8Show 8 read-only tools
  • census_compare_geographiesCompare one or more variables across multiple geographies at the same level — all counties in a state, all states nationally, or a named set of specific geographies — ranked on the…No findings

    Why it is in this group

    • The name "census_compare_geographies" says "compare": a word for reading.
    Description, as the server wrote it
    Compare one or more variables across multiple geographies at the same level — all counties in a state, all states nationally, or a named set of specific geographies — ranked on the value of one of them. Covers queries like "compare median income across WA counties" or "which states have the most people below the poverty line." A count ranks geographies by size, not by rate, so to rank a rate, rank a published percentage: S1701_C03_001E (percent below the poverty level, dataset acs/acs5/subject), DP03_0128PE (the same percentage, acs/acs5/profile), or DP04_0047PE (percent of occupied housing units that are renter-occupied, acs/acs5/profile). Profile and subject tables reach tracts but not block groups. Omit within to compare all geographies nationally at the level. Suppressed values are decoded to human-readable labels rather than passed through as raw negative sentinels. On the business datasets (cbp, ecnbasic, nonemp), pep/charv, dec/ddhca, dec/ddhcb, and acs/acs1/spp, use predicates to rank within one industry, size class, or population group — a comparison that omits one ranks on a default the Census API picks, which is an all-categories total on some dimensions and a single category on others. Each row names the defaults that were applied in applied_filters, and census_list_predicate_values enumerates the codes a dimension accepts. Some dec/ddhca and dec/ddhcb tables split the population groups between them, publishing each group at a geography in only one table of the family, so a ranking on one of them leaves out the geographies whose group sits in a sibling table — the notice names those tables. A dataset that publishes several records per geography cannot be ranked until one is pinned: pep/charv publishes an April estimates base and a July estimate, so a comparison that pins neither fails with ambiguous_rows rather than giving every geography two ranks — pass predicates {"MONTH": "7"} for the July estimate.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_get_variableFetch full metadata for one or more Census variable codes — label, concept group, predicate type, the table's universe, and margin-of-error sibling references.Reads private dataNo findings

    Why it is in this group

    • The name "census_get_variable" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "fetch" and "table": it reads databases.
    Description, as the server wrote it
    Fetch full metadata for one or more Census variable codes — label, concept group, predicate type, the table's universe, and margin-of-error sibling references. Use to confirm a variable code before building a query, or to look up what a known code means. On ACS datasets it returns estimate_code and moe_code sibling references so you can request both without a separate search, and a margin-of-error code carries attribute_of (its estimate) and attribute_type MARGIN_OF_ERROR; the ACS comparison profiles (acs/acs5/cprofile, acs/acs1/cprofile) and the other dataset families publish no margins of error and carry none of these fields. It also resolves the annotation and flag columns the data tools accept, such as B19013_001EA or EMP_F, naming the column each one belongs to, and predicate codes such as NAICS2017 or SEX, confirming a filter dimension exists in a dataset before a query uses it — for the values a dimension accepts rather than the dimension itself, call census_list_predicate_values.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_list_datasetsBrowse available Census Bureau datasets with their supported vintage years.Reads text others writeNo findings

    Why it is in this group

    • The name "census_list_datasets" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "browse": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Browse available Census Bureau datasets with their supported vintage years. Use as the starting point when the right dataset is unknown — ACS5, ACS1, and their profile, subject, and comparison tables, population estimates, the decennial census files, the business datasets (County Business Patterns, Economic Census, Nonemployer Statistics), and geoinfo (land area and internal points, the denominator for population density) serve different use cases. Pass the dataset_id value to the dataset parameter in other census tools. Each description names the predicates a dataset requires and the geography levels it publishes, both of which vary by dataset.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_list_geographiesList the geography levels available for a given Census dataset and year, along with the parent geographies each level requires.No findings

    Why it is in this group

    • The name "census_list_geographies" says "list": a word for reading.
    Description, as the server wrote it
    List the geography levels available for a given Census dataset and year, along with the parent geographies each level requires. Use before querying to confirm that the target geography level exists — ACS1 omits many sub-state levels, and not all datasets support tracts or block groups. The geography_level values returned here are the valid inputs to the geography_level parameter in census_query_data and census_compare_geographies.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_list_predicate_valuesList the codes a Census filter dimension accepts, so a predicates map can be written without guessing.No findings

    Why it is in this group

    • The name "census_list_predicate_values" says "list": a word for reading.
    Description, as the server wrote it
    List the codes a Census filter dimension accepts, so a predicates map can be written without guessing. Answers the question left open when census_query_data or census_compare_geographies reports that a dimension was left unset. Which route a dimension takes depends on the vintage: NAICS and POPGROUP always publish a value list in the dataset dictionary, and on the current vintages EMPSZES, LFO, RCPSZES, TAXSTAT, and TYPOP publish none and are enumerated here against the live data endpoint instead, which needs the server's Census API key. A dictionary value list is a classification shared across Census products rather than a list of what one dataset serves, and roughly half of its codes typically return no rows anywhere — those are checked against the dataset's own published rows and dropped, a check that also reads the data endpoint and so needs the key; without a working key the dictionary list comes back unchecked, and the response source field says whether that check ran. The dictionary lists run to thousands of codes and are best narrowed with query. Pass the returned code as the dimension's value in predicates.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_query_dataQuery a Census dataset for one or more variables at one geography, a list of geographies at the same level, or every geography at a level.1 finding

    Why it is in this group

    • The name "census_query_data" says "query": a word for reading.

    Findings

    • Info

      The description is 2,237 characters long, over the 2,000 this check looks for.

      Matched text

      description ends: "...ngside its July estimate, and each row carries a record field saying which it is."

      What this check looks for
    Description, as the server wrote it
    Query a Census dataset for one or more variables at one geography, a list of geographies at the same level, or every geography at a level. Pass group with a table ID (e.g. "B01001") to retrieve every column of one table in a single call, beside or in place of variables and outside the 49-code limit. Accepts FIPS codes for the target geography — use census_resolve_geography to convert place names to FIPS when needed. On ACS datasets, labeled estimates and margin-of-error values are returned together (the comparison profiles publish no margins), and the negative sentinel values the Census writes for an estimate or margin of error it cannot publish are decoded into the meanings the Census gives them rather than passed through as raw numbers. A value cbp, ecnbasic, or nonemp withheld is stored as 0 beside a flag, and is reported as withheld, with the meaning of its flag, rather than as a zero. Pass geography_fips as "*" for every geography at the level within the parent, or as a comma-separated list of codes ("06,53") for several: rows come back in GEOID order, up to limit per call (default 50, max 500), with totalCount giving how many matched and offset reaching the rest — the order is not a ranking, so use census_compare_geographies to rank. The notice names any listed code that no row came back for. On the business datasets (cbp, ecnbasic, nonemp), pep/charv, dec/ddhca, dec/ddhcb, and acs/acs1/spp, use predicates to filter by industry, size class, or population group — a query that omits one is answered with a default the Census API picks, which is an all-categories total on some dimensions and a single category on others. Each row names the defaults that were applied in applied_filters, and census_list_predicate_values enumerates the codes a dimension accepts. Some dec/ddhca and dec/ddhcb tables split the population groups between them, publishing each group at a geography in only one table of the family, so where a result can be missing a group, a geography, or a value, the notice names the sibling tables to look in. One geography can also come back on more than one row: pep/charv publishes an April estimates base alongside its July estimate, and each row carries a record field saying which it is.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_resolve_geographyResolve a place name, ZIP code, or street address to Census FIPS identifiers.No findings

    Why it is in this group

    • The name "census_resolve_geography" says "resolve": a word for reading.
    Description, as the server wrote it
    Resolve a place name, ZIP code, or street address to Census FIPS identifiers. Converts names like "King County, WA", "Seattle, WA", or "Seattle-Tacoma-Bellevue, WA", and ZIPs like "98109", to the codes required by census_query_data and census_compare_geographies. Use before querying when you have a place name rather than raw FIPS codes — state_fips maps to parent_fips and fips_summary maps to geography_fips in downstream tools, and geography_type is itself the geography_level to query at.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • census_search_variablesSearch Census variables by keyword across variable labels and concept groups, or look one up by its code.No findings

    Why it is in this group

    • The name "census_search_variables" says "search": a word for reading.
    Description, as the server wrote it
    Search Census variables by keyword across variable labels and concept groups, or look one up by its code. Returns variable codes with human-readable labels — use this to go from a concept like "median household income" to the variable code B19013_001E needed for data queries. A query that is one variable or table code, such as B19013_001E or B19013, returns that variable or the table's variables, in code order, ahead of any keyword matches; a code the dataset does not publish gets a notice naming the dataset that does, when one is confirmed. To retrieve every column of a table, pass its ID to census_query_data as group rather than listing its codes. On ACS datasets it returns both estimate (E suffix) and margin-of-error (M suffix) codes so you can request both; the ACS comparison profiles (acs/acs5/cprofile, acs/acs1/cprofile) and the other dataset families publish no margins of error. Also use it to find the predicate codes a dataset filters on, such as NAICS2017 in cbp. Adding a word narrows the results, since every word must match. Use offset to continue the same search beyond limit; nextOffset names the next page.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.

Reads private data1
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write1
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 20, 2026, 19:27 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
0
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
not observed
RFC 9728 protected resource metadata
not observed
Authorization servers
not observed
Legacy HTTP+SSE transport
no
Dynamic client registration
not observed
Client ID metadata documents
not observed

Findings

Matches of fixed checks, with the text they matched.

1 info
  • The description is 2,237 characters long, over the 2,000 this check looks for.

    Matched text

    description ends: "...ngside its July estimate, and each row carries a record field saying which it is."

    What this check looks for

History

Changes to its tool definitions and to its remote endpoint, newest first.

  1. Tools5 changed.~5 changedView diff
  2. Tools3 changed.~3 changedView diff
  3. Tools3 changed.~3 changedView diff

Install

Pinned to version 0.8.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http census https://census.caseyjhand.com/mcp
claude mcp add --transport http census https://census.caseyjhand.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__census__census_list_datasets",
      "mcp__census__census_list_geographies",
      "mcp__census__census_search_variables",
      "mcp__census__census_get_variable",
      "mcp__census__census_list_predicate_values",
      "mcp__census__census_resolve_geography",
      "mcp__census__census_query_data",
      "mcp__census__census_compare_geographies"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as census. Review it before you use it.

Capability tags behind 2 rules
  • mcp__census__census_list_datasets untrusted-input
  • mcp__census__census_get_variable private-data

Pin

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://radar.anlyon.com/api/v1/servers/io.github.cyanheads/census-mcp-server/verify?hash=6b2098ef135536fe4cc0fc34351f2acec84c786bf3367df3d29d05282741f4c1" | jq -e '.changed == false'

Pinned hash 6b2098ef1355, from Nov 16, 2026, 07:18 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://radar.anlyon.com/servers/io.github.cyanheads/census-mcp-server/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.github.cyanheads/census-mcp-server
[![Anlyon Radar](https://radar.anlyon.com/badge/io.github.cyanheads/census-mcp-server.svg)](https://radar.anlyon.com/servers/io.github.cyanheads/census-mcp-server)

Source: MCP Registry · repository. Synced Nov 16, 2026, 07:17 UTC.

census-mcp-server: questions and answers

Answered from the scan above, not from the publisher's description.

Is the census-mcp-server safe?

No scan can promise that. What its definitions show: 8 tools, all of which only read, and 1 finding from fixed checks. Read-only tools can still pass private data to a model.

Can the census-mcp-server delete data?

No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.

Can the census-mcp-server do things that cannot be undone?

No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.

What tools does the census-mcp-server have?

8 tools: 8 read. census_list_datasets, census_list_geographies, census_search_variables, census_get_variable, census_list_predicate_values, census_resolve_geography, census_query_data and census_compare_geographies.

Does the census-mcp-server need sign-in or OAuth?

Its remote endpoint listed its tools to an anonymous client, without sign-in.

Does the census-mcp-server send data to outside services?

None of its tools sends, posts or publishes, or takes a recipient, channel or URL.

Has the census-mcp-server changed its tools?

Yes, 3 times since Anlyon Radar started tracking it, most recently on Nov 16, 2026. Every change is on this page and in its Atom feed.