ganjoor-mcp-server — Claude Code MCP server: Persian poetry
An MCP server for the Ganjoor API. Agents can read Persian classical poems, analyse metre and rhyme, and trace reply-poems. No API key needed.
claude mcp add ganjoor-mcp-server -- npx -y ganjoor-mcp-serverWhat ganjoor-mcp-server does
This server wires an agent into Ganjoor, a database of classical Persian poetry. It ships 44 tools: browsing poets and collections, reading a poem verse by verse, running prosody and rhyme analysis, tracing reply-poems between poets, and looking up recitations and commentary. Related-people and family-tree graphs are covered too.
Access is read-only and no API key is involved. The package runs through npx and needs Node.js 18.17 or newer. On Claude one line is enough: claude mcp add ganjoor-mcp-server -- npx -y ganjoor-mcp-server. Codex and Gemini CLI take their own commands; Cursor and GitHub Copilot expect a JSON config entry.
If your Node.js is older than 18.17, the server will not start — check the version first. The package installs locally and speaks stdio.
What it helps with
- find a poem by a Persian poet by title or number
- read a full poem with its verses split out
- analyse the metre and rhyme of a chosen poem
- trace reply-poems one poet wrote to another
- look up recitations and commentary for a poem
Example prompts for the agent
- Find a Hafez poem about wine and list every verse
- Analyse the metre and rhyme of this poem
- Find reply-poems other poets wrote to this one
How to install ganjoor-mcp-server
Platform CLI
claude mcp add ganjoor-mcp-server -- npx -y ganjoor-mcp-serverPlatform CLI
codex mcp add ganjoor-mcp-server -- npx -y ganjoor-mcp-serverConfig file
{
"mcpServers": {
"ganjoor-mcp-server": {
"command": "npx",
"args": [
"-y",
"ganjoor-mcp-server"
]
}
}
}Config file
{
"servers": {
"ganjoor-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ganjoor-mcp-server"
]
}
}
}Platform CLI
gemini mcp add ganjoor-mcp-server npx -y ganjoor-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ganjoor-mcp-server
How do I install ganjoor-mcp-server in Claude Code?
Run claude mcp add ganjoor-mcp-server -- npx -y ganjoor-mcp-server. Node.js 18.17 or newer is required.
What does ganjoor-mcp-server do?
It gives an agent 44 tools against the Ganjoor API: poets and collections, poem reading, prosody and rhyme analysis, reply-poems, recitations and commentary.
Does ganjoor-mcp-server need an API key?
No. Access is read-only and no key is required — you just need Node.js 18.17+ installed.
