<div align="center">

# edhec-mcp

[![licence: MIT](https://img.shields.io/badge/licence-MIT-5F1937)](LICENSE)
[![MCP server](https://img.shields.io/badge/MCP-server-d97757)](https://modelcontextprotocol.io)
[![node ≥ 20](https://img.shields.io/badge/node-%E2%89%A5%2020-339933)](package.json)
[![security tests](https://img.shields.io/badge/security%20tests-passing-16a34a)](test/security.test.js)
[![unofficial](https://img.shields.io/badge/EDHEC-unofficial-64748b)](#is-this-an-official-edhec-tool)

**An unofficial MCP server that connects Claude to Blackboard, Aurion, PaperCut ePrinting and the campus restaurant.**
Ask for your timetable, download a whole course, print a case stapled or check today's menu, in one sentence.
It runs on your own computer and signs in with your normal EDHEC Microsoft login. It never sees your password.

<img src="docs/assets/hero.svg" width="900" alt="edhec-mcp connects Claude to Blackboard, Aurion, ePrinting and the campus food services">

[Quick start](#quick-start) · [What you can ask](#what-you-can-ask) · [All tools](#all-tools) · [Security](#security-and-privacy) · [FAQ](#faq)

</div>

---

## What it is

**edhec-mcp** is a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **EDHEC Business School** students. MCP is the standard way to give AI assistants like Claude new tools. Once you add this server, Claude can work with the four systems you use every week:

| | System | What Claude can do with it |
|---|---|---|
| <img src="https://img.shields.io/badge/B-2563eb?style=for-the-badge" alt="Blackboard"> | **Blackboard Learn** (learning.edhec.edu) | List courses, read content and announcements, download all files, see grades and deadlines |
| <img src="https://img.shields.io/badge/A-7c3aed?style=for-the-badge" alt="Aurion"> | **Aurion** (aurion.edhec.edu) | Timetable with rooms, grades, absences, free rooms right now, school certificate PDF |
| <img src="https://img.shields.io/badge/P-059669?style=for-the-badge" alt="ePrinting"> | **PaperCut ePrinting** (eprinting.edhec.edu) | Print A4, A3 or stapled, check your print quota, cancel jobs |
| <img src="https://img.shields.io/badge/F-ea580c?style=for-the-badge" alt="Campus food"> | **Campus food** (ALL La Catho · MONEWEB) | Today's menu, card balance and history, snack-corner pre-orders *(beta)* |

---

## What you can ask

Every animation below is a mockup with **fictional sample data**. The tool names are the real ones.

### "What do I have tomorrow?"

<img src="docs/assets/demo-timetable.svg" width="820" alt="Claude reads the Aurion timetable and Blackboard deadlines and answers with tomorrow's classes and rooms">

Claude reads your **Aurion** timetable and your **Blackboard** deadlines in one go, so you get rooms, teachers and due dates in one answer.

### "Download the whole course"

<img src="docs/assets/demo-download.svg" width="820" alt="Claude downloads all files of a Blackboard course into a local folder and suggests what to read first">

Every attachment lands in a clean folder structure (one folder per session). Harvard course-pack links are listed, never scraped.

### "Print it, stapled"

<img src="docs/assets/demo-print.svg" width="820" alt="Claude sends two PDFs to the stapling printer on ePrinting and shows the remaining print quota">

Jobs wait in the queue until you tap your card at any campus printer. Claude checks your quota and can cancel a job you no longer need.

### "What's for lunch, and can I afford it?"

<img src="docs/assets/demo-lunch.svg" width="820" alt="Claude reads today's campus restaurant menu and the campus card balance">

The menu is published as a PDF. The server hands Claude the pages as images, so Claude reads dishes and prices itself and compares them with your card balance.

### "Pre-order from the snack corner" *(beta)*

<img src="docs/assets/demo-order.svg" width="820" alt="Two-step order: Claude prepares a snack-corner order with prices and only books it after the user confirms">

Ordering always takes **two steps**. Claude first shows items, prices, pickup time and your balance afterwards. Nothing is booked until you confirm that exact summary. Snack-corner ordering is only open in the morning (until about 10:00).

### "Admin stuff, done"

<img src="docs/assets/demo-admin.svg" width="820" alt="Claude lists absences from Aurion and downloads the school attendance certificate">

Check absences before they cost you points, and get your *certificat de scolarité* as a PDF for your bank, landlord or visa.

---

## Prompt cookbook

Copy any of these into Claude once the server is installed.

<details open>
<summary><b>Daily routine</b></summary>

- *What's on my timetable today, and which rooms are free near my next class right now?*
- *Do I have anything due in the next 10 days across all my courses?*
- *What did the professors announce this week? Summarise in five bullets.*
- *What's for lunch at the EDHEC restaurant today and how much is left on my card?*

</details>

<details>
<summary><b>Before a session or quiz</b></summary>

- *Download everything for Session 3 of my M&A course into ~/Documents/EDHEC/M&A.*
- *Read the case for tomorrow and give me the 20 facts most likely to come up in a multiple-choice quiz.*
- *Turn the self-study questions from the syllabus into short answer outlines.*
- *Print the case stapled and the summary on A4.*

</details>

<details>
<summary><b>Exam period</b></summary>

- *List every graded item in all my courses with points and due dates.*
- *Show my grades and any resit sessions.*
- *Do I have absences that could affect my grade? Which ones still need a proof?*

</details>

<details>
<summary><b>Admin</b></summary>

- *Download my school certificate into ~/Documents/Admin.*
- *Which groups and optional courses am I registered in?*
- *Get the academic calendar for this year.*

</details>

<details>
<summary><b>Campus food</b></summary>

- *Show my last 10 purchases with the campus card.*
- *What can I book through MONEWEB right now?*
- *(beta, mornings)* *Pre-order a sandwich and a drink for 12:30 from the snack corner.*

</details>

---

## Quick start

**You need:** Node.js 20 or newer, Google Chrome, and an EDHEC account. Works on macOS, Windows and Linux.

**1. Install**

```bash
git clone https://github.com/Sillvs/edhec-mcp.git
cd edhec-mcp
npm ci
npm test
```

**2. Sign in once.** A Chrome window opens. Log in with your EDHEC Microsoft account and choose *Stay signed in*. The window closes by itself.

```bash
npm run login
```

**3. Add it to Claude**

<details open>
<summary><b>Claude Code</b></summary>

```bash
claude mcp add --scope user edhec -- node /absolute/path/to/edhec-mcp/src/index.js
```

</details>

<details>
<summary><b>Claude Desktop</b></summary>

Settings → Developer → Edit Config, then add:

```json
{
  "mcpServers": {
    "edhec": {
      "command": "node",
      "args": ["/absolute/path/to/edhec-mcp/src/index.js"]
    }
  }
}
```

Restart Claude Desktop.

</details>

<details>
<summary><b>Any other MCP client</b></summary>

It is a standard stdio MCP server: command `node`, argument `/absolute/path/to/edhec-mcp/src/index.js`.

</details>

**4. Try it:** *"What's on my timetable this week?"*

If your session ever expires, Claude tells you and can call `edhec_login` to open the sign-in window again.

---

## All tools

<details open>
<summary><b>Blackboard Learn</b> · 7 tools</summary>

| Tool | What it does | Changes anything? |
|---|---|---|
| `bb_list_courses` | Your enrolled courses, most recent first | No |
| `bb_course_contents` | Folders, sessions, files, links and text of a course | No |
| `bb_download_files` | Saves all course files into a local folder, keeping the structure | Writes files on your disk |
| `bb_announcements` | Course announcements as plain text | No |
| `bb_grades` | Gradebook items, due dates, points, your grade where visible | No |
| `bb_upcoming` | Deadlines across all courses for the next N days | No |
| `bb_api_get` | Read-only call to any Blackboard public REST endpoint | No |

</details>

<details open>
<summary><b>Aurion</b> · 3 tools</summary>

| Tool | What it does | Changes anything? |
|---|---|---|
| `aurion_timetable` | Classes between two dates: course, room, teacher, type, on campus or online | No |
| `aurion_view` | `grades`, `resit_grades`, `resit_sessions`, `absences`, `proofs_of_absence`, `optional_courses`, `options`, `lv2_courses`, `groups`, `rooms_now`, `rooms_morning`, `rooms_afternoon`, `academic_calendar` | No |
| `aurion_certificate` | Downloads your school attendance certificate (PDF) | Writes a file on your disk |

</details>

<details open>
<summary><b>PaperCut ePrinting</b> · 3 tools</summary>

| Tool | What it does | Changes anything? |
|---|---|---|
| `eprint_status` | Print quota and jobs waiting for release | No |
| `eprint_submit` | Sends PDFs, Office files or images to `a4`, `a3` or `staple` | **Yes**, uses print quota when released |
| `eprint_cancel` | Cancels one held job by name | **Yes** |

</details>

<details open>
<summary><b>Campus food</b> · 4 tools + 2 in beta</summary>

| Tool | What it does | Changes anything? |
|---|---|---|
| `resto_menu` | Today's menu as images (one per page), optional PDF download | No |
| `resto_balance` | Campus card balance and last visit | No |
| `resto_history` | Recent purchases and top-ups | No |
| `resto_services` | What you can book on MONEWEB right now | No |
| `resto_order_prepare` *(beta)* | Builds a snack-corner order: items, prices, pickup slot, balance after | No |
| `resto_order_confirm` *(beta)* | Places exactly the prepared order after you confirmed it | **Yes**, pays from your card |

> **Beta:** the two order tools ship after a live test of the snack-corner flow (it only opens in the morning). Until then they are not part of the server. Watch the [CHANGELOG](CHANGELOG.md).

</details>

<details>
<summary><b>Session</b> · 1 tool</summary>

| Tool | What it does |
|---|---|
| `edhec_login` | Opens a Chrome window so you can sign in yourself (Microsoft SSO) |

</details>

The server never submits assignments, takes tests, posts in discussions, reports absences or tops up your card.

---

## How it works

<img src="docs/assets/architecture.svg" width="900" alt="Architecture: Claude talks to edhec-mcp over stdio; a safety layer checks every request; a private Chrome profile with your SSO session reaches the four EDHEC services">

- **Blackboard:** the official [Blackboard Learn REST API](https://developer.anthology.com/portal/displayApi), called with your own session. No app key needed.
- **Aurion:** reads the same pages you see. The timetable comes straight from Aurion's calendar data, so it includes rooms and teachers.
- **ePrinting:** PaperCut has no student API, so the server fills in the Web Print form for you.
- **Campus food:** the menu PDF from ALL La Catho and the MONEWEB JSON API for balance, history and bookings. Sign-in uses the *EDHEC - Connect* button.
- One Chrome profile, one request at a time, closed after 5 idle minutes.

---

## Security and privacy

This server acts **as you**, so it is built to be boring and safe.

| Risk | What edhec-mcp does |
|---|---|
| Your password | Never handled. You sign in yourself in a real Chrome window. |
| Session cookies leaking | Stored only in `~/.edhec-mcp/profile` (permissions `700`). Every result and error is scrubbed of cookies, tokens, badge and student numbers. |
| Talking to other servers | Requests only go to EDHEC services (plus Microsoft and Keycloak during sign-in). No telemetry. |
| Malicious file names on Blackboard | Names are cleaned (`..`, hidden files, Windows names, unicode tricks) and every write is checked to stay inside your folder. Nothing is ever overwritten. Programs and scripts are skipped. |
| Writing into sensitive folders | Downloads into `~/.ssh`, `~/.config`, `~/Library`, `~/.claude`, your home folder itself and system folders are refused. |
| Printing your secrets | Only documents and images can be printed. Hidden folders and secret stores are refused, symlinks are resolved first. |
| Prompt injection | Course texts are marked as untrusted data. There is no tool that can send your files anywhere except EDHEC printers. |
| Spending money | Ordering needs a fresh, single-use confirmation that matches the summary you saw, expires after 10 minutes and is refused above your balance. |

All tools declare MCP `readOnlyHint` / `destructiveHint`. **Recommendation:** in Claude Code, allow read-only tools if you like, but keep `eprint_submit`, `eprint_cancel` and `resto_order_confirm` on *ask every time*.

Run the checks yourself with `npm test`. Found a problem? See [SECURITY.md](SECURITY.md).

---

## FAQ

#### Is this an official EDHEC tool?
No. It is a student project, not affiliated with or endorsed by EDHEC Business School, Anthology (Blackboard), PaperCut, the makers of Aurion, ALL La Catho or JES Labs (MONEWEB). Use it for your own account and follow the EDHEC IT charter.

#### Does it store my password?
No. You type your password into Microsoft's own login page in a normal Chrome window. The server only reuses the session cookie, like your browser does. Delete `~/.edhec-mcp` to sign out everywhere.

#### Can it submit assignments or take quizzes for me?
No. There are no tools for that, on purpose.

#### Which Claude apps work?
Claude Code, Claude Desktop and any other MCP client that supports stdio servers.

#### Does it work outside EDHEC?
The Blackboard and PaperCut parts work with any school that uses them, if you change the URLs in `src/browser.js`. Aurion and the food services are EDHEC-specific.

#### Does it cost anything?
The server is free and MIT licensed. Printing uses your normal print quota and food orders are paid from your campus card, both only after you ask.

#### Why does Chrome need to be installed?
Some EDHEC systems have no API for students, so the server uses a hidden Chrome window to read them the same way you would.

---

## Troubleshooting

| Problem | Fix |
|---|---|
| "Not signed in to …" | Run `npm run login`, or let Claude call `edhec_login`. |
| "Profile is already in use" | Close the sign-in window or the other Claude session using the server. |
| "Google Chrome was not found" | Install Chrome, or set `EDHEC_MCP_BROWSER_CHANNEL=msedge` or `chromium`. |
| Snack-corner service not listed | Ordering is only open in the morning (until about 10:00). |
| Printer names changed | Edit `PRINTERS` in `src/eprint.js`. |

## Configuration

| Variable | Default | Meaning |
|---|---|---|
| `EDHEC_MCP_PROFILE` | `~/.edhec-mcp/profile` | Where the browser session is stored |
| `EDHEC_MCP_BROWSER_CHANNEL` | `chrome` | `chrome`, `msedge` or `chromium` |
| `EDHEC_MCP_DEBUG` | off | Saves a screenshot to your temp folder when an SSO step fails |

## Development

```bash
npm test                         # security tests, offline
node test/e2e.mjs                # all read-only tools end to end, needs a signed-in profile
node tools/make-docs-assets.mjs  # regenerate the README animations (fictional data)
```

```
src/
  index.js       MCP tools and result scrubbing
  safety.js      redaction, safe file names, protected folders
  browser.js     Chrome profile and SSO
  blackboard.js  Blackboard Learn REST API
  aurion.js      Aurion timetable, records, certificate
  eprint.js      PaperCut Web Print
  resto.js       ALL La Catho menu, MONEWEB balance and bookings
```

Pull requests are welcome. Never commit real course material, grades, cookies or screenshots with personal data.

---

## More for EDHEC students

<table>
<tr>
<td width="46%" valign="middle">
<a href="https://github.com/Sillvs/edhec-project-template"><img src="https://raw.githubusercontent.com/Sillvs/edhec-project-template/main/docs/img/mockup-screen.png" alt="A slide made with edhec-project-template shown on a presentation screen"></a>
</td>
<td valign="middle">

### [edhec-project-template](https://github.com/Sillvs/edhec-project-template)

**Hand in work that looks like you meant it.** Slides, a paper and a one-page leave-behind in the EDHEC design. Write plain HTML, get a PDF and an editable PowerPoint, with no build step.

**Works well together:** let edhec-mcp download the case and your notes from Blackboard, then build your deck with the template and print it stapled with `eprint_submit`.

[**Use the template →**](https://github.com/Sillvs/edhec-project-template)

</td>
</tr>
</table>

---

<div align="center">
<sub>MIT licensed · Built by EDHEC students, for EDHEC students · Not affiliated with EDHEC Business School</sub>
</div>