How often is the data updated?
Data is sourced from the PSA’s quarterly PSGC publication and cached in Cloudflare KV. If data appears stale, users can open an issue to request an unscheduled refresh.
P
PSGC MCP Server
@GodModeArch
Basic information
About PSGC MCP Server
A Model Context Protocol server that provides Philippine Standard Geographic Code (PSGC) data to LLMs. Built on Cloudflare Workers with KV storage.
PSGC MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"psgc": {
"url": "https://psgc.godmode.ph/mcp"
}
}
}PSGC MCP Server tools
7Fetch a geographic entity by its 10-digit PSGC code
Search entities by name with optional level filter and strict mode
Get the full administrative chain (barangay to region)
List direct children of a parent entity
List all entities at a given geographic level
Look up multiple entities in one call (max 50 codes)
Query entities by population range with sorting and filtering
Overview
What is PSGC MCP Server?
A Model Context Protocol (MCP) server that provides Philippine Standard Geographic Code (PSGC) data to LLMs. Built on Cloudflare Workers with KV storage, it is public, read-only, and requires no authentication. Data is sourced from the Philippine Statistics Authority (PSA) quarterly publication.
How to use PSGC MCP Server?
Add the server URL https://psgc.godmode.ph/mcp to your MCP client configuration. No authentication or API key is needed. Use the available tools (e.g., lookup, search, get_hierarchy) via standard MCP calls. A quick test with curl is provided in the README.
Key features of PSGC MCP Server
- 8 tools: lookup, search, hierarchy, children, by type, batch, population query
- Data includes regions, provinces, cities, municipalities, and barangays
- Public, read-only, no authentication required
- Built on Cloudflare Workers for low-latency global access
- Supports strict search and batch operations (up to 50 codes)
- All responses wrapped in metadata envelope with dataset version
Use cases of PSGC MCP Server
- Look up any geographic entity by its 10-digit PSGC code
- Search for places by name with optional level filter and strict mode
- Get the full administrative chain from barangay to region
- Query entities by population range (e.g., largest cities in a region)
- Batch lookup of multiple PSGC codes in a single request
Frequently asked questions
Do I need authentication or an API key?
No. The server is public, read-only, and requires no authentication. Simply point your MCP client to the URL.
What geographic levels are available?
Eight levels: Reg (18), Prov (82), Dist (4), City (149), Mun (1,493), SubMun (16), SGU (~8), and Bgy (~42,000). Special cases include NCR districts and BARMM Special Geographic Units.
How are response data structured?
All data responses are wrapped in `{ _meta, data }` where `_meta` includes dataset version, date, source, and last synced timestamp. Error responses are returned as plain text without wrapping.
What is the PSGC code format?
A 10-digit code with leading zeros significant. Segments encode region, province, city/municipality, and barangay. The README documents known edge cases (e.g., NCR districts, Cotabato City, BARMM SGUs).
More Other MCP servers
Health by Dr Brad
Dr Brad StanfieldHealth by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
14.8K
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
Klarix Intelligence Engine
KlarixB2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
Comments