xmpuspus/ph-civic-data-mcp

> Philippine civic data as agent-callable tools. The full PSA OpenSTAT
> statistical catalog, PSGC location codes, infra-spending accountability,
> earthquakes, weather, typhoons, procurement, poverty, solar radiation, air
> quality, satellite vegetation, and macro indicators. Population figures
> reach barangay level. 41 tools, no API keys.
Philippine civic-data portals publish open data in different shapes: scraped
HTML tables, PXWeb JSON, and undocumented APIs. Nothing ties them together for
an agent to use. This server does, over stdio, with zero hosting cost and no
API key needed. It answers questions such as how many people live in a
barangay, whether a place sits near an active fault or volcano, what a city
spent on flood control, and how one place compares against another.
All data comes from public records. Heuristic indicators are statistical
only. A specific allegation needs independent investigation and a second
source.
Install
Every client below runs the same package, uvx ph-civic-data-mcp, over
stdio.
**Claude Desktop.** Add this to claude_desktop_config.json, which sits at
~/Library/Application Support/Claude/claude_desktop_config.json on macOS:
**Claude Code.**
**Codex.** Confirmed live on 2026-09-03.
**Cursor.** Add this to mcp.json:
**VS Code.** Add this to .vscode/mcp.json:
**Docker.** Build once, then run with -i for stdio:
The image runs as a non-root user and ships a healthcheck.
That recording is vhs docs/demo_setup.tape. It spawns Claude Code with
--mcp-config pointed at this server, and Claude fans out to
get_weather_forecast and get_population_stats, then correlates them. The
temperatures and the population are what the live sources returned while it
recorded. The population turn answers from the 2024 Census of Population
(NCR: 14,001,751 as of 1 July 2024).
What can I ask?
ph-civic-data-mcp exposes 41 tools across 19 public sources. Start with
get_area_profile for any place-based question. It resolves the name to a
PSGC code once, then composes demographics, economy, procurement, hazards,
and the 3-day outlook in a single turn, with infra notices already normalized
per 100,000 residents.
Get a place at a glance
- "Give me a profile of Tacloban." get_area_profile
- "What is the PSGC code for QC?" resolve_ph_location
- "How many people live in Zamboanga City?" get_population_stats
- "What is the poverty rate in Eastern Visayas?" get_poverty_stats
- "Is it safe in Albay right now?" assess_area_risk
- "List the cities in Cebu province." list_admin_units
- "Show the full admin hierarchy above this barangay." get_location_hierarchy
Compare two or more places
- "Compare Cebu City and Davao City on population and poverty." compare_areas
- "How does Zamboanga's employment rate compare to Cagayan de Oro's?" compare_areas
- "Export a five-city comparison as a CSV file." compare_areas
Check hazards near a place
- "Any earthquakes near Legazpi in the last day?" get_latest_earthquakes
- "Read the full PHIVOLCS bulletin for that quake." get_earthquake_bulletin
- "What is Mayon's current alert level?" get_volcano_status
- "Is a typhoon active in the Philippine area right now?" get_active_typhoons
- "Cross-check that quake against the USGS global feed." get_usgs_earthquakes_ph
- "What is the river flood outlook for Cagayan de Oro this week?" get_flood_forecast
- "Which typhoons have passed near Samar since 1990?" get_historical_typhoons_ph
Search procurement and spending
- "Search every PhilGEPS notice for road repair." search_procurement
- "Search PhilGEPS for flood control projects in Pampanga." search_infra_projects
- "Summarize infra spending in Bicol for 2025." summarize_infra_spending
- "How much procurement activity is there in Region VII?" get_procurement_summary
- "Flag PhilGEPS notices in Cebu that warrant a closer look." flag_infra_anomalies
- "Pull the full notice for one flagged project." get_infra_project
Query the PSA statistical catalog
- "Find PSA tables that mention fertility." search_psa_catalog
- "Walk me through the poverty subject on OpenSTAT." browse_psa_catalog