Skip to main content
Glama

Server Details

Rumi's complete Masnavi (25,635 beyts) — search, quote, verify and explain. Free, no auth.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A3.9/5.0

Scored across 13 tools

Disambiguation5/5

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).

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness5/5

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 tools
explainAInspect

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

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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      44
      91 npm
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Search and retrieve Devanagari Hindi shayari from an owner-authorized, provenance-tracked corpus, with audit and research-only inspection capabilities via stdio.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables local, auditable semantic search over a pinned subset of Mirza Ghalib's Urdu corpus, retrieving existing couplets with provenance and license evidence.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to retrieve canonical Quran text, translations, scholarly tafsir, full-text search, and word-level morphology from verified Quran data.
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.