42-mcp-server

42 MCP Server

A Model Context Protocol server designed by Mateo LBS to interact with the 42 API. It lets AI assistants look up 42 students' profiles, progression, teams, and coalition standing, and browse campus life — locations, events, and exams.

Features

• Profiles & progression: Look up any 42 student's profile, cursus progression, project statuses, earned achievements, quests, and titles by login or ID
• Search: Search/list users with filters (campus, login, piscine year/month), paginated
• Teams: Get the teams a user has been part of, or the full detail of a team (members, status, final mark, repo url)
• Coalitions: Get a user's coalition membership/score, or a coalition's score history
• Campus life: List campuses, see who's currently logged in and where, browse upcoming events and exam dates

How to Install

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "42-mcp": {
      "command": "npx",
      "args": ["-y", "42-mcp-server@latest"],
      "env": {
        "FORTY_TWO_TOKEN": "<FORTY_TWO_TOKEN>",
        "FORTY_TWO_URL": "https://api.intra.42.fr"
      }
    }
  }
}

Configuration

FORTY_TWO_TOKEN is used as-is and is not refreshed automatically by the server. Get one via the Client Credentials grant, using the UID/secret of a 42 OAuth app created at profile.intra.42.fr/oauth/applications (the "public" scope is enough):

curl -X POST "https://api.intra.42.fr/oauth/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=<uid>" \
  -d "client_secret=<secret>"

Copy the access_token field from the response into FORTY_TWO_TOKEN. It expires after a couple of hours (see expires_in in the response), so you'll need to repeat this and update it when it does.

Output format

The server returns JSON output.

Available Tools

Profiles & progression

Teams

Coalitions

Campus life