Ganjoor Poetry

● Active

io.github.sepehr071/ganjoor-mcp

Read-only Ganjoor (ganjoor.net) Persian poetry: poems with meanings, search, meters, audio.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "ganjoor-mcp": {
      "command": "uvx",
      "args": [
        "ganjoor-mcp"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add ganjoor-mcp -- uvx ganjoor-mcp
OpenAI Codex CLI
codex mcp add ganjoor-mcp -- uvx ganjoor-mcp
VS Code
code --add-mcp '{"name":"ganjoor-mcp","type":"stdio","command":"uvx","args":["ganjoor-mcp"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Education & Reference
Version
0.1.0
Registry
active
Published
11/21/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: Ganjoor Poetry is maintained.

Maintained
Active
Last commit today (Nov 21, 2026), 1 open issues.
Official registry
Active
Published as io.github.sepehr071/ganjoor-mcp in the official MCP registry, version 0.1.0.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
On your machine
A local PyPI package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 22, 2026
Stars
0
Forks
0
Last push
Nov 21, 2026
License
Other

Pythonclaudefarsiganjoorhafeziranmcpmcp-servermodel-context-protocolpersianpersian-poetry

From the README

ganjoor-mcp: Ganjoor (گنجور) Persian poetry MCP server for AI agents ganjoor-mcp is an unofficial, read-only MCP server that lets an AI agent read, search and explain classical Persian poetry on Ganjoor (گنجور, ganjoor.net), the open library of 240+ poets and 139,000 poems. Its 18 tools search poems by words or by meaning, find the poem a quoted line comes from, read a poem with the plain-Persian meaning of every couplet, browse poets and books, and explore meters, rhymes, recitations, rhetorical devices, word use, people, places and manuscript scans. No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client. For AI agents · Quick start · Tools · Limits · فارسی For AI agents • What: unofficial MCP server (model context protocol) for ganjoor.net: full-text and semantic poem search, quoted-line lookup, poems with couplet meanings and summaries, poets, books, Hafez faal, meters and rhymes, recitations with verse timing, literary devices, word frequency, people and family trees, places, museum manuscripts, Tajik Cyrillic text. • Install: uvx ganjoor-mcp or claude mcp add ganjoor -- uvx ganjoor-mcp. Transport: stdio. Needs uv (Python 3.10+). • Auth: none. Optional GANJOORMCPPROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. • Access: read-only. It cannot log in, comment, vote or upload. Works from any country. • Tools: 18, all prefixed gj.…

Read the full README on GitHub →

The most-starred Education & Reference servers in the index, with their live-check result.

ServerStarsLast pushLive check
Honcho8,178Nov 2026Needs sign-in
Zotero MCP6,020Nov 2026Local / not checked
Tolgee4,162Nov 2026Working
LearnHouse2,485Nov 2026Needs sign-in
obsei1,454Nov 2026Local / not checked

Ganjoor Poetry: questions people ask

Is Ganjoor Poetry a remote or a local MCP server?
According to its entry in the official MCP registry, Ganjoor Poetry ships as a local package (PyPI) that your client starts on your machine.
Is Ganjoor Poetry safe to use?
Mostly fine: Ganjoor Poetry is maintained. In detail — maintained: Active; official registry: Active; source: No licence found; runs: On your machine; credentials: None declared. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Ganjoor Poetry still maintained?
Active: the repository's last commit today. Last push Nov 21, 2026, 0 GitHub stars, Other licence. Read from GitHub on Nov 22, 2026.
How do I add Ganjoor Poetry to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. DigikalaUnofficial read-only Digikala: search products, compare sellers, price history, reviews, deals.★ 43
  2. Snappfood & SnappMarketUnofficial read-only Snappfood & SnappMarket: search food and groceries, compare prices, deals.★ 40
  3. Iran Jobs (IranTalent + Jobinja + Jobvision)Read-only Iran jobs: IranTalent, Jobinja, Jobvision side by side. Ads, companies, reviews, pay.★ 39
  4. Iran Gold PricesRead-only 18k gold prices on Iranian sites: Milli.gold, Wallgold, Melligold, Daric, Taline, Talano.★ 18
Browse all Education & Reference →

Add the badge to your site

Show visitors that Ganjoor Poetry is listed here — it’s also the link we check for a free listing.

Ganjoor Poetry — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sepehr071-ganjoor-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Ganjoor Poetry — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Ganjoor Poetry — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sepehr071-ganjoor-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-sepehr071-ganjoor-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-sepehr071-ganjoor-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-sepehr071-ganjoor-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-sepehr071-ganjoor-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-sepehr071-ganjoor-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-sepehr071-ganjoor-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).