Skip to main content
Glama
25ds1000090-lang

IITM Live MCP Server

README.md
# IITM Live MCP Server

This repository deploys a Streamable HTTP MCP server with exactly one tool:

- `solve_challenge`

The public MCP URL is:

```text
https://YOUR-RENDER-SERVICE.onrender.com/mcp
```

## Render deployment

1. Create a GitHub repository.
2. Upload every file from this folder.
3. In Render, choose **New > Blueprint** and select the repository.
4. Render will read `render.yaml`.
5. After deployment, copy the Render URL and append `/mcp`.

## Manual Render settings

If you create a Web Service instead of a Blueprint:

```text
Build command:
pip install -r requirements.txt

Start command:
uvicorn main:app --host 0.0.0.0 --port $PORT
```

## Local run

```bash
python -m venv .venv
```

Windows:

```bash
.venv\Scripts\activate
```

Linux/macOS:

```bash
source .venv/bin/activate
```

Then:

```bash
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000
```

MCP endpoint:

```text
http://localhost:8000/mcp
```

Health endpoint:

```text
http://localhost:8000/health
```

The tool reads `X-Exam-Challenge` from the HTTP request headers and returns the
first 16 lowercase hexadecimal characters of:

```text
SHA-256("<challenge>:25ds1000090@ds.study.iitm.ac.in")
```