maktabkhooneh · git:20261020.5320264 · 2026-10-20 · sha256 626ded028372124e

maktabkhooneh git:20261020.5320264A

Immutable. This exact content never changes and is served at /api/v1/blob/626ded028372124e.

---
name: maktabkhooneh
description: "Unofficial read-only Maktabkhooneh: search Persian online courses, compare prices, find free ones. Use when the user asks about Maktabkhooneh (maktabkhooneh.org) or wants online courses, lessons or certificates in Iran."
---

# Maktabkhooneh

Unofficial read-only Maktabkhooneh: search Persian online courses, compare prices, find free ones.

The tools below come from the `maktabkhooneh-mcp` MCP server. If they are not available, install it with `claude mcp add maktabkhooneh -- uvx maktabkhooneh-mcp`, or add `"maktabkhooneh": {"command": "uvx", "args": ["maktabkhooneh-mcp"]}` to the client's MCP servers config. It needs [uv](https://docs.astral.sh/uv/). Restart the session after installing.

## Tools

- `mk_search`: Full-text search of courses by title/topic: price, discount, hours, rating, students, teachers.
- `mk_browse`: List courses of a category (or all about 5700) with the site's own filters: type, level, hours, rating, publisher, feature.
- `mk_free_courses`: List the free courses (final_price 0, about 740 of them), optionally in one category: hours, rating, students.
- `mk_cheapest`: Cheapest paid courses for a topic or category, ascending by final_price (what the customer pays).
- `mk_deals`: Currently discounted courses, biggest discount first (discount_pct, price before and final_price after).
- `mk_course`: One course: prices (full vs content-only), discount end, level, hours, teachers, publisher, prerequisites, FAQ.
- `mk_curriculum`: The chapters and lessons of a course with type (lecture, quiz, project...) and duration (mm:ss).
- `mk_reviews`: Learner reviews of a course (stars 1-5, text, date, instructor reply) plus the star histogram.
- `mk_categories`: Category tree (about 680 nodes in 11 top-level groups): slugs for mk_browse, mk_free_courses, mk_cheapest, mk_deals.
- `mk_teacher`: A teacher's profile (bio, students, rating, teaching hours, links) and their courses with prices.
- `mk_organizations`: Course publishers (universities, companies, Maktabkhooneh itself, about 180) with the id used as a filter.
- `mk_organization`: A publisher's totals (courses, students, rating) and its most popular courses.

## Rules

- Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
- Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
- Keep request rates low. These are undocumented site APIs that can change or rate-limit.
- On timeouts or HTTP 403 outside Iran, set `MAKTABKHOONEH_MCP_PROXY` to an HTTP proxy with an Iranian IP.