> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bilauitmcuti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Claude, Grok, Cursor, VS Code or Codex to the read-only Bila UiTM Cuti MCP server for UiTM calendar and Malaysia holiday data.

The bilauitmcuti MCP server lets AI assistants read the UiTM academic calendar and Malaysia public holidays in plain language. It is read-only and sits on top of the public API, so there is no API key and nothing can be changed.

For example, ask "When does lecture week 1 start for session B-20264?" or "List the public holidays in Selangor for 2026."

## Quick Start

The server is hosted, so there is nothing to install. Point your MCP client at the URL below.

> [!NOTE]
>
> **Server URL:** `https://mcp.bilauitmcuti.com/mcp` (Streamable HTTP, no authentication)

**1. Add the Server**

Add the URL to your client. See [Configuration](#configuration) for Cursor, Claude Code, VS Code, Codex, and OpenCode, or [Connect in chat](#connect-in-chat) for Claude and Grok.

**2. Restart Your Client**

Restart or refresh the tools list so the six tools appear.

**3. Ask a Question**

Try "List Malaysia public holidays in Selangor for 2026."

## Auth and Limits

No API key. The server is public and read-only — tools only issue `GET` requests. Calls share the same public API rate limits (500 requests / minute per IP, plus a heavy bucket for full-dataset queries). `GET /mcp/health` is not rate limited. See [Rate limits](https://docs.bilauitmcuti.com/getting-started.md#rate-limits) for details.

> [card] [Privacy Policy](https://docs.bilauitmcuti.com/mcp-server/privacy.md)
>
> How the MCP server handles data.

> [card] [Terms of Use](https://docs.bilauitmcuti.com/mcp-server/terms.md)
>
> Rules for using the server.

## Connect in Chat

Claude, Grok on the web, and Grok Bot use a custom connector. Choose **None** for authentication when asked.

> [tab] Claude
>
> **1. Open Connectors**
>
> Go to **Settings → Connectors** (or **+** in chat → **Connectors**) and choose **Add custom connector**.
>
> **2. Enter Details**
>
> Set **Connector name** to `Bila UiTM Cuti` and **Server URL** to `https://mcp.bilauitmcuti.com/mcp`. Leave OAuth empty and click **Add**.
>
> **3. Enable It**
>
> In chat, turn on **Bila UiTM Cuti** under Connectors.
>
> See [Get started with custom connectors using remote MCP](https://support.anthropic.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

> [tab] Grok
>
> **1. Open Connectors**
>
> Go to [grok.com/connectors](https://grok.com/connectors).
>
> **2. Create a Connector**
>
> Click **New Connector**, then **Custom**.
>
> **3. Paste the URL**
>
> Paste `https://mcp.bilauitmcuti.com/mcp`. If asked for authentication, pick **None**.
>
> See [xAI Connectors](https://docs.x.ai/grok/connectors).

> [tab] Grok Bot
>
> Grok Bot (Cursor's cloud agent) is separate from grok.com. Add the server from chat:
>
> ```text theme={null}
> Add this MCP server: https://mcp.bilauitmcuti.com/mcp
> ```
>
> Confirm the name and URL when prompted. Tools appear on the next message. Type **@** to attach the connector again if needed.
>
> See [Grok Bot — Connect an app](https://docs.x.ai/grok-bot/computer-and-apps).

## What Is MCP?

The [Model Context Protocol](https://modelcontextprotocol.io) is an open protocol for connecting AI assistants to outside data and tools. Through this server, your assistant can read:

* **Academic calendar** — sessions, activities, breaks, and exam weeks for groups A and B.
* **Lecture weeks** — the 14 teaching weeks in a session.
* **Today** — what is on for a given date.
* **Public holidays** — Malaysia holidays by year, coverage, and state.

## How It Works

The server runs remotely over the Streamable HTTP transport at `/mcp`. Your client connects to the URL, and the server turns each request into a `GET` call to `/api/v1/*` and hands back the result. There is nothing to install or run locally.

## Available Tools

| Tool | Endpoint | Description |
| - | - | - |
| `get_academic_meta` | `GET /api/v1/meta` | List UiTM sessions & programs — use first for valid session IDs (group A/B or all). |
| `get_calendar` | `GET /api/v1/calendar` | Get academic calendar activities — lectures, breaks, exams for a session or group. |
| `get_today_status` | `GET /api/v1/today` | Check if a date is a class day, break, exam week, or study week (group required). |
| `get_lecture_weeks` | `GET /api/v1/lecture-weeks` | Get lecture week dates (Week 1–14) for one session. |
| `get_public_holiday_meta` | `GET /api/v1/public-holiday/meta` | List public holiday filters — years, coverage, and state slugs. |
| `get_public_holidays` | `GET /api/v1/public-holiday` | List Malaysia public holidays by year, coverage, and state. |

Boolean query flags accept real booleans. `get_calendar` and `get_public_holidays` also accept `limit` / `compact` to trim large payloads. For endpoint field details, see [Academic calendar](https://docs.bilauitmcuti.com/academic-calendar.md) and [Public holidays](https://docs.bilauitmcuti.com/public-holidays.md).

## Example Call

A typical `tools/call` request (Streamable HTTP POST body):

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_today_status",
    "arguments": {
      "group": "B",
      "date": "2026-03-09"
    }
  }
}
```

The tool returns both a text block (stringified JSON) and `structuredContent` for clients that prefer typed results.

## Verify It Works

Use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector):

```bash theme={null}
npx @modelcontextprotocol/inspector https://mcp.bilauitmcuti.com/mcp
```

Or list tools with `curl` (POST only — a bare `GET /mcp` returns `405`, which is expected):

```bash theme={null}
curl -s -X POST 'https://mcp.bilauitmcuti.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Uptime monitors (Better Stack) should `GET` `https://mcp.bilauitmcuti.com/mcp/health` and expect HTTP `200` — not `GET /mcp`.

## Configuration

Any client that supports remote Streamable HTTP MCP can use `https://mcp.bilauitmcuti.com/mcp`.

> [tab] Cursor
>
> Save as `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global), enable the server under **Cursor Settings → MCP**, then restart Cursor.
>
> ```json .cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "bilauitmcuti": {
>       "url": "https://mcp.bilauitmcuti.com/mcp"
>     }
>   }
> }
> ```

> [tab] Claude Code
>
> Run the CLI, or add the JSON to your project's `.mcp.json`.
>
> ```bash theme={null}
> claude mcp add --transport http bilauitmcuti https://mcp.bilauitmcuti.com/mcp
> ```
>
> ```json .mcp.json theme={null}
> {
>   "mcpServers": {
>     "bilauitmcuti": {
>       "type": "http",
>       "url": "https://mcp.bilauitmcuti.com/mcp"
>     }
>   }
> }
> ```
>
> > [!NOTE]
> >
> > Claude Desktop, web, and mobile use [Connect in chat](#connect-in-chat) instead.

> [tab] VS Code
>
> Save as `.vscode/mcp.json`. GitHub Copilot in VS Code expects a top-level `servers` key.
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "bilauitmcuti": {
>       "type": "http",
>       "url": "https://mcp.bilauitmcuti.com/mcp"
>     }
>   }
> }
> ```

> [tab] Codex
>
> Run the CLI, or paste the TOML into `~/.codex/config.toml` and restart Codex.
>
> ```bash theme={null}
> codex mcp add bilauitmcuti --url https://mcp.bilauitmcuti.com/mcp
> ```
>
> ```toml ~/.codex/config.toml theme={null}
> [mcp_servers.bilauitmcuti]
> url = "https://mcp.bilauitmcuti.com/mcp"
> ```

> [tab] OpenCode
>
> Run the CLI, or add the `mcp` section to `opencode.json`.
>
> ```bash theme={null}
> opencode mcp add bilauitmcuti --url https://mcp.bilauitmcuti.com/mcp
> ```
>
> ```json opencode.json theme={null}
> {
>   "$schema": "https://opencode.ai/config.json",
>   "mcp": {
>     "bilauitmcuti": {
>       "type": "remote",
>       "url": "https://mcp.bilauitmcuti.com/mcp",
>       "enabled": true
>     }
>   }
> }
> ```

## Example Prompts

Once it is connected, ask things like:

* When does lecture week 1 start for session B-20264?
* Is 2026-03-09 a class day for Group B Diploma?
* List Malaysia public holidays in Selangor for 2026.
* What UiTM sessions are available for Group A?

## Troubleshooting

> [accordion] Tools Don't Show Up
>
> Remove any existing `bilauitmcuti` server or connector, add it again with `https://mcp.bilauitmcuti.com/mcp`, then restart the client and refresh the tools list.

> [accordion] Can't Connect or Fetch Failed
>
> Use Streamable HTTP with `type: "http"` where supported, and check the URL is exactly `https://mcp.bilauitmcuti.com/mcp`.

> [accordion] GET /mcp Returns 405
>
> Expected. Use `POST` or the MCP Inspector for Streamable HTTP.

> [accordion] Rate Limited (429)
>
> Wait the number of seconds in the `Retry-After` header, then retry.

## Changelog

* **1.0.2** — server instructions and Blue B connector icons; privacy and terms under `/docs/mcp-server/`.
* **1.0.1** — improved tool titles and parameter descriptions.
* **1.0.0** — remote Streamable HTTP server with calendar and public-holiday tools.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.