mcpField
P
ph-data-mcp-server

ph-data-mcp-server

Local
github.com/CharlieJamesGwapoScience & Education0Updated 1w ago
Repository

About ph-data-mcp-server

ph-data-mcp-server exposes Philippine scholarship and public data to AI assistants. It combines an offline scholarship catalogue with live holiday, regional, school, currency and weather lookups, without requiring an API key.

Key features

  1. 01Search scholarships by question
  2. 02Retrieve scholarship eligibility and benefits
  3. 03Browse scholarships by filters
  4. 04Look up holidays, regions and schools
  5. 05Convert PHP at daily rates
  6. 06Check current weather in major cities

Use cases

  1. 01Find scholarships matching a study level
  2. 02Check Philippine holidays for a year
  3. 03List universities in a region
  4. 04Convert currency or check city weather

MCP support

An MCP server offering read-only tools for scholarship and Philippine public data. Tools support structured JSON output.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "charliejamesgwapo-ph-data": {
      "command": "npx",
      "args": [
        "-y",
        "ph-data-mcp-server"
      ],
      "env": {
        "PH_API_BASE_URL": "<PH_API_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y ph-data-mcp-server
Environment variables to set
PH_API_BASE_URLUse another deployment of the Philippines Public Data API (optional)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmph-data-mcp-server0.1.0

Tools

8

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
levelenumNoOnly return programs for this level (detected from the query if omitted)senior_high | college | graduate | tech_voc
limitintegerNoMaximum number of matches
querystringYesWhat the student is looking for, in English or Taglish
response_formatenumNo'markdown' for readable text (default), 'json' for structured datamarkdown | json

Details

From the project README

🇵🇭 ph-data-mcp-server

An MCP server that gives AI assistants (Claude, Cursor, VS Code Copilot, and others) Philippine data: scholarships, holidays, regions, universities, peso exchange rates and weather.

Ask your assistant things like:

"Incoming college ako, BS Engineering. Anong scholarship pwede?" "Which regular holidays fall on a Monday in 2027?" "List state universities in Region X and the scholarships open to their students."

No API key needed.

Tools

ToolWhat it doesData
ph_search_scholarshipsFind scholarships that match a question (English or Taglish), optionally by levelBundled, offline
ph_get_scholarshipFull eligibility, benefits, period, how to apply, official linkBundled, offline
ph_list_scholarshipsBrowse with filters: level, provider type, regionBundled, offline
ph_list_holidaysRegular and special holidays (2026–2027)Live
ph_list_regionsAll 17 regions with codes and centersLive
ph_list_schoolsUniversities and colleges by region and typeLive
ph_convert_currencyConvert to or from PHP at daily ratesLive
ph_get_weatherCurrent weather in major citiesLive

Every tool is read-only and supports response_format: "json" for structured output.

About the scholarship data: 35 programs (DOST-SEI, CHED, TESDA, OWWA, DSWD, GSIS, DepEd, Quezon City, Davao, Cagayan de Oro, SM, Megaworld, Gokongwei, Security Bank, Aboitiz, DLSU, Ateneo, UST), each checked against the provider's own page. Details the official page doesn't state are null, never guessed. It's the same dataset as Iskolar AI. Programs change every school year, so always confirm on the official page.

The live tools use the free Philippines Public Data API.

Install

Requires Node.js 20.3 or later.

Claude Code

claude mcp add ph-data -- npx -y ph-data-mcp-server

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other clients:

{
  "mcpServers": {
    "ph-data": {
      "command": "npx",
      "args": ["-y", "ph-data-mcp-server"]
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ph-data": { "type": "stdio", "command": "npx", "args": ["-y", "ph-data-mcp-server"] }
  }
}

Docker

docker build -t ph-data-mcp-server .
docker run -i --rm ph-data-mcp-server

Develop

git clone https://github.com/CharlieJamesGwapo/ph-data-mcp-server.git
cd ph-data-mcp-server
npm install
npm run build
npm run smoke                                        # calls every tool through a real MCP client
npx @modelcontextprotocol/inspector node dist/index.js   # interactive testing

PH_API_BASE_URL points the live tools at another deployment of the API.

Releasing
  1. Bump version in package.json, server.json (both places) and src/index.ts.
  2. npm publish (the prepublishOnly script builds first).
  3. mcp-publisher login github then mcp-publisher publish to update the MCP Registry entry.

Contributing

Scholarship fixes and additions are welcome. Edit data/scholarships.json, cite the provider's own page (not a blog or aggregator), and set last_checked to today.

Support

If this is useful, ⭐ star the repo or sponsor the maintainer.

MIT License. Not affiliated with any agency, foundation or school listed.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.