falaj
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Falaj

Falaj is a remote MCP server that turns United Arab Emirates University's public website into ten typed, read-only tools. An assistant can search the course catalogue, read a course or programme page, list events and withdrawal deadlines, find faculty profile pages, and read a cached faculty profile or academic calendar. Pages are read through TinyFish (Fetch, Search, Agent and two Page monitors). The same Worker serves a page where a visitor can try a tool, and a small JSON API.
Live: https://falaj.falaj.workers.dev is the page, and https://falaj.falaj.workers.dev/mcp is the address an assistant is given. To run it yourself, see "Run locally" below.
Install
Replace <url> with the live address (or http://localhost:8787 for a local wrangler dev). The MCP endpoint is POST <url>/mcp. A GET to that path returns 405 and this install JSON.
Claude Code
claude mcp add --transport http falaj <url>/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"falaj": { "url": "<url>/mcp" }
}
}Cursor (MCP settings / mcp.json)
{
"mcpServers": {
"falaj": { "url": "<url>/mcp" }
}
}ChatGPT (custom connector / MCP server): <url>/mcp
mcp-remote (stdio bridge for clients that do not speak Streamable HTTP)
npx mcp-remote <url>/mcp{
"mcpServers": {
"falaj": {
"command": "npx",
"args": ["-y", "mcp-remote", "<url>/mcp"]
}
}
}Related MCP server: cvuex-mcp
The page
The same Worker serves one page at /. It shows the address to give an assistant, the ten tools with the arguments their schemas take, each tool's last nightly check, the latest calls and what is left of the day's share.
A visitor can try three of the tools on the page itself (search_courses, get_course, academic_deadlines). The form posts to /try, which runs the real tool through the same gate, call log and Fetch cap as an assistant's call, with its own limit of 6 questions a minute and 60 a day for one visitor. A pressed button says it is reading, a clock counts, and the answer shows where it was read, when, how and how long it took (2 to 11 seconds in my tests).
The look is described in DESIGN.md. The photographs are of the falaj and gardens of Al Ain Oasis, from Wikimedia Commons under CC BY-SA, unchanged and credited in the page's footer.
Tools
Every success includes source_url, read_at (ISO), method (fetch | search | agent_cached | status) and cached. Fetch-backed results also include ttl_seconds: 3600.
Tool | What it answers | TinyFish | Cost |
| Courses matching a code, prefix or title words | Fetch, catalogue index (1 URL) | $0 |
| One course by code (description, credit hours, outcomes) | Fetch, catalogue then the course page (2 URLs) | $0 |
| Undergraduate offerings (bachelor, doctorate, minor, micro-credential) | Fetch, programmes index (1 URL) | $0 |
| One programme page (plan, objectives, credit hours) | Fetch, that programme page (1 URL) | $0 |
| Highlighted events on the events page | Fetch (1 URL) | $0 |
| Withdrawal dates and tuition refund percentages | Fetch (1 URL) | $0 |
| Faculty profile URLs matching a name or topic | Search, restricted to uaeu.ac.ae | $0 |
| One profile (cached; a first read starts an Agent run and answers | Agent, then cache | $0.016 per Agent step |
| Dated items for one academic-year tab (cached the same way) | Agent, then cache | $0.016 per Agent step |
| Per-tool status, monitors, spend; reads no UAEU page | none | $0 |
How TinyFish is used
Product | Where Falaj uses it |
Fetch | Every catalogue, course, programme, events and deadlines read. Batches of at most 10 URLs. |
Search |
|
Agent |
|
Monitor | Two Page monitors, on the course catalogue index and the undergraduate programmes index, every 12 hours. A |
Error contract
A failed tool call is isError: true with a JSON text body {code, message, fix?, retry_after_seconds?, scope?, source_url?, near_matches?}. code is one of:
Code | When |
| No course, programme or person matched. Programmes that match several names list them in |
| That tool's canary is |
|
|
| Agent spend has reached $3.00. Cached Agent data and every Fetch and Search tool keep working. |
| TinyFish did not answer in time, or would not start a browser read. The message says which, and that nothing was read or charged. |
| Arguments failed the tool's schema. |
Nothing else is returned on failure.
Health
Nightly canaries (22:00 UTC) run each tool against recorded checks. A failure sets that tool broken; slower than 20 s, or a stale calendar, is degraded. While a tool is broken, calling it returns SITE_CHANGED. To rehearse that path: POST /api/admin/tool-status with {tool: "get_course", status: "broken", detail: "…"} (admin token), call get_course, then POST /api/admin/health-run to re-verify and clear. See docs/runbook.md.
GET /api/health is the same payload as health_check. GET /mcp on a browser is 405 with the install JSON.
Limits and budget
All values live in src/core/limits.ts (raise them there).
120 MCP calls per minute and 2,000 per UTC day per client IP (
cf-connecting-ip;"anon"when absent).400 TinyFetch URLs per UTC day across all callers.
1 Agent run in flight, 10 new Agent reads per UTC day, 12 steps, 160 s, 5-minute pending timeout.
Falaj's TinyFish share is $3.50; new Agent reads pause at $3.00 of Falaj spend. Fetch and Search stay free inside the caps. Monitor checks are $0.005 each. Agent steps are $0.016.
At most 2 Page monitors, both created only into Falaj's own
monitorstable.Call-log arguments are masked (email local parts) and cut to 80 characters. No caller IP is stored in the clear.
People
Tools return what UAEU's public pages show, including an email when a profile page shows one. What this repository itself carries (fixtures, tests, this README, sample results) names no real person and uses placeholders such as "Dr. Amal Example" and a.example@uaeu.ac.ae. Academic leadership in public-facing roles may appear only after I have checked each name. Sample results omit email.
Read API
Public JSON, CORS *, Cache-Control: public, max-age=30:
Path | Returns |
| The |
| Recent calls (default 50, max 200): tool, abbreviated args, ms, status. No |
| The ten tools with the same schemas |
| Call count, spend, today's Fetch and Agent counters, monitors |
Admin (Authorization: Bearer <ADMIN_TOKEN>): POST /api/admin/health-run, /program-map, /calendar-read, /tool-status, /monitors-init.
Run locally
Needs Node 24 or later.
npm install
cp .dev.vars.example .dev.vars # then fill TINYFISH_API_KEY, ADMIN_TOKEN, WEBHOOK_SECRET
npm run migrate:local
npm run devnpm test # no network: every TinyFish call is intercepted
npm run check # typecheck, tests, wrangler deploy --dry-run
npm run health # MCP smoke against http://localhost:8787 (wrangler dev must be running)Tests never call TinyFish or uaeu.ac.ae. Deploy steps are in docs/runbook.md.
Demo transcript
A real conversation on 10 November 2026. I connected Claude (Sonnet) to the live server with nothing but the /mcp address and asked one question. It had never seen this repository.
Asked: I am a student thinking about United Arab Emirates University. Is there a machine learning course there, what do I need to have passed before I can take it, and when do spring classes begin and what is the last day to withdraw without failing? Please tell me where each fact comes from.
# | Tool call | What came back |
1 |
| CSBP411 Machine Learning (College of Information Technology), then CSBP478, ELEC709, MATH360, STAT380 and others |
2 |
| The 2026-2027 calendar from the cache: 43 dated rows in three semesters |
3 |
| The refund page's rows, all of them for Fall 2026 |
4 |
| 3 credit hours, prerequisite CSBP301 with a minimum grade of D, the description |
Answered, in 20 seconds (shortened): Yes. CSBP411 Machine Learning is a 3-credit-hour course in the College of Information Technology. It requires CSBP301 with a minimum grade of D. Spring classes begin on 4 January 2027, and the last day to withdraw and drop without failure is 5 February 2027. The refund page shows only the Fall 2026 schedule, so it has no spring refund dates yet.
Each fact came with the UAEU page it was read from: the course's catalogue page, the academic calendar, and the Student Account Office's refunds page. The assistant also said what it could not find (the title of CSBP301, which the course page does not give) instead of guessing it.
A second one was told to be a hard tester, in 18 calls: a course code that does not exist, a malformed one, a programme name that matches several, an impossible date, searches that match nothing, a calendar year nobody has read. Its marks were 8 of 10 for the design of the tools, 7 for the answers and 9 for the errors, and two of the faults it reported are fixed (see the build log for 10 November).
License
MIT. See 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
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Search Australian CRICOS courses, education providers and ANZSCO skilled occupations using One U Education (万友教育)'s public catalogue, including tuition, intakes, English requirements, campuses and study pathways. Provides six read-only tools with source links; no API key is required, and tuition fees are indicative and shown in AUD.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Public web tools for agents: product extraction, claim checks, webpage QA and ranked audits.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to discover and explore university research, researchers, academic programs, and institutional data from OpenAlex and the U.S. College Scorecard, returning source-linked results without fabricating facts.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to query the UEx virtual campus (CVUEx/AVUEx) in natural language, including deadlines, grades, announcements, forums, and course materials, using the user's own account with read-only access.MIT
- AlicenseNot gradedqualityBmaintenanceLets AI agents browse and read a university's student resource center portal, retrieving the resource pages for a given admission year and department along with progression and graduation requirements, student handbook sections, academic calendars, bus timetables, class advisors, application forms and manuals, and contact information, each answer cited with its source document and page. It is an unofficial tool that runs locally and drives Chrome or Edge to access the portal on the user's behalf.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to search and read university web pages and PDF/Office documents, query live phone directory, food menu, academic calendar, announcements, and AKTS course plans, and return sourced answers with URLs and dates.MIT