scholarship-navigator
Provides an AGENTS.md workflow that GitHub Copilot reads automatically, allowing it to use Scholarship Navigator's scholarship matching, planning, and application-support capabilities.
🎓 Scholarship Navigator
Find the scholarships you can actually win, and never miss a deadline again.
Eligibility checks · match scores · missing papers · a dated plan · essay drafts Free, open source, and built to work inside your AI assistant.
Quick start · Use with AI · Features · What's covered · Contribute · العربية
The problem
Every year, thousands of strong students miss fully funded scholarships. Usually they were good enough. What went wrong was something else:
they found out about the scholarship after the deadline;
they spent weeks on an application they were never eligible for (wrong nationality, age or field);
they were one paper short: a missing recommendation letter, an expired IELTS, a transcript without apostille;
the information was spread across hundreds of outdated blog posts and WhatsApp forwards.
Scholarship Navigator fixes that. Tell it about yourself once. It checks every rule, scores how well you match, lists exactly which papers you're missing, and builds a plan with real dates, backwards from each deadline.
Related MCP server: grad-agent
✨ What it looks like
You: I'm Egyptian, BSc in electronics engineering, GPA 3.58/4, IELTS 7.0, 3 years of work. I want a fully funded master's in AI or embedded systems in Europe, starting 2027.
Your AI assistant (using Scholarship Navigator):
✅ You're eligible for 56 of 103 scholarships. ❌ 47 aren't open to you, and here's why (nationality list, age limit, field).
🏠 7 of them let you study in Egypt without travelling (AUC, Zewail City, E-JUST, ASRT...), if you'd rather stay home.
🥇 Erasmus Mundus: fit 98/100, papers 56% ready, deadline 15 Jan 2027 (estimated, verify). Start your motivation letter by 9 Dec.
🧭 Programs that fit you: DEAI (Belgium · Spain · Austria · France · Italy), EDISS (Finland · Sweden · Italy · Spain), EMINENT. Pick the ones you fit best.
⏰ Chevening already closed on 6 Oct 2026. Next round ≈ Oct 2027.
📄 Missing papers: 2nd academic reference, Europass CV, proof of residence, medical certificate.
📁 Everything is saved in
output/ahmed-mansour/: one folder per scholarship, essay drafts, an Excel tracker and a calendar.
That's a real run on the demo profile in examples/sample_candidate_full.json.
🆚 Why not just a list, or just a chatbot?
Scholarship lists & blogs | Asking a chatbot | Scholarship Navigator | |
Tells you if you are eligible, rule by rule | ❌ | ⚠️ guesses | ✅ official country lists, age, degree, experience, field |
A score, and why | ❌ | ❌ | ✅ 0-100 with a visible breakdown |
Exactly which papers you're missing, and when to start | ❌ | ⚠️ generic | ✅ 47 paper types with lead times |
Deadlines with source and verification date | ⚠️ often stale | ❌ training-data dates | ✅ confirmed / published / estimated |
Remembers you across sessions | ❌ | ❌ | ✅ personal workspace |
Drafts tailored to each program | ❌ | ⚠️ | ✅ the program's own prompts and word limits |
Excel tracker, HTML report, calendar | ❌ | ❌ | ✅ |
Free, private, open source | varies | ❌ | ✅ runs on your computer |
🚀 Quick start
git clone https://github.com/OmarZen/scholarship-navigator.git
cd scholarship-navigator
python3 -m venv .venv && .venv/bin/pip install -e ".[mcp]"Then either talk to your AI assistant in this folder (next section), or run the interview yourself:
.venv/bin/python cli.py assess # answers a few questions → builds output/<your-name>/Or copy sample_candidate.json (dummy data showing every field), fill in your own details
and run .venv/bin/python cli.py init --profile my_profile.json.
Open output/<your-name>/INDEX.md and reports/scholarship_tracker.xlsx. That's it.
🤖 Use it with your AI assistant
Scholarship Navigator ships with 7 agent skills, an MCP server with 16 tools, and an AGENTS.md, so any
modern assistant knows how to use it. Step 0 for every tool: install the project (see Quick start).
Full guide with every menu and config file: docs/AI_TOOLS.md.
Assistant | Open this folder and it just works | Install the skills for every folder |
Claude Code | ✅ skills ( |
|
Claude app (claude.ai · Desktop) | – |
|
OpenAI Codex | ✅ |
|
GitHub Copilot (VS Code · CLI) | ✅ |
|
Cursor | ✅ |
|
Gemini CLI | ✅ |
|
Windsurf | ✅ |
|
Google Antigravity | ✅ |
|
The install script also prints the MCP server settings for your tool with your real paths filled in
(python scripts/install_skills.py --tool cursor --mcp-only).
cd scholarship-navigator && claudeApprove the
scholarship-navigatorMCP server when asked (/mcpshows it). The skills load by themselves.Ask: "Help me find a fully funded master's scholarship. Interview me first."
Want it in every folder?
python scripts/install_skills.py --tool claude, thenclaude mcp add --scope user scholarship-navigator -- /path/to/scholarship-navigator/.venv/bin/python /path/to/scholarship-navigator/mcp_server.py
python scripts/install_skills.py --tool claude-app→ ZIP files indist/claude-skills/.In Claude: Customize → Skills (older versions: Settings → Capabilities), turn on code execution, Upload skill, and upload each ZIP.
Claude Desktop only: Settings → Developer → Edit Config and paste the MCP block printed by the script (
--tool claude-app --mcp-only), then restart Claude Desktop.
cd scholarship-navigator && codex: Codex readsAGENTS.mdand.agents/skills/(type/skills, or$scholarship-finder-planner).Every folder:
python scripts/install_skills.py --tool codex(installs to~/.agents/skills).MCP server:
codex mcp add scholarship-navigator -- /path/to/scholarship-navigator/.venv/bin/python /path/to/scholarship-navigator/mcp_server.py
Open the folder in the tool (VS Code: switch Copilot Chat to Agent mode). The skills in
.agents/skills/load automatically.Every folder:
python scripts/install_skills.py --tool copilot(orcursor,gemini,windsurf,antigravity).MCP server: run the same command with
--mcp-onlyand paste the block it prints into the file it names (.vscode/mcp.json,~/.cursor/mcp.json,~/.gemini/settings.json,~/.codeium/windsurf/mcp_config.json,~/.gemini/config/mcp_config.json).
Then just ask, in any language:
"Help me find a fully funded master's scholarship. Interview me first."
"I can't travel abroad. Which scholarships let me study in Egypt?"
"Which Erasmus Mundus programs fit a civil engineer who wants Spain or Portugal?"
"What should I do this week for my applications?"
"Write my Chevening leadership essay from my story bank."
"ساعدني ألاقي منحة ماجستير ممولة بالكامل في أوروبا"Skill | What it does |
🧭 | the main entry: matching, scores, missing papers, plan, reports |
🗣️ | interviews you (in your language) and builds your profile |
🎯 | picks Erasmus Mundus / Intra-Africa programs by field and country |
✍️ | essays, motivation letters, referee requests, with a review loop |
🔎 | turns estimated deadlines into verified facts |
📆 | weekly check-ins: what's due, what's done |
🛠️ | adds and updates scholarships with official sources |
🧩 Features
✅ Eligibility engine | nationality (official lists, OECD DAC list), residence, age, degree level (Diploma to Postdoc), degree recency, work experience, restricted fields, return-home obligations, teaching language, awards reserved for women. Missing info → Needs Check with the exact fix. |
🏠 Study at home or abroad | can't travel, or your family prefers you study locally? Choose |
📊 Fit score 0-100 | academic record vs each scholarship's minimum and competitive level, language (TOEFL / Duolingo / PTE converted), experience, field, leadership, research, your preferences. Every point is explained. |
📄 Missing papers | what you have, what's missing, how long each paper takes, when to start, and expiry checks (e.g. an IELTS that expires before the deadline). |
🗓️ Dated action plan | scheduled backwards from deadlines; shared papers become one task; overdue items flagged. |
🧭 Program finder | 56 Erasmus Mundus and Intra-Africa programs with host countries, universities, status and 2027 deadlines; choose 3, get tailored letters. |
📁 Personal workspace | one folder per scholarship with essay and letter drafts that use the program's own prompts; your work is never overwritten. |
📈 Excel tracker | dashboard, ranked matches, one sheet per scholarship, live readiness formulas, |
🌐 HTML report + 📅 calendar | offline interactive report and an |
✍️ Writing helpers | STAR essay review, supervisor cold emails, recommendation-letter drafts and brag sheets, fee-waiver emails. |
🌍 Life-after-award guides | funding-gap and blocked-account calculator, credential recognition and apostille, visa and arrival checklists, study and work rules for 18 countries. |
Excel dashboard
cli.py match
cli.py programs
🧠 How it works
flowchart LR
A["🗣️ You or your AI assistant<br/>tell your story once"] --> B["👤 profile.json<br/>+ papers you hold"]
B --> C{"✅ Eligibility gates<br/>nationality · age · degree<br/>experience · field"}
C -- "not eligible" --> X["❌ shown with the reason"]
C -- "eligible / needs check" --> D["📊 Fit 0-100<br/>📄 Readiness %"]
D --> E["🗓️ Dated plan<br/>backwards from deadlines"]
E --> F["📁 Your workspace<br/>briefs · drafts · Excel · HTML · calendar"]
F -. "you add papers, finish drafts" .-> BStep | Measures | Result |
Eligibility | hard rules | Eligible · Needs Check · Ineligible |
Fit | academic, language, experience, field, leadership, research, preferences | High ≥ 80 · Moderate ≥ 62 |
Readiness | share of required papers you hold | updates live |
Timeline | days left vs how long the missing papers take | On track · Tight · At risk · Not feasible · Passed |
Priority | 55% fit + 20% readiness + funding + time left | ranks your shortlist |
Full details: scoring reference.
📚 What's covered
103 scholarships from Diploma to PhD (full table), including:
Study abroad: Chevening · Commonwealth · Gates Cambridge · Clarendon · Rhodes · Knight-Hennessy · Fulbright · Erasmus Mundus · DAAD (EPOS, Helmut-Schmidt, doctoral) · Heinrich Böll · Deutschlandstipendium · Eiffel · Stipendium Hungaricum · Swedish Institute · Romania · Russia · Schwarzman · Yenching · MEXT · GKS · CSC · Türkiye Burslari · KAUST · MBZUAI · HBKU · Khalifa · ICCR India · KNB Indonesia · Malaysia · Brunei · ADB-Japan · JJ/WBGSP · JISP · Mexico AMEXCID · Australia Awards · Manaaki NZ, and more.
Study in your own country (no travel): 🇪🇬 منحة علماء المستقبل (Future Scholars) · Zewail City · AUC · Nile University · Sawiris · E-JUST · ASRT · ITI · DEPI · 🇹🇷 TÜBİTAK 2210/2211 · 🇮🇩 LPDP · 🇲🇽 SECIHTI · 🇳🇬 PTDF · DAAD In-Country/In-Region (Africa) · Pan African University · AIMS.
Diploma level: MEXT College of Technology / Specialized Training College · GKS Associate · ICTP Postgraduate Diploma · ITI 9-month program · Brunei · AMCI Morocco.
For women: AAUW International Fellowships · IAEA Marie Skłodowska-Curie Fellowship · British Council Women in STEM.
National programs to go abroad: Egyptian missions · Bolashak · Becas Chile · Saudi Custodian · PTDF Overseas · Onsi Sawiris (Amideast).
56 programs taught in 37 host countries (full table): Erasmus Mundus Joint Masters in engineering, energy, AI & data, cybersecurity, robotics, photonics, quantum, materials, nuclear, agriculture, design and more, plus Intra-Africa mobility projects. Each lists its universities, status, 2027 deadline and English requirement.
Plus: 47 paper types · study and work guides for 18 countries · credential recognition (uni-assist, CIMEA, WES, apostille) · visa and housing checklists.
Every deadline, country list and program status carries its official source and verification date (last full review: October 2026).
🗂️ Your workspace
output/<your-name>/
├── INDEX.md ← start here: shortlist, next actions, missing papers, programs that fit you
├── PROFILE.md ← who you are, papers on file, missing profile info
├── AGENTS.md ← rules any AI assistant follows in this folder
├── profile/ ← profile.json · documents.json · story_bank.md · identity/ academic/ language/ ...
├── scholarships/
│ └── erasmus-mundus/ ← SCHOLARSHIP.md · status.json · essays/ · letters/ · recommendations/ · forms/ · submitted/
└── reports/ ← scholarship_tracker.xlsx · scholarship_report.html · deadlines.ics · action_plan.mdCommand | Purpose |
| create or refresh your workspace |
| where you will study: your own country (no travel), abroad, or either |
| eligibility, fit breakdown and readiness for every scholarship |
| Erasmus Mundus / Intra-Africa program finder |
| missing papers; record what you have |
| record a verified deadline |
| track each application |
| import edits you made in the Excel tracker |
| individual reports |
| writing helpers |
| browse the database: by degree, who can apply, study at home or abroad |
| guides and calculators |
| data maintenance |
| live web checks ( |
Run commands as .venv/bin/python cli.py <command>, or as scholarship <command> after pip install -e .. Most
commands accept --json.
🗺️ Roadmap
Eligibility engine, fit scores, readiness, dated plans
Erasmus Mundus & Intra-Africa program finder
Agent skills, MCP server,
AGENTS.mdStudy at home or abroad, Diploma level, awards for women, 103 scholarships
More scholarships: national programs for more countries, US and Canadian university fellowships
Funded PhD positions finder
Automatic deadline monitoring (alert when an official page changes)
Web app for people without an AI assistant
Translations of the interface and guides (Arabic, French, Spanish, Portuguese, Turkish...)
Want one of these? Open an issue or send a pull request.
🤝 Contributing
The most valuable contribution is accurate data: a new scholarship, a corrected deadline, a verified program status. No coding needed; CONTRIBUTING.md walks you through your first pull request in 10 minutes. Developers: tests, CI and JSON schemas are ready for you.
🌱 Good first issues · ➕ Suggest a scholarship · 📅 Report an outdated deadline · 💬 Ask a question · 🧑💻 Contribute code
How contributions are reviewed: you open a pull request from your fork → tests and data checks run
automatically → it is labelled by area → a maintainer reviews it (every pull request is reviewed before merging)
→ squash-merged into main. Nobody pushes to main directly. Details: CONTRIBUTING.md.
💛 Contributors
Every merged pull request puts your GitHub account here. The table is refreshed automatically after each merge
(scripts/update_contributors.py); the picture below updates by itself.
❓ FAQ
🌍 بالعربي
Scholarship Navigator أداة مجانية ومفتوحة المصدر بتساعدك تلاقي المنح اللي تقدر تكسبها فعلاً. بتحكي عن نفسك مرة واحدة، وهي:
✅ بتقولك إنت مؤهل لأنهي منح، والسبب لو مش مؤهل.
📊 بتديك درجة توافق من ١٠٠ مع شرح كل جزء فيها.
📄 بتقولك الورق الناقص، وتبدأ تجهز كل ورقة امتى.
🗓️ بتعملك خطة بمواعيد حقيقية، محسوبة من آخر ميعاد لكل منحة.
🧭 بتختارلك برامج إيراسموس موندوس المناسبة لتخصصك والدول اللي بتحبها.
🏠 مش هتقدر تسافر؟ اختار «الدراسة في بلدك» وهتطلعلك بس المنح اللي بتمول الدراسة جوه بلدك، أو اختار «الاتنين» عشان تشوف منح الداخل والخارج مع بعض.
🎓 بتغطي دبلومة وبكالوريوس وماجستير ودكتوراه، ومنح مخصصة للبنات.
📁 بتعملك مجلد لكل منحة، فيه مسودات المقالات وخطابات النية وملف Excel ونتيجة تقويم.
تقدر تستخدمها مع Claude أو Cursor أو أي مساعد ذكاء اصطناعي، وتكلمه بالعربي عادي. الشرح الكامل بالعربي: docs/i18n/README.ar.md
⚠️ Disclaimer
Scholarship Navigator is an independent community project, not affiliated with any scholarship provider, government or university. Data was researched from official sources (October 2026) but rules and deadlines change every year: always confirm on the official website. Scores are guidance, not predictions of selection.
⭐ Support the project
If it helped you (or could help someone you know):
star the repository, so more students find it;
share it in your university, student and scholarship groups;
add one scholarship from your country.
Star history
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Deterministic eligibility checker for grants, jobs and scholarships in Africa.
Live EU funding data in your AI: grant calls, programmes, consortium partners, VCs, incubators.
Eligibility-first UK & EU grant discovery, inside ChatGPT and Claude.
Find European public tenders and EU funding calls inside your AI assistant. Search by topic, country, procurement category and deadline. Examine opportunity details and source notices, then follow structured bid qualification workflows. For bid managers, business development teams and funding consultants. Free during beta; sign in with your email. --- Europos viešieji pirkimai ir ES finansavimo kvietimai jūsų DI asistente (Claude, ChatGPT ir kt.). Ieškokite pagal veiklos sritį, šalį, pirkimo kategoriją ir terminą. Peržiūrėkite galimybių duomenis bei pirminius skelbimus ir naudokitės darbo eigomis, padedančiomis įvertinti, ar verta dalyvauti. Pirkimų pasiūlymų rengėjams, verslo plėtros komandoms ir finansavimo konsultantams. Beta laikotarpiu nemokama; prisijunkite el. paštu.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to search and filter youth opportunities such as scholarships, fellowships, internships, conferences, and exchange programs, aggregated from multiple live sources.61MIT
- AlicenseNot gradedqualityBmaintenanceAn autonomous MCP agent that helps you apply to fully funded MS and PhD programs by discovering professors, verifying faculty status, matching projects, and drafting cold emails.64 PyPI4MIT
- AlicenseNot gradedqualityCmaintenanceProvides AI assistants with real-time, verified European funding data including open grant calls, programmes, consortium partners, VCs, and incubators, enabling natural language queries about EU funding.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to search and retrieve opportunities from the Opportunities Circle catalog, including scholarships, fellowships, internships, grants, jobs, and more. Supports filtering by type, country, funding, and tags, with full details and official apply links.6MIT