PSGC MCP Server

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

FAQ from PSGC MCP Server

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.

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).