Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
U.S. government economic data (FRED, BLS, BEA, Census, Treasury and more), cited and audited.
Texto original del autor
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala US Government Data Analyst. Sigue https://mcp.popnx.com/i/zsu-data-analyst-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 21 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server US Government Data Analyst para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "data-analyst": { "command": "npx", "args": [ "-y", "data-analyst-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de US Government Data Analyst aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"data-analyst": {
"command": "npx",
"args": [
"-y",
"data-analyst-mcp"
]
}
}
}Usa US Government Data Analyst y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando US Government Data Analyst o muestra una herramienta de US Government Data Analyst en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
DATA_GOV_API_KEY Clave gratuita de api.data.gov (Congress.gov, FDA, FEC, GovInfo y otros 6); opcional FRED_API_KEY Clave gratuita de FRED para búsqueda, vintages y GeoFRED; opcional BLS_API_KEY Clave gratuita de BLS para límites más altos y promedios anuales; opcional BEA_API_KEY Clave gratuita de BEA para los conjuntos de datos solo de API; opcional CENSUS_API_KEY Clave gratuita de Census; sin ella, Census ofrece una descarga manual; opcional Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar US Government Data Analyst
US Government Data Analyst se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar US Government Data Analyst
B · Otros en Derecho y datos públicos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server US Government Data Analyst para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user data-analyst -- npx -y data-analyst-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de US Government Data Analyst aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user data-analyst -- npx -y data-analyst-mcpDeberías ver US Government Data Analyst en la lista como conectado
Usa US Government Data Analyst y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando US Government Data Analyst o muestra una herramienta de US Government Data Analyst en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
DATA_GOV_API_KEY Clave gratuita de api.data.gov (Congress.gov, FDA, FEC, GovInfo y otros 6); opcional FRED_API_KEY Clave gratuita de FRED para búsqueda, vintages y GeoFRED; opcional BLS_API_KEY Clave gratuita de BLS para límites más altos y promedios anuales; opcional BEA_API_KEY Clave gratuita de BEA para los conjuntos de datos solo de API; opcional CENSUS_API_KEY Clave gratuita de Census; sin ella, Census ofrece una descarga manual; opcional Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server US Government Data Analyst para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "data-analyst": { "command": "npx", "args": [ "-y", "data-analyst-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de US Government Data Analyst aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa US Government Data Analyst y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando US Government Data Analyst o muestra una herramienta de US Government Data Analyst en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
DATA_GOV_API_KEY Clave gratuita de api.data.gov (Congress.gov, FDA, FEC, GovInfo y otros 6); opcional FRED_API_KEY Clave gratuita de FRED para búsqueda, vintages y GeoFRED; opcional BLS_API_KEY Clave gratuita de BLS para límites más altos y promedios anuales; opcional BEA_API_KEY Clave gratuita de BEA para los conjuntos de datos solo de API; opcional CENSUS_API_KEY Clave gratuita de Census; sin ella, Census ofrece una descarga manual; opcional Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server US Government Data Analyst para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "data-analyst": { "type": "stdio", "command": "npx", "args": [ "-y", "data-analyst-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de US Government Data Analyst aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa US Government Data Analyst y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando US Government Data Analyst o muestra una herramienta de US Government Data Analyst en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
DATA_GOV_API_KEY Clave gratuita de api.data.gov (Congress.gov, FDA, FEC, GovInfo y otros 6); opcional FRED_API_KEY Clave gratuita de FRED para búsqueda, vintages y GeoFRED; opcional BLS_API_KEY Clave gratuita de BLS para límites más altos y promedios anuales; opcional BEA_API_KEY Clave gratuita de BEA para los conjuntos de datos solo de API; opcional CENSUS_API_KEY Clave gratuita de Census; sin ella, Census ofrece una descarga manual; opcional Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user data-analyst -- npx -y data-analyst-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"data-analyst": {
"command": "npx",
"args": [
"-y",
"data-analyst-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"data-analyst": {
"command": "npx",
"args": [
"-y",
"data-analyst-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"data-analyst": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"data-analyst-mcp"
]
}
}
}DATA_GOV_API_KEY secreto envFRED_API_KEY secreto envBLS_API_KEY secreto envBEA_API_KEY secreto envCENSUS_API_KEY secreto envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: data-analyst-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 21 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub zsu, dueña del repo
Último cambio de código: hoy
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para data-analyst-mcp@0.11.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 21 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/zsu-data-analyst-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hoy, y la última versión (0.11.2) llegó al registro hoy.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French, European, Swiss, Belgian, Luxembourg, Dutch and African case law and legal texts.
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| Este US Government Data Analyst | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Licencia | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
data-analyst-mcp)A Model Context Protocol (MCP) server for U.S. economic analysis and official U.S. government data across 77 federal agencies (FRED, BLS, BEA, Census, Treasury, Congress.gov, FDA, CDC, EPA, and more).
Requires Node.js 22 or later. Most sources need no key, so steps 2 and 3 are optional.
Claude Code
claude mcp add data-analyst -- npx -y data-analyst-mcp
Add --scope user to make it available in every project. To pass a key here, put -e before the --, for example claude mcp add data-analyst -e DATA_GOV_API_KEY=your-key -- npx -y data-analyst-mcp.
Claude Desktop: claude_desktop_config.json, in ~/Library/Application Support/Claude/ (macOS) or %APPDATA%\Claude\ (Windows). Settings → Developer → Edit Config opens it. Restart Claude Desktop after editing.
{
"mcpServers": { "data-analyst": { "command": "npx", "args": ["-y", "data-analyst-mcp"], "env": { "DATA_GOV_API_KEY": "your-key" } } } }
Cursor: the same mcpServers block in ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project).
VS Code: .vscode/mcp.json uses servers instead of mcpServers. An inputs entry makes VS Code ask for the key once and store it, so the key is not written into a file you might commit.
{
"inputs": [ { "type": "promptString", "id": "data-gov-key", "description": "api.data.gov API key", "password": true } ], "servers": { "data-analyst": { "type": "stdio", "command": "npx", "args": ["-y", "data-analyst-mcp"], "env": { "DATA_GOV_API_KEY": "${input:data-gov-key}" } } } }
Codex: ~/.codex/config.toml
[mcp_servers.data-analyst]
command = "npx" args = ["-y", "data-analyst-mcp"]
[mcp_servers.data-analyst.env] DATA_GOV_API_KEY = "your-key"
Leave out the env block if you have no keys, or if you store them with setup (step 2).
To run from a clone instead of npm, build it and point the client at the build:
git clone https://github.com/zsu/data-analyst-mcp.git
cd data-analyst-mcp && npm install && npm run build
Then use "command": "node", "args": [" /data-analyst-mcp/dist/bin/cli.js"] in the configs above, and node dist/bin/cli.js setup in place of npx -y data-analyst-mcp setup below.
Each key is free. Without a key, a source either falls back to a keyless route with lower limits, or offers a manual download (manual_bundle): the user downloads the files in a browser, and the server packages them.
| Variable | Sources | Without it | Free key |
|---|---|---|---|
AQS_API_KEY + AQS_EMAIL | epa-aqs | manual download only | aqs.epa.gov |
BEA_API_KEY | bea | bulk files for the main tables; the API-only datasets need the key | apps.bea.gov |
BLS_API_KEY | bls | 25 queries a day, 25 series and 10 years each; no annual averages or catalog titles | data.bls.gov |
CENSUS_API_KEY | census | manual download only | api.census.gov |
DATA_GOV_API_KEY | college-scorecard, congress, fbi, fda, fec, govinfo, nrel, regulations, usda-fooddata, usgs | DEMO_KEY or keyless, at a few requests an hour (fda: 1,000 a day; usgs earthquakes never need a key) | api.data.gov |
DOL_API_KEY | dol | catalog and field lists only; data queries need the key | dataportal.dol.gov |
EIA_API_KEY | eia | DEMO_KEY, about 10 requests an hour | eia.gov |
FRED_API_KEY | fred | observations only; search, vintages, revision history and GeoFRED need the key | fredaccount.stlouisfed.org |
HUD_USER_TOKEN | hud | manual download only | huduser.gov |
IPUMS_API_KEY | ipums | build the extract on the IPUMS website (free account) | account.ipums.org |
LDA_API_KEY | senate-lobbying | 15 requests a minute instead of 120 | lda.gov |
NOAA_API_KEY | noaa | the keyless data and station-search endpoints; Climate Data Online v2 needs the key | ncei.noaa.gov |
USDA_NASS_API_KEY | usda-nass | manual download only | quickstats.nass.usda.gov |
USPTO_API_KEY | uspto | manual download only | data.uspto.gov |
Two settings are not keys. SEC asks every client to identify itself, so set SEC_USER_AGENT to your name and email ("Jane Doe jane@example.com"). NWS_USER_AGENT is optional and does the same for the weather service.
Store a key with `setup` (recommended). It shows the signup link, reads the key with hidden input, and writes it to ~/.config/data-analyst/keys.json. The key stays out of client config files, and every client reads it. It works mid-session, with no restart.
npx -y data-analyst-mcp setup congress
setup takes any source that uses the key: setup congress stores DATA_GOV_API_KEY, and all 10 api.data.gov sources use it. setup epa-aqs also asks for AQS_EMAIL. Or put the variables in the client's env block, as in step 1. API keys lists every place the server looks.
Ask your assistant: *"Is my api.data.gov key set up?"* The check_key tool reports whether the key was found and where, never its value. For census, eia, epa-aqs, noaa, usgs, bea, fred and ipums it also tests the key with one small call to the agency's own site and says whether it was accepted, rejected or the site could not be reached. To list only the sources you can use, start the server with --hide-unconfigured (see Options).
The assistant asks the questions that change the answer first (which measure, which years, which population), then fetches, computes and cites.
To host the server for claude.ai or a team, see docs/hosting.md.
| Tool | What it does |
|---|---|
guide | the method: framing, asking only critical questions, the accuracy checklist, combining sources |
find_sources | ranks the sources for a question, or lists them all |
source_brief | one source's playbook, its questions_to_ask, key status, rules and request index |
request_schema | full parameters of the requests to use; searches a source's catalog |
record_decisions | how each critical question was settled (answered, Don't know, skipped, not asked and why) |
fetch | downloads into the session workspace; returns a summary, the files, the citation and notes |
manual_bundle, ingest | a one-command download for the user's own computer, then packaging what they downloaded |
compute | builds exhibits from the full tables with declarative steps (a whitelisted expression language, no eval); the steps are recorded for rerun |
facts, write_table, cite | register the numbers cited, write the benchmark and sensitivity tables, snapshot cited pages |
audit_answer, rerun | the release gate: every number in the answer is a registered fact, the method record is complete, and the analysis reproduces |
build_report, style_check, audit_report | an HTML report and replication ZIP, only when asked |
handoff | the per-source data hand-off |
check_key | whether a key is set up (never shows it), and tested live where the source allows |
read_file | a small text file from the workspace |
open_workspace | after a server restart (which starts a new, empty workspace), lists the earlier workspaces and reopens one (local server only) |
Asking before fetching is enforced, not just suggested. fetch returns gate_blocked until, for that source, the model has read source_brief and the schemas of the requests it uses, and has recorded how each critical question was settled. The model asks the questions in chat, in one round. A blocking question that the user skips is asked once more. The server also exposes an analyze prompt and source:// resources, for clients that let users pick prompts or attach resources.
Results have one shape. Success: {status: "ok" | "partial", summary, files, citation, notes}. Failure: {status: "error", code, message, fix, retry_after_s?}. The codes are invalid_request, not_found, not_supported, agency_rejected, agency_unavailable, key_missing, key_rejected, rate_limited, gate_blocked, in_progress and server_error. in_progress comes from a rerun (rerun, or an audit with rerun: true) that needs longer than a client waits for one call: the replay continues in a worker thread, the same call made again waits on that same replay, and the finished result is kept until the workspace changes. DATA_ANALYST_RERUN_WAIT_S sets how long a call waits first (default 45 seconds). The replay gets its own heap, DATA_ANALYST_RERUN_HEAP_MB (default: 60 percent of the memory the process may use, a container's limit when it has one); if it runs out, the audit reports that, and the server keeps running.
| Option (flag / environment) | What it does |
|---|---|
--sources fred,treasury / DATA_ANALYST_SOURCES | serve only these sources |
--domains economy,health / DATA_ANALYST_DOMAINS | serve only the sources in these domains |
--hide-unconfigured / DATA_ANALYST_HIDE_UNCONFIGURED=1 | leave out of listings the sources whose required key is not set up |
--workspace / DATA_ANALYST_WORKSPACE | (stdio) one fixed analysis folder, so a fetch is reused after a restart |
{ "mcpServers": { "data-analyst": { "command": "npx", "args": ["-y", "data-analyst-mcp", "--domains", "economy,health"] } } }
The tool list stays the same size whatever is enabled: sources are found with find_sources, not loaded as tools.
Every result lists its upstream requests (requests: method, credential-free URL, status, cached, time), and citation names the publisher, page and retrieval date. Requests are rate-limited per host (a token bucket), retried with backoff on 429 and 5xx (honoring Retry-After), and kept within each agency's per-minute budgets.
Caching follows each source's terms.
cache.mode: persistent) can be cached on disk in DATA_ANALYST_CACHE (default ~/.cache/data-analyst). census and bea do; opm's terms allow it, but its port downloads again for now.--workspace gives reuse across restarts without keeping copies anywhere else.import { route, brief, fetchSource, compute, registerFacts } from "data-analyst-mcp";
const r = await fetchSource("cdc", { description: "NY deaths 2017", requests: [{ name: "ny", endpoint: "query", params: { dataset: "leading_death", $where: "state = 'New York' AND year = '2017'" } }] }, { out: "./out/ny" }); console.log(r.summary.tables[0].rows, r.citation.text);
listSources, route, brief, requestSchema, fetchSource, ingest, manualBundle, compute,