pratham-jain33/hackerearth-mcp

mcp-name: io.github.pratham-jain33/hackerearth-mcp
Also listed on Glama with one-click deploy.
Give any AI assistant a code run button.
> Unofficial community project. Not made by, endorsed by, or affiliated with HackerEarth. You bring your own free HackerEarth API key.
## Why
AI assistants are great at writing code and terrible at knowing whether it works. They guess. This server plugs into any MCP-compatible assistant (Claude Desktop, Claude Code, Cursor, and more) and lets it actually run code in 24 programming languages on HackerEarth's sandboxed servers, then read the real output. No local toolchains to install. Nothing untrusted ever touches your machine.
## Tools
| Tool | Description |
| runcode | Sends code plus a language to HackerEarth, waits for it to run, and returns the printed output and any error messages. |
| listlanguages | Lists every language HackerEarth can run, with the exact identifiers to pass to runcode. Takes no inputs. |
## Installation
bash
# Quick install via uvx (recommended)
uvx hackerearth-mcp
bash
# Or install with pip
pip install hackerearth-mcp
bash
# Install from source
git clone https://github.com/pratham-jain33/hackerearth-mcp
cd hackerearth-mcp
python -m venv .venv
.venv/bin/pip install -e .
## Features
Exposes two MCP tools: runcode and listlanguages.
Executes code in 24 programming languages via HackerEarth's sandboxed cloud servers.
Provides friendly language aliases (e.g., python → PYTHON3).
Returns real program output and error messages.
Gracefully handles missing HACKEREARTHKEY and unknown languages without making network calls.
Lists all supported language identifiers.
Simple installation via uvx or pip.
Compatible with any MCP‑compatible AI assistant (Claude Desktop, Cursor, etc.).
## Tech/framework used
Language: Python (>=3.10)
Core libraries: FastMCP (provides MCP server framework), requests (HTTP client)
## Quickstart
1. Get a free HackerEarth API key
Register a client in the HackerEarth developer dashboard to receive a client-secret. The free tier includes a generous request quota.
2. Install
No cloning needed:
bash
uvx hackerearth-mcp
or with pip:
bash
pip install hackerearth-mcp
From source instead:
bash
git clone https://github.com/pratham-jain33/hackerearth-mcp
cd hackerearth-mcp
python -m venv .venv
.venv/bin/pip install -e .
3. Connect your assistant
Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
json
"mcpServers": {
"hackerearth": {
"command": "uvx",
"args": ["hackerearth-mcp"],
"env": {
"HACKEREARTHKEY": "paste-your-client-secret-here"
From source, point at your checkout instead:
json
"mcpServers": {
"hackerearth": {
"command": "/absolute/path/to/hackerearth-mcp/.venv/bin/python",
"args": ["/absolute/path/to/hackerearth-mcp/server.py"],
"env": {
"HACKEREARTHKEY": "paste-your-client-secret-here"
Restart Claude Desktop, then try: "run this Python program and tell me what it prints: print(6 7)"
## Configuration
| Variable | Required | Description |
| HACKEREARTHKEY | Yes | Your HackerEarth client-secret. Read from the environment, never hardcoded, never sent to the assistant in chat. |