About masnavi
masnavi provides Rumi's complete Masnavi as a free, read-only MCP service for agents working with Persian poetry. Its tools support text search, quotation verification, and scholarly commentary to ground responses in the source.
Key features
- 01Search the complete poem
- 02Retrieve a couplet by citation with neighbors
- 03Fuzzy-check Rumi quotations
- 04Browse stories and the table of contents
- 05Get per-couplet scholarly commentary
- 06Retrieve a random couplet
Use cases
- 01Find couplets about a topic
- 02Verify a quotation attributed to Rumi
- 03Read a complete story by section
- 04Look up scholarly commentary on a couplet
MCP support
The public MCP service exposes poem search, quotation verification, and commentary tools over HTTP, without authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://masnavi.ai/mcpclaude mcp add --transport http ai-masnavi-masnavi https://masnavi.ai/mcp{"mcpServers":{"ai-masnavi-masnavi":{"type":"http","url":"https://masnavi.ai/mcp"}}}Open in Cursor{"servers":{"ai-masnavi-masnavi":{"type":"http","url":"https://masnavi.ai/mcp"}}}Open in VS Code{"mcpServers":{"ai-masnavi-masnavi":{"type":"http","url":"https://masnavi.ai/mcp"}}}{"mcpServers":{"ai-masnavi-masnavi":{"serverUrl":"https://masnavi.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
13| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| query | string | Yes | Persian text to search for |
| daftar | any | No | Restrict to a single daftar (1-6) |
| offset | integer | No |
Details
From the project READMEmasnavi.ai — Rumi's Masnavi as an MCP server
The complete Masnavi-ye Maʿnavi of Jalāl al-Dīn Rūmī — all 25,635 beyts (couplets) in 6 daftars, 972 sections — served as a free, public, read-only Model Context Protocol server. Your agent can search, quote, verify, and explain Rumi from the canonical text instead of inventing him.
- Site: https://masnavi.ai (read it in 31 languages)
- MCP endpoint:
https://masnavi.ai/mcp(Streamable HTTP, no auth) - REST + OpenAPI: https://masnavi.ai/api/openapi.json
- Discovery: https://masnavi.ai/.well-known/mcp.json · https://masnavi.ai/llms.txt
- Docs: https://masnavi.ai/docs
Connect
{ "mcpServers": { "masnavi": { "type": "http", "url": "https://masnavi.ai/mcp" } } }
Claude Code: claude mcp add --transport http masnavi https://masnavi.ai/mcp
Tools (9)
| Tool | What it does |
|---|---|
search | full-text search across all 25,635 beyts, ranked |
lookup | a beyt by citation (M1:1 = daftar 1, beyt 1) with neighbours |
verify | is this really a line by Rumi? fuzzy-checks a quotation against the corpus |
get_section | one named section (story) with all its beyts |
get_range | a full multi-section story in one call (≤500 beyts) |
find_sections | find a story by (Persian) title fragment |
table_of_contents | the 972 sections, by daftar |
random_beyt | a random couplet |
explain | per-beyt commentary by named scholars |
Citations use M{daftar}:{beyt} (e.g. M3:1278). Text sourced from
Ganjoor; the Masnavi is in the
public domain.
Why
Language models routinely misattribute Persian poetry. This server exists so agents can ground every Rumi quotation in the canonical text — search it, cite it, and verify it — in any language.
This repository holds the public metadata for the hosted server at masnavi.ai; the service itself runs at the endpoint above.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.