# OAHelper [Health: Active]

**Category:** 🎓 Education  
**Repository:** https://github.com/SirjanSingh/oahelper-mcp  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/oahelper

## Description
Your OAHelper Pro account: OA sets, MCQ answers, solutions and interview experiences, offline

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "oahelper": {
    "command": "uvx",
    "args": ["oahelper-mcp"],
    "env": {
      "OAHELPER_COOKIE": "",
      "OAHELPER_HOME": ""
    }
  }
}
```

**Requires environment variables:** `OAHELPER_COOKIE`, `OAHELPER_HOME` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What OAHelper MCP server does

The OAHelper MCP server gives an MCP client read access to content available through your logged-in OAHelper account. It can list a company's online assessment sets, retrieve individual set and question pages, fetch MCQ answers and explanations, request official solutions in C++, Python, or Java, and load interview experiences.

Fetched material is written as plain Markdown rather than kept only in the agent conversation. Each company gets an index, set files, question files, and interview files under the local library. Images are saved only when requested. The saved library can be opened in Obsidian or read by an agent without making another request to OAHelper.

The package also includes nine skills for workflows such as mock assessments, MCQ practice, hint-based problem solving, interview preparation, study plans, and spaced revision. Claude Code can install the server and skills together through the provided plugin; the MCP server can also be run independently by another compatible client.

## How it works

The server launches as a local Python stdio process. With `uv`, the usual command is `uvx oahelper-mcp`; installation through pip or a cloned virtual environment is also documented. The implementation uses the official MCP SDK and Python's standard-library HTTP support.

Available operations include searching a company's sets, syncing sets and their contents, opening one company set, reading one question, retrieving a language-specific official solution, listing interview experiences, checking the offline library, and checking session status. Search results are cached for one day. Sync is bounded by `max_items`, downloads newest content first, and reports whether more work remains. Offline inspection does not require a session or network request.

The server is designed around deliberate, limited access: requests are spaced by two seconds, a daily request limit defaults to 300, and cached content is not fetched again unnecessarily. These controls do not remove the account or service risks described by OAHelper's terms.

## Setup and configuration

Install `uv` with Python 3.10 or newer, or install the package with pip. Configure the OAHelper MCP server with the cookie from an authenticated browser session. Copy the complete `cookie` request header from a browser request containing `/api/proxy/` and set it as `OAHELPER_COOKIE`. Treat this value as a password: do not place it in prompts, commit it to source control, or share it.

Data is stored in `~/.oahelper` by default. Set `OAHELPER_HOME` to use another location. When running from a repository clone, the data directory, cache, and `.env` are located in the clone unless the home setting changes that behavior. The documented client configurations cover Claude Code, Claude Desktop, Cursor, VS Code Copilot agent mode, Codex CLI, Gemini CLI, Windsurf, and Cline.

After configuration, ask the agent to run the status operation with online checking enabled. A valid session and Pro account are needed for most content, and the session must be renewed if OAHelper rejects it after logout or expiration.

## Limitations and notes

The OAHelper MCP server is intended for access to your own account and content already included in your plan. OAHelper's terms prohibit automated access and scraping; the README warns that misuse can result in losing the Pro account. Use it one company at a time when requested, do not crawl the site, and do not publish or share the saved content.

Official solutions consume the account's solution quota. Some content requires a Pro account. The cookie-based session is not permanent, and online operations depend on the authenticated browser session. Offline files remain available after synchronization, but they contain only material previously saved to disk.

_Full upstream README: https://allmcps.com/mcp/oahelper/readme_