Skip to content Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
Psgc MCP server | PlugMCP
Skip to content From the publisher
Documentation PSGC 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.
Features
Complete Geographic Hierarchy : Access to island groups, regions, provinces, cities, municipalities, barangays, and districts
Philippine Standard Geographic Code MCP Server
Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
Search Capabilities : Find geographic entities by name across all levels
Code Validation : Validate PSGC codes and get complete hierarchy information
Real-time Data : Direct access to the official PSGC API
Type-safe : Built with TypeScript for reliable data structures
Installation
From NPM (Published Package)
Configuration for MCP Clients
Cursor/Windsurf Add to your MCP configuration file:
{
"mcpServers": {
"psgc-mcp": {
"command": "npx",
"args": ["-y", "psgc-mcp"],
"transport": "stdio"
}
}
}
Claude Desktop Add to your Claude Desktop configuration:
{
"mcpServers": {
"psgc-mcp": {
"command": "npx",
"args": ["-y", "psgc-mcp"],
"transport": "stdio"
}
}
}
Local Development
Clone the repository
Install dependencies: npm install
Build the project: npm run build
Run locally: npm start
Available Tools The server provides a comprehensive set of tools for accessing PSGC data, categorized by geographic level.
Island Group Tools
get_island_groups: List all island groups.
get_island_group: Get a specific island group by its code (e.g., "luzon").
get_island_group_regions: Get all regions within a specific island group.
get_island_group_provinces: Get all provinces within a specific island group.
get_island_group_districts: Get all districts within a specific island group.
get_island_group_cities: Get all cities within a specific island group.
get_island_group_municipalities: Get all municipalities within a specific island group.
get_island_group_cities_municipalities: Get all cities and municipalities within a specific island group.
get_island_group_sub_municipalities: Get all sub-municipalities within a specific island group.
get_island_group_barangays: Get all barangays within a specific island group.
Region Tools
get_regions: List all regions.
get_region: Get a specific region by its code (e.g., "130000000").
get_region_provinces: Get all provinces within a specific region.
get_region_districts: Get all districts within a specific region.
get_region_cities: Get all cities within a specific region.
get_region_municipalities: Get all municipalities within a specific region.
get_region_cities_municipalities: Get all cities and municipalities within a specific region.
get_region_sub_municipalities: Get all sub-municipalities within a specific region.
get_region_barangays: Get all barangays within a specific region.
Province Tools
get_provinces: List all provinces.
get_province: Get a specific province by its code (e.g., "012800000").
get_province_cities: Get all cities within a specific province.
get_province_municipalities: Get all municipalities within a specific province.
get_province_cities_municipalities: Get all cities and municipalities within a specific province.
get_province_sub_municipalities: Get all sub-municipalities within a specific province.
get_province_barangays: Get all barangays within a specific province.
District Tools
get_districts: List all districts.
get_district: Get a specific district by its code (e.g., "133900000").
get_district_cities: Get all cities within a specific district.
get_district_municipalities: Get all municipalities within a specific district.
get_district_cities_municipalities: Get all cities and municipalities within a specific district.
get_district_sub_municipalities: Get all sub-municipalities within a specific district.
get_district_barangays: Get all barangays within a specific district.
City Tools
get_cities: List all cities.
get_city: Get a specific city by its code (e.g., "012805000").
get_city_barangays: Get all barangays within a specific city.
Municipality Tools
get_municipalities: List all municipalities.
get_municipality: Get a specific municipality by its code (e.g., "012801000").
get_municipality_barangays: Get all barangays within a specific municipality.
Sub-Municipality Tools
get_sub_municipalities: List all sub-municipalities.
get_sub_municipality: Get a specific sub-municipality by its code (e.g., "133901000").
get_sub_municipality_barangays: Get all barangays within a specific sub-municipality.
Combined City/Municipality Tools
get_cities_municipalities: List all cities and municipalities.
get_city_municipality: Get a specific city or municipality by its code.
get_city_municipality_barangays: Get all barangays within a specific city or municipality.
Barangay Tools
get_barangays: List all barangays.
get_barangay: Get a specific barangay by its code (e.g., "012805001").
Search and Discovery Tools
search_by_name: Search for geographic entities by name across all levels.
get_hierarchy: Get the complete hierarchy for a specific PSGC code.
validate_code: Validate if a geographic code exists and get its details.
Available Resources
Static Data : Access pre-loaded static data for all geographic levels.
Dynamic Queries : Perform parameterized queries to fetch specific datasets.
Hierarchical Data : Use resource templates to retrieve complete hierarchical information for any given PSGC code.
Available Templates (Prompts)
Common Queries : Use pre-defined prompts for common geographic questions (e.g., "What is the capital of [province]?").
Guided Discovery : Interactive prompts to help you explore the geographic hierarchy.
Data Validation : Prompts to validate PSGC codes and geographic names.
Usage Examples
Get All Regions {
"tool": "get_regions",
"arguments": {}
}
Get Provinces in a Region {
"tool": "get_provinces",
"arguments": {
"region_code": "130000000"
}
}
Search by Name {
"tool": "search_by_name",
"arguments": {
"query": "Manila",
"type": "city"
}
}
Get Complete Hierarchy {
"tool": "get_hierarchy",
"arguments": {
"code": "133900000"
}
}
API Reference The server connects to the official PSGC API at https://psgc.gitlab.io/api/.
PSGC Code Format PSGC codes follow a hierarchical format:
Island Groups : 010000000, 020000000, 030000000
Regions : 130000000 (NCR), 140000000 (CAR), etc.
Provinces : 133900000 (Manila), 137400000 (Cebu), etc.
Cities/Municipalities : 133903000 (Manila City), 137404000 (Cebu City), etc.
Barangays : 133903001 (Barangay 1, Manila), etc.
Development
Prerequisites
Node.js 18 or higher
npm or yarn
Setup git clone https://github.com/your-username/psgc-mcp.git
cd psgc-mcp
npm install
Build
Development Mode
Testing
Inspect with MCP Inspector
Contributing
Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes
Add tests for new functionality
Run tests: npm test
Commit your changes: git commit -am 'Add feature'
Push to the branch: git push origin feature-name
Submit a pull request
License MIT License - see LICENSE file for details.
Support
Directory score 10/100 Listed 10 of 10
In the official MCP Registry 0 of 18
Claimed by its maintainer 0 of 8
Answers with a tool list 0 of 12
GitHub stars 4 of 16
Weekly downloads 0 of 10
Public Apis A collective list of free APIs Pipeworx Gateway Live data for AI agents. 250+ data sources, 900+ tools. Ask questions in plain English with ask_pipeworx — trade flows, SEC filings, drug safety, housing data, and more. No API keys needed. Rea Reverse engineer anything with agents, from app behavior down to native binaries. Coding Interview University A complete computer science study plan to become a software engineer. Skills Skills for Real Engineers. Straight from my .agents directory. Hermes Agent The agent that grows with you SparkForge Access a versatile collection of tools for media generation, web scraping, and cryptocurrency research. Convert between data formats, summarize long documents, and extract text from images or PDFs wit N8n Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations. Awesome Go A curated list of awesome Go frameworks, libraries and software Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Agency Agents A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, a The Art Of Command Line Master the command line, in one page agent-browser Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web a azure-aigateway Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailb
No tool list yet. Remote servers get one after the first health check.
How do I install Psgc? Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Psgc need an API key? No required environment variable is listed on this record.
What transport does Psgc use? Psgc runs locally over stdio.
When was Psgc last checked? Last checked 2026-10-27. Philippine Standard Geographic Code MCP Server
azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l Tools have descriptions 0 of 6