Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ph-data-mcp-server Incoming college ako, BS Engineering. Anong scholarship pwede?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Tool | What it does | Data |
| Find scholarships that match a question (English or Taglish), optionally by level | Bundled, offline |
| Full eligibility, benefits, period, how to apply, official link | Bundled, offline |
| Browse with filters: level, provider type, region | Bundled, offline |
| Regular and special holidays (2026–2027) | Live |
| All 17 regions with codes and centers | Live |
| Universities and colleges by region and type | Live |
| Convert to or from PHP at daily rates | Live |
| Current weather in major cities | Live |
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.
Related MCP server: PH Schools MCP Server
Requires Node.js 20.3 or later.
Claude Code
claude mcp add ph-data -- npx -y ph-data-mcp-serverClaude 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-servergit 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 testingPH_API_BASE_URL points the live tools at another deployment of the API.
Bump version in package.json, server.json (both places) and src/index.ts.
npm publish (the prepublishOnly script builds first).
mcp-publisher login github then mcp-publisher publish to update the MCP Registry entry.
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.
If this is useful, ⭐ star the repo or sponsor the maintainer.
MIT License. Not affiliated with any agency, foundation or school listed.
Convert an amount between currencies using current exchange rates based on the Philippine peso (PHP), e.g. 100 USD to PHP. Rates come from open.er-api.com and update daily.
Inputs: from (required), to, amount, response_format.
Full details of one Philippine scholarship by id (from ph_search_scholarships or ph_list_scholarships): eligibility, benefits, application period, how to apply, official and source URLs, and the date it was last checked. Fields the official page does not state are null.
Inputs: id (required), response_format.
Current weather (temperature, humidity, feels-like, rain, wind) for a major Philippine city, from Open-Meteo. Use a city slug such as "manila", "quezon-city", "cebu-city", "davao-city" or "cagayan-de-oro".
Inputs: city (required), response_format.
Philippine regular and special non-working holidays (currently 2026 and 2027), with date, name and type. Example: "When is Holy Week 2027?" or "regular holidays this year".
Inputs: type, year, response_format.
The 17 regions of the Philippines with code (e.g. NCR, R10, BARMM), name, island group and regional center. Use the codes as the region filter in ph_list_schools.
Inputs: island_group, response_format.
Browse the full curated list of Philippine scholarships with optional filters (level, provider type, region). Use ph_search_scholarships instead when you have a specific question.
Inputs: level, limit, offset, region, +2 more.
Philippine universities and colleges with code, type (e.g. State, Private), city and region. Filter by region code from ph_list_regions (e.g. "R10") and by type (e.g. "State"). Partial coverage, not every school.
Inputs: type, limit, offset, region, +1 more.
Find Philippine scholarships and student financial aid that match a question, in English or Taglish (e.g. "incoming college, BS Engineering", "anak ng OFW", "TESDA courses", "grad school science"). Searches a curated list of programs (DOST, CHED, TESDA, OWWA, LGUs, foundations, universities) where every fact was checked against the official page. Returns the best matches with summary, period and official URL. Use ph_get_scholarship for full eligibility and benefits. Never state amounts or deadlines the results do not contain.
Inputs: query (required), level, limit, response_format.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 8 tools
Each tool targets a distinct resource+action (currency conversion, weather, holidays, regions, schools, and three scholarship operations) with no true duplicates. The potential list_scholarships vs search_scholarships overlap is explicitly resolved in the descriptions, which tell the agent which to use when.
All eight tools follow a uniform ph_verb_noun snake_case pattern (ph_convert_currency, ph_get_weather, ph_list_regions, ph_search_scholarships). The shared ph_ prefix reinforces the server's domain scope without breaking the verb_noun convention.
Eight tools sit comfortably in the well-scoped 3-15 range, and each maps to a distinct Philippine data need. No tool feels like filler or a redundant variant.
Scholarships get full lifecycle coverage (list, search, get) and the other domains have sensible entry points. Minor gaps remain: schools and regions are list-only with no detail lookup, weather is current-only with no forecast, and currency has no supported-currency listing, but these are workable around.
Read-only airport delay, weather, and 24h forecast tools for AI assistants. Airport-level only.
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Real-time data API for AI Agents: stocks, weather, forex, logistics, search, scrape, news, IP.
660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.
