🎓 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: bandiradar-mcp

✨ 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 22 of 35 scholarships. ❌ 13 aren't open to you, and here's why (nationality list, age limit, field).

• 🥇 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 up to 3.

• ⏰ 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?

🚀 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 15 tools, and an AGENTS.md, so any modern assistant knows how to use it.

{
  "mcpServers": {
    "scholarship-navigator": {
      "command": "/path/to/scholarship-navigator/.venv/bin/python",
      "args": ["/path/to/scholarship-navigator/mcp_server.py"]
    }
  }
}

Then just ask, in any language:

"Help me find a fully funded master's scholarship. Interview me first."
"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."
"ساعدني ألاقي منحة ماجستير ممولة بالكامل في أوروبا"

🧩 Features

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" .-> B

Full details: scoring reference.

📚 What's covered

35 scholarships in 28 countries plus multi-country schemes (full table): Chevening · Gates Cambridge · Rhodes · Erasmus Mundus · DAAD EPOS · DAAD Helmut-Schmidt · Eiffel · Stipendium Hungaricum · Swedish Institute · Danish Government · Finland · Italy MAECI & DSU · Ireland GOI-IES · NL Scholarship · VLIR-UOS · Master Mind · Ernst Mach · Czech Government · NAWA Banach · Fundación Carolina · Swiss Excellence · Fulbright · Vanier · Australia Awards · Manaaki NZ · MEXT · GKS · CSC · Taiwan ICDF · Türkiye Burslari · MBZUAI · KAUST · SINGA · Mastercard Foundation · Intra-Africa Mobility.

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.md

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.md

• More scholarships: Asia-Pacific, US and Canadian university fellowships, foundation awards

• 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 profile here.

❓ 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.

License

MIT © 2026 OmarZen.