Claude MarketplacesSubmit
darwinphi avatar

PH Schools MCP Server

darwinphi/ph-schools-mcp-server

Connects Claude to the Philippine Department of Education's schools masterlist dataset via five stdio tools: search_schools for filtering by region, division, or keyword; get_school_by_beis_id for direct lookups; list_regions and list_divisions for browsing administrative boundaries; and dataset_stats for quick counts and coverage checks. Runs locally with automatic dataset download on first launch, pinned to a canonical GitHub release tag. Reach for this when building education sector tools, validating school references in Philippine applications, or doing exploratory analysis on DepEd institutional data without standing up a database. Config drops into VS Code or Claude Desktop as a single npx command with an optional local cache path.

tools
5
transport
STDIO
env vars
3
last updated
Apr 11, 2026
View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

search_schools

No parameter schema in public metadata yet.

get_school_by_beis_id

No parameter schema in public metadata yet.

list_regions

No parameter schema in public metadata yet.

list_divisions

No parameter schema in public metadata yet.

dataset_stats

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

PH_SCHOOLS_DATA_PATH

Absolute path to a local schools dataset JSON file.

PH_SCHOOLS_DATA_URL

Optional source URL used by sync-data.

PH_SCHOOLS_DATA_TAG

Optional canonical dataset tag used by sync-data when URL is not provided.

Readme

PH Schools MCP Server

Local stdio MCP server for querying and analyzing the Philippine schools masterlist dataset.

What This Server Provides

Tools:

  1. search_schools
  2. get_school_by_beis_id
  3. list_regions
  4. list_divisions
  5. dataset_stats

Install and Run

npm install
npm start

Use npm start only when running from this repo manually.

Which Setup to Use

  • VS Code MCP (.vscode/mcp.json): enough for normal usage. If status is Running, VS Code already started the server.
  • Claude Desktop (claude_desktop_config.json): enough for normal usage. Restart Claude after config changes.
  • npx -y @darwinphi/ph-schools-mcp-server ...: one-off CLI usage without cloning repo.
  • npm install && npm start: local development/maintenance in this repository.

Usage Scenarios

View the full README on GitHub

Details

Repository
github.com/darwinphi/ph-schools-mcp-server
Package
@darwinphi/ph-schools-mcp-server
Transport
STDIO
Registry
MCP registry, active