masnavi
Server Details
Rumi's complete Masnavi (25,635 beyts) — search, quote, verify and explain. Free, no auth.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- shahhoseini/masnavi-mcp
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 13 tools
Each tool targets a clearly distinct operation: direct fetch (lookup, get_section, get_range, get_ghazal), search (search, search_divan, search_meaning, search_divan_meaning), section browsing (find_sections, table_of_contents), and special utilities (explain, verify, random_beyt). Even the four search tools are cleanly separated by corpus (Masnavi vs Divan) and mode (exact vs semantic).
The get_* and search* prefixes cover 7 of 13 tools, but the rest use inconsistent patterns: bare verbs (explain, lookup, verify), a noun phrase (table_of_contents), and an adjective-noun (random_beyt). Names are readable and all snake_case, but the convention is mixed.
13 tools is well-scoped for a corpus-access server covering two major poetic works. Each tool earns its place: retrieval, section/range browsing, two kinds of search per corpus, quote verification, and commentary.
The surface covers the domain thoroughly: citation lookup, bulk retrieval, table of contents, full-text and semantic search for both the Masnavi and Divan-e Shams, quote verification, and scholarly commentary. No obvious dead ends or missing core operations.
Available Tools
13 toolsexplainAInspect
Get commentary (Persian + English) for a specific beyt of the Masnavi, attributed to a primary source (e.g. Abdolkarim Soroush's lectures). Returns the beyt text along with structured commentary entries. Each entry has source, author, language, body markdown, and confidence ('ai-draft' / 'reviewed' / 'verbatim'). Use this when a user asks 'what does this beyt mean' or 'what does say about M1:1'.
Inputs: citation (required).
find_sectionsAInspect
Find sections (stories) by TITLE. Exact words first (phrase, then AND-of-tokens); when NO title contains the words, falls back to MEANING matches in any language (hits carry match='meaning' + a cosine score — verify with get_section before relying on one). Each match includes first_citation and last_citation — ready-to-use canonical citations (e.g. 'M2:2608'). To read a whole multi-section story, call get_range with the FIRST match's first_citation as start and the LAST match's last_citation as end. Do NOT construct a citation from first_beyt_global — that is a GLOBAL index (1..25635), not a daftar-local beyt number. Example: find_sections('ابلیس معاویه', daftar=2).
Inputs: query (required), limit, daftar. Returns: note, query, total, sections
get_ghazalAInspect
Fetch ONE complete ghazal of the Divan-e Shams by its canonical number (1..3230) or citation ('G1393' / 'G1393:2'). Returns every beyt plus prev/next ghazal numbers. Famous example: get_ghazal(1393) = «مرده بدم زنده شدم…».
Inputs: number, citation. Returns: slug, beyts, ghazal, excerpt, +5 more
get_rangeAInspect
Fetch ALL beyts between two endpoints, inclusive, grouped by section. Use this — NOT many calls to get_section or lookup — when a user asks for a full story, a long passage, or a sequence of beyts spanning multiple sections. Endpoints are canonical citations like 'M2:2608' and 'M2:2775', or global indices via start_global / end_global. Max range: 500 beyts.
Inputs: end, start, end_global, start_global. Returns: sections, total_beyts, end_citation, start_citation, +1 more
get_sectionBInspect
Retrieve a full section (story / بخش) with all its beyts.
Inputs: slug, section_id. Returns: id, slug, beyts, daftar, +4 more
lookupAInspect
Fetch a specific beyt by its citation (e.g. 'M3:1278'), by daftar+beyt number, or by global beyt index. Optionally include surrounding beyts for context.
Inputs: after, before, daftar, citation, +2 more. Returns: primary, context_after, context_before
random_beytAInspect
Return a randomly-selected beyt, optionally restricted to a daftar.
Inputs: daftar. Returns: daftar, mesra1, mesra2, citation, +5 more
searchBInspect
Full-text search across the Masnavi. Returns beyts that contain the query terms, ranked by relevance. Useful for finding where a theme, word, or phrase appears.
Inputs: query (required), limit, daftar, offset. Returns: match, query, total, results
search_divanAInspect
Full-text search across the 34,603 beyts of the ghazals of the Divan-e Shams (Divan-e Kabir) — Rumi's lyric work, distinct from the Masnavi. Returns beyts with divan citations (G{ghazal}:{beyt}, e.g. G1393:1). Use when you know the exact Persian words; use search_divan_meaning for a theme in any language.
Inputs: query (required), limit, offset. Returns: match, query, total, results
search_divan_meaningAInspect
Semantic search over the Divan-e Shams ghazals: given a theme, feeling, or idea in ANY language, returns the GHAZALS closest in meaning — each with its best-matching couplet as a preview and a cosine score. Both couplet-level and whole-ghazal vectors are searched, so a ghazal whose overall theme matches is found even when no single couplet does. Fetch a full ghazal with get_ghazal. status='unavailable' means the index is not built — fall back to search_divan.
Inputs: query (required), limit. Returns: note, query, status, results, +2 more
search_meaningAInspect
Semantic search: find the beyts closest in MEANING to the query, in ANY language — English, Persian, Spanish, Turkish, Arabic, … . Use this when you have a theme, feeling, or idea rather than exact Persian words (e.g. 'feeling separated from your origin' → M1:1). Each hit carries a cosine-similarity score. status='unavailable' means the vector index is not built yet — fall back to search.
Inputs: query (required), limit, daftar. Returns: note, query, status, results, +1 more
table_of_contentsAInspect
Browse the Masnavi's section list. Returns titled sections per daftar with beyt counts and ranges.
Inputs: daftar. Returns: nodes, daftar
verifyAInspect
Given a candidate quote attributed to Rumi's Masnavi, check whether it actually appears. Returns status='exact' (with citation), 'fuzzy' (with similar candidates), or 'not_found'. USE THIS BEFORE QUOTING RUMI to avoid hallucination.
Inputs: text (required), fuzzy_threshold. Returns: notes, status, matches, query_normalized
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Quran, hadith collections and tafsirs: browse books and chapters, read verses, full-text search
Classical Islamic library (Shamela, 8,594 books): verbatim Arabic cited by volume and page. No key.
Complete classical & world literature — search + cite exact passages, facing sources, 50+ languages.
Ayatollah Khamenei corpus: fatwas, lectures, knowledge graph. Arabic/Persian. Research access.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables AI assistants and agents to browse Persian classical poetry collections, read poems and verses, run prosody and rhyme analysis, trace reply-poems, look up recitations and commentary, and explore related-people and family-tree data through structured read-only tools.4491 npm7MIT- AlicenseAqualityCmaintenanceSearch and retrieve Devanagari Hindi shayari from an owner-authorized, provenance-tracked corpus, with audit and research-only inspection capabilities via stdio.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables local, auditable semantic search over a pinned subset of Mirza Ghalib's Urdu corpus, retrieving existing couplets with provenance and license evidence.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to retrieve canonical Quran text, translations, scholarly tafsir, full-text search, and word-level morphology from verified Quran data.-
Glama MCP Gateway
Add one secure layer between your agents and this server.