Philippine Standard Geographic Code Mcp Server
@johndavedecano
About 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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"psgc-mcp": {
"command": "npx",
"args": [
"-y",
"psgc-mcp"
],
"transport": "stdio"
}
}
}Tools
41List all island groups in the Philippines
Get specific island group by code
Get all regions within a specific island group
Get all provinces within a specific island group
Get all cities within a specific island group
Get all municipalities within a specific island group
Get all barangays within a specific island group
List all regions in the Philippines
Get specific region by code
Get all provinces within a specific region
Get all districts within a specific region
Get all cities within a specific region
Get all municipalities within a specific region
Get all cities and municipalities within a specific region
Get all sub-municipalities within a specific region
Get all barangays within a specific region
List all provinces in the Philippines
Get specific province by code
Get all cities within a specific province
Get all municipalities within a specific province
Get all cities and municipalities within a specific province
Get all sub-municipalities within a specific province
Get all barangays within a specific province
List all cities in the Philippines
Get specific city by code
Get all barangays within a specific city
List all municipalities in the Philippines
Get specific municipality by code
Get all barangays within a specific municipality
List all barangays in the Philippines
Get specific barangay by code
List all districts in the Philippines
Get specific district by code
Get all cities within a specific district
Get all municipalities within a specific district
Get all cities and municipalities within a specific district
Get all sub-municipalities within a specific district
Get all barangays within a specific district
Search for geographic entities by name across all levels (regions, provinces, cities, municipalities, barangays)
Get complete geographic hierarchy for a specific code (shows parent entities)
Validate if a geographic code exists and return its type
Overview
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.
Frequently asked questions
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.
Basic information
More Developer Tools MCP servers
CodeSentinel
icohangar-opsCodebase health as MCP tools: dead code, circular dependencies, coupling, architectural drift.
Termany
thinkany-aiAgent-Native Terminal
Reelier
Maxime HouleAgents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.
Vibgrate MCP
VibgrateQuery your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up
CircleCI MCP Server
CircleCIManage CI/CD pipelines, debug failed builds, and optimize test suites directly from your AI agents - no terminal required. The CircleCI MCP Server is a remote server hosted by CircleCI that connects AI tools and agents
Comments