Philippine Standard Geographic Code Mcp Server
@johndavedecano
A Model Context Protocol (MCP) server that provides access to the Philippine Standard Geographic Code (PSGC) API, offering hierarchical geographic data for the Philippines.
概览
What is Philippine Standard Geographic Code Mcp Server?
A Model Context Protocol (MCP) server that provides access to the Philippine Standard Geographic Code (PSGC) API, offering hierarchical geographic data for the Philippines. It is intended for developers and applications needing to look up or validate Philippine administrative divisions.
How to use Philippine Standard Geographic Code Mcp Server?
Install globally via npm install -g psgc-mcp and configure any MCP client (e.g., Cursor, Claude Desktop) with command: "npx", args: ["-y", "psgc-mcp"], transport: "stdio". Invoke tools such as get_regions, search_by_name, or get_hierarchy to query geographic data.
Key features of Philippine Standard Geographic Code Mcp Server
- Complete geographic hierarchy (island groups to barangays)
- Search geographic entities by name across all levels
- Validate PSGC codes and retrieve hierarchy information
- Real‑time access to the official PSGC API
- Type‑safe data structures (TypeScript)
Use cases of Philippine Standard Geographic Code Mcp Server
- List all regions and their provinces
- Find all barangays within a specific city
- Validate a PSGC code to confirm an administrative division
- Search for a city or municipality by name
- Retrieve the full hierarchy for a given geographic code
FAQ from Philippine Standard Geographic Code Mcp Server
Which PSGC code formats are supported?
Codes follow hierarchical formats: island groups (e.g., 010000000), regions (130000000), provinces (133900000), cities/municipalities (133903000), and barangays (133903001).
How do I install Philippine Standard Geographic Code Mcp Server?
Install globally via npm with npm install -g psgc-mcp, then configure your MCP client with command: "npx", args: ["-y", "psgc-mcp"] and transport: "stdio".
What are the runtime requirements?
Node.js 18 or higher and npm or yarn.
Where does the geographic data come from?
The server connects directly to the official PSGC API at https://psgc.gitlab.io/api/ for real‑time data.
