ai.masnavi/masnavi

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "masnavi": {
      "url": "https://masnavi.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• search

  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.

  Parameters:

  • query (required) — string — Persian text to search for
  • limit — integer
  • daftar — Restrict to a single daftar (1-6)
  • offset — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_meaning

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

  Parameters:

  • query (required) — string — What the verse should MEAN, in any language
  • limit — integer
  • daftar — Restrict to a single daftar (1-6)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup

  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.

  Parameters:

  • after — integer
  • before — integer
  • daftar
  • citation — Citation like 'M3:1278' or 'g:7421'
  • beyt_global
  • beyt_in_daftar

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify

  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.

  Parameters:

  • text (required) — string — Candidate Rumi quote in Persian
  • fuzzy_threshold — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_section

  Retrieve a full section (story / بخش) with all its beyts.

  Parameters:

  • slug — Stable URL slug
  • section_id

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• table_of_contents

  Browse the Masnavi's section list. Returns titled sections per daftar with beyt counts and ranges.

  Parameters:

  • daftar

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• random_beyt

  Return a randomly-selected beyt, optionally restricted to a daftar.

  Parameters:

  • daftar

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_range

  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.

  Parameters:

  • end — End citation, e.g. 'M2:2775'
  • start — Start citation, e.g. 'M2:2608'
  • end_global
  • start_global

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_sections

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

  Parameters:

  • query (required) — string — story title words (Persian) or a description of the story in any language
  • limit — integer
  • daftar

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• explain

  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 <scholar> say about M1:1'.

  Parameters:

  • citation (required) — string — Citation like 'M1:1' or 'M3:1278' or 'g:7421'.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_divan

  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.

  Parameters:

  • query (required) — string — Persian text to search for
  • limit — integer
  • offset — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_divan_meaning

  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.

  Parameters:

  • query (required) — string — What the ghazal should be ABOUT, in any language
  • limit — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_ghazal

  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) = «مرده بدم زنده شدم…».

  Parameters:

  • number — Ghazal number, e.g. 1393
  • citation — Divan citation like 'G1393' or 'G1393:2'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.