maktabkhooneh-mcp: Maktabkhooneh MCP server for AI agents

Unofficial, read-only MCP server that lets your AI agent search Maktabkhooneh (مکتب‌خونه), the Iranian online course platform: compare prices and discounts, find free courses, read curricula and reviews, look up teachers and universities.

Covers about 5,700 Persian video courses on maktabkhooneh.org, prices in Toman. No API key, no account. Works with Claude, Cursor and Copilot.

Quick start · Tools · FAQ · فارسی

For AI agents

• What: Unofficial MCP server for Maktabkhooneh (مکتب‌خونه, maktabkhooneh.org), an Iranian online course platform. Queries in Persian work best; prices in Toman.
• Install: claude mcp add maktabkhooneh -- uvx maktabkhooneh-mcp (stdio, needs uv and Python 3.10+).
• Auth: none. Optional MAKTABKHOONEH_MCP_PROXY sets an HTTP proxy (or a comma-separated list) for every request.
• Access: read-only. It cannot log in, enrol, buy or review.
• Tools: 12, all prefixed mkh_. Start with mkh_search, mkh_browse, mkh_cheapest, mkh_course, mkh_free_courses.
• Typical sequence: mkh_search (or mkh_categories -> mkh_browse) -> mkh_course -> mkh_curriculum or mkh_reviews.
• Use when: the user wants to find an Iranian online course, compare price, level, hours and rating, find free or discounted courses, or look up a teacher or a university's courses.
• Do not use when: the user wants to enrol, pay, watch lessons or needs their own account data.
• Output: compact JSON. Prices in Toman (final_price is what you pay, 0 = free), rating 0-5, numeric course ids to pass between tools, paging with next_page.
• Machine-readable: server.json, and the catalog of all Iranian MCP servers awesome-iran-mcp.

Quick start

You need uv.

claude mcp add maktabkhooneh -- uvx maktabkhooneh-mcp

Any other MCP client (Claude Desktop, Cursor, VS Code): run uvx maktabkhooneh-mcp as a stdio server (or pip install maktabkhooneh-mcp and run maktabkhooneh-mcp), e.g.

{
  "mcpServers": {
    "maktabkhooneh": { "command": "uvx", "args": ["maktabkhooneh-mcp"] }
  }
}

Then ask, for example:

• "The cheapest Python courses on Maktabkhooneh with a certificate, and which has the best rating?"
• "Free advanced programming courses from University of Tehran."
• "What is in course 1318 and what do learners say about it?"
• بهترین دوره‌های رایگان زبان انگلیسی کدامند؟

How it works

maktabkhooneh-mcp runs locally and calls the same public JSON API the maktabkhooneh.org website uses (/api/v1/courses/..., /api/v1/accounts/teacher/..., /api/v1/organization/...); the publisher list is read from the site's sitemap. No hosted server in between. API map and quirks: ../maktabkhooneh/.

Tools

All 12 tools are annotated readOnlyHint: true and return compact structured JSON.

Find courses

One course

People

Good to know

• Prices are in Toman (the site shows the same numbers with «تومان»; its JSON-LD labels them IRR, which is wrong). final_price is what you pay, price the list price (shown only when discounted), discount_pct a whole percent, free true for 0.
• The site cannot sort or filter by price. mkh_cheapest and mkh_deals scan the first 300 results (3 requests of 100) and sort here; scanned of total tells how complete the answer is. Use mkh_browse filters to narrow the pool first.
• mkh_search reaches only the first 300 matches and the site ignores filters there; filter with mkh_browse instead (it has no text query).
• full, content_only, upgrade in mkh_course: the whole course (lessons, projects, certificate), lessons only, and the price to upgrade from lessons-only to full.
• hours is a number, or "H:MM" for courses under two hours.
• kind: PLUS paid, MAKTAB free, HAMAYESH events.
• Discounts are time limited (a site-wide sale ran 14-22 Oct 2026); mkh_course gives discount_ends.
• Persian queries match best.

Configuration

FAQ

Is there a Maktabkhooneh API or MCP server for AI agents? Yes: this unofficial MCP server wraps the public JSON API the maktabkhooneh.org website itself uses, so Claude, Cursor or Copilot can search courses and read prices, curricula and reviews.

Is it official, safe and free? It is unofficial, open source (MIT) and free. It is read-only, needs no account or API key, and runs on your machine with no hosted server in between.

Can it enrol me or play a lesson? No. It only reads public catalog data. Enrolment, payment and lessons happen on maktabkhooneh.org.

فارسی: سرور MCP مکتب‌خونه

Related servers

• Fidibo MCP server for Persian ebooks and audiobooks
• Taaghche MCP server for Persian ebooks and audiobooks
• All Iranian MCP servers: awesome-iran-mcp

Development

export HTTPS_PROXY=http://127.0.0.1:10898 HTTP_PROXY=http://127.0.0.1:10898   # uv downloads only
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, on recorded fixtures
uv run python -m pytest -m live -q    # real API

If this saves you clicks, a star helps others find it.

License

MIT