Skip to main content
Glama
Sign In
Philippine-Geocoding

Philippine-Geocoding

by xiaobenyang-com
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

菲律宾地理编码服务 Philippine Geocoding

提供菲律宾标准地理编码（PSGC）API访问的模型上下文协议（MCP）服务器，包含完整的菲律宾地理层级数据。 A model Context Protocol (MCP) server that provides access to the Philippine Standard Geocoding (PSGC) API, containing complete geographic hierarchical data of the Philippines.## 工具列表 Tool List

本MCP服务封装下列工具，可让模型通过标准化接口调用以下功能。 本MCP服务封装下列工具，可让模型通过标准化接口调用以下功能。

工具 Tool

描述 Description

get_island_groups

List all island groups in the Philippines

get_island_group

Get specific island group by code

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_cities

Get all cities within a specific island group

get_island_group_municipalities

Get all municipalities within a specific island group

get_island_group_barangays

Get all barangays within a specific island group

get_regions

List all regions in the Philippines

get_region

Get specific region by code

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

get_provinces

List all provinces in the Philippines

get_province

Get specific province by code

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

get_cities

List all cities in the Philippines

get_city

Get specific city by code

get_city_barangays

Get all barangays within a specific city

get_municipalities

List all municipalities in the Philippines

get_municipality

Get specific municipality by code

get_municipality_barangays

Get all barangays within a specific municipality

get_barangays

List all barangays in the Philippines

get_barangay

Get specific barangay by code

get_districts

List all districts in the Philippines

get_district

Get specific district by code

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

search_by_name

Search for geographic entities by name across all levels (regions, provinces, cities, municipalities, barangays)

get_hierarchy

Get complete geographic hierarchy for a specific code (shows parent entities)

validate_code

Validate if a geographic code exists and return its type

检查服务 ## Inspector

工具在线测试： https://mcp.xiaobenyang.com/inspector/1777316659371011

Online Tool test https://mcp.xiaobenyang.com/inspector/1777316659371011

Related MCP server: Weather MCP MY

服务配置 MCP Server Config

如何获取 XBY-APIKEY ？ How to get XBY-APIKEY ?

访问小笨羊科技网站 https://xiaobenyang.com，注册用户即可获得APIKEY Visit XiaoBenYang website https://xiaobenyang.com, register and get the APIKEY.

SSE

{
  "mcpServers": {
    "菲律宾地理编码服务": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "sse",
      "url": "https://mcp.xiaobenyang.com/1777316659371011/sse"
    }
  }
}

STREAMABLE HTTP

{
  "mcpServers": {
    "菲律宾地理编码服务": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "streamable_http",
      "url": "https://mcp.xiaobenyang.com/1777316659371011/mcp"
    }
  }
}

STDIO

{
    "mcpServers": {
        "菲律宾地理编码服务": {
          "command": "npx",
          "args": [
            "-y",
            "xiaobenyang-mcp"
          ],
          "env": {
            "XBY_APIKEY": "<YOUR_XBY_APIKEY>",
            "mcpId": "1777316659371011",
          },
          "transport": "stdio"
        }
      }
}

Available Tools

41 tools
get_barangayget_barangayC

Get specific barangay by code

Inputs: code (required).

get_barangaysget_barangaysB

List all barangays in the Philippines

Inputs: no named parameters.

get_citiesget_citiesB

List all cities in the Philippines

Inputs: no named parameters.

get_cityget_cityC

Get specific city by code

Inputs: code (required).

get_city_barangaysget_city_barangaysC

Get all barangays within a specific city

Inputs: cityCode (required).

get_districtget_districtC

Get specific district by code

Inputs: code (required).

get_district_barangaysget_district_barangaysB

Get all barangays within a specific district

Inputs: districtCode (required).

get_district_citiesget_district_citiesC

Get all cities within a specific district

Inputs: districtCode (required).

get_district_cities_municipalitiesget_district_cities_municipalitiesC

Get all cities and municipalities within a specific district

Inputs: districtCode (required).

get_district_municipalitiesget_district_municipalitiesC

Get all municipalities within a specific district

Inputs: districtCode (required).

get_districtsget_districtsB

List all districts in the Philippines

Inputs: no named parameters.

get_district_sub_municipalitiesget_district_sub_municipalitiesC

Get all sub-municipalities within a specific district

Inputs: districtCode (required).

get_hierarchyget_hierarchyC

Get complete geographic hierarchy for a specific code (shows parent entities)

Inputs: code (required).

get_island_groupget_island_groupC

Get specific island group by code

Inputs: code (required).

get_island_group_barangaysget_island_group_barangaysC

Get all barangays within a specific island group

Inputs: islandGroupCode (required).

get_island_group_citiesget_island_group_citiesC

Get all cities within a specific island group

Inputs: islandGroupCode (required).

get_island_group_municipalitiesget_island_group_municipalitiesC

Get all municipalities within a specific island group

Inputs: islandGroupCode (required).

get_island_group_provincesget_island_group_provincesC

Get all provinces within a specific island group

Inputs: islandGroupCode (required).

get_island_group_regionsget_island_group_regionsC

Get all regions within a specific island group

Inputs: islandGroupCode (required).

get_island_groupsget_island_groupsB

List all island groups in the Philippines

Inputs: no named parameters.

get_municipalitiesget_municipalitiesB

List all municipalities in the Philippines

Inputs: no named parameters.

get_municipalityget_municipalityC

Get specific municipality by code

Inputs: code (required).

get_municipality_barangaysget_municipality_barangaysC

Get all barangays within a specific municipality

Inputs: municipalityCode (required).

get_provinceget_provinceC

Get specific province by code

Inputs: code (required).

get_province_barangaysget_province_barangaysC

Get all barangays within a specific province

Inputs: provinceCode (required).

get_province_citiesget_province_citiesC

Get all cities within a specific province

Inputs: provinceCode (required).

get_province_cities_municipalitiesget_province_cities_municipalitiesC

Get all cities and municipalities within a specific province

Inputs: provinceCode (required).

get_province_municipalitiesget_province_municipalitiesC

Get all municipalities within a specific province

Inputs: provinceCode (required).

get_provincesget_provincesB

List all provinces in the Philippines

Inputs: no named parameters.

get_province_sub_municipalitiesget_province_sub_municipalitiesC

Get all sub-municipalities within a specific province

Inputs: provinceCode (required).

get_regionget_regionC

Get specific region by code

Inputs: code (required).

get_region_barangaysget_region_barangaysC

Get all barangays within a specific region

Inputs: regionCode (required).

get_region_citiesget_region_citiesC

Get all cities within a specific region

Inputs: regionCode (required).

get_region_cities_municipalitiesget_region_cities_municipalitiesC

Get all cities and municipalities within a specific region

Inputs: regionCode (required).

get_region_districtsget_region_districtsC

Get all districts within a specific region

Inputs: regionCode (required).

get_region_municipalitiesget_region_municipalitiesC

Get all municipalities within a specific region

Inputs: regionCode (required).

get_region_provincesget_region_provincesC

Get all provinces within a specific region

Inputs: regionCode (required).

get_regionsget_regionsB

List all regions in the Philippines

Inputs: no named parameters.

get_region_sub_municipalitiesget_region_sub_municipalitiesC

Get all sub-municipalities within a specific region

Inputs: regionCode (required).

search_by_namesearch_by_nameB

Search for geographic entities by name across all levels (regions, provinces, cities, municipalities, barangays)

Inputs: name (required), type, limit.

validate_codevalidate_codeC

Validate if a geographic code exists and return its type

Inputs: code (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.1/5.0

    Scored across 41 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes based on geographic entity type and scope, with minimal overlap. However, some tools like get_region_cities_municipalities and get_region_cities/get_region_municipalities could cause confusion about when to use the combined vs. separate versions. The search_by_name and validate_code tools are clearly distinct from the hierarchical retrieval tools.

    Naming Consistency5/5

    All tools follow a perfectly consistent verb_noun pattern with 'get_' prefix for retrieval operations, and entity names are consistently pluralized for lists and singular for specific items. The two non-get tools (search_by_name, validate_code) maintain the same naming convention with clear action prefixes.

    Tool Count2/5

    With 41 tools, this is excessive for a geocoding server. Many tools could be consolidated into parameterized versions (e.g., a single get_entities tool with type and scope parameters). The server feels heavy and overwhelming despite covering a coherent domain.

    Completeness5/5

    The tool surface provides comprehensive coverage of Philippine geographic hierarchy with complete CRUD-like retrieval operations for all entity types (island groups, regions, provinces, districts, cities, municipalities, barangays). It includes both listing and specific retrieval, hierarchical navigation, search, and validation - no obvious gaps exist for the stated geocoding purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • IP Geolocation MCP Server

      briandconnelly
      A
      license
      A
      quality
      F
      maintenance
      A Model Context Protocol server that retrieves detailed geographic information about IP addresses using the ipinfo.io API, helping determine user location and network details.
      5
      172 PyPI
      45
      MIT

    • Weather MCP MY

      yting27
      A
      license
      A
      quality
      D
      maintenance
      Model Context Protocol (MCP) server that provides weather forecast, warnings, water level associated with flood, and earthquake reports from Malaysia Government's Open API.
      4
      1
      MIT

    • psgc-mcp

      GodModeArch
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Philippine Standard Geographic Code (PSGC) API. Gives AI agents structured access to the full PH geographic hierarchy - regions, provinces, cities, municipalities, and barangays.
      17 npm
      MIT

    • ph-civic-data-mcp

      xmpuspus
      A
      license
      A
      quality
      B
      maintenance
      An MCP server providing real-time access to Philippine government data including earthquakes, weather, typhoons, procurement, population, and air quality. It enables AI agents to query multiple official Philippine data sources through a unified interface for research and analysis purposes.
      41
      27 PyPI
      5
      MIT