PSGC MCP Server

Name: PSGC MCP Server
Author: GodModeArch

@GodModeArch

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.

#tpyescript #mcp #psgc-mcp #geographic-data #philippines #psgc

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

GodModeArch

投稿者

GodModeArch

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "psgc": {
      "url": "https://psgc.godmode.ph/mcp"
    }
  }
}

ツール

Fetch 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

概要

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