MCP servers › io.github.ehsanghaffar › ganjoor-mcp-server

MCP server · registry snapshot 2026-10-23 · last tested 2026-10-23

io.github.ehsanghaffar/ganjoor-mcp-server

MCP server for the Ganjoor (گنجور) Persian classical poetry API at https://ganjoor.net — the publisher's description

8 of 9 record checks metRead-only · tools listed 2026-10-23version 0.1.0TypeScriptMITstandard input/output44 tools

Summary

io.github.ehsanghaffar/ganjoor-mcp-server is a local MCP server listed in the official MCP registry at version 0.1.0. On 2026-10-23 ProtocolProbe started its published package in an isolated sandbox in read-only mode and read its inventory: 44 tools, 0 resources and 0 prompts.

Record checks

8 of 9 record checks met

met: Registry entry is active and says how to run it
met: Source repository link opens
met: Repository is not archived
met: Code pushed to the repository in the 90 days before our check
met: Repository publishes a security policy (SECURITY.md)
met: Package names its licence with a standard (SPDX) identifier
met: The version the registry lists can be installed and is not withdrawn
not met: npm package carries build provenance (attestation)
met: No known critical or high advisory in the package or its dependencies

#14,666 of 15,112 packages by monthly downloads, tied with 5 others
Not ranked by stars: 7 stars (ranked from 10)

From public records, not a safety rating. Each check with its reason · Is it safe to install?

Key facts

Runs: local package
Transport: standard input/output
Package: npm · listed version current
License: MIT
Dependencies: no known high or critical advisories
Repository: public
Tools: 44
Described as changing data: 0 of 44 toolsAI-classified
Mainly works on: nothing outside itself: it only answers questionsAI-classified
Last tested: 2026-10-23

Add to your client

How fresh this is

Live-tested: yes, a real session (not a text-only review)
Last tested: 2026-10-23
Mode: read-only (no tool calls)
Latest version: 0.1.0, published 2026-10-14 (registry, as of the 2026-10-23 snapshot)
First listed version: 2026-10-14 (earliest version still in the registry; older removed versions would be earlier)
Registry data: snapshot 2026-10-23
Package and repository: checked 2026-10-23
Engine: mcp-runtime-engine@0.1.0 · sdk@1.32.0

Changes since the last refresh

New in the registry: not in the list of 2026-10-04, listed on 2026-10-23 with version 0.1.0 (published 2026-10-14).

Source: the official MCP Registry list on 2026-10-04 and on 2026-10-23.

What it is

What does this server offer?

Observed inventory

44tools

0resources

0prompts

What it mainly works on, as our AI model read its tool descriptions: nothing outside itself: it only answers questions.

None of its 44 tools are described as changing anything. For 4 the reading was uncertain, so no mark is shown.

ganjoor_list_poetsreads or searches
“List all poets published on Ganjoor.net, including their biographies.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poetreads or searches
“Get a single poet's full profile (including biography) by numeric id or URL slug.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs
- idinteger“Numeric Ganjoor record id (poet, category, poem, person, ...).”
- urlstring“Ganjoor URL slug.”
- include_catsboolean“Include the poet's top-level list of books/sections.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poets_by_centuryreads or searches
“Get every Ganjoor poet grouped into historical half-centuries.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
1 input
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_list_booksreads or searches
“List Ganjoor books (named collections such as دیوان حافظ or غزلیات سعدی), alphabetically.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs
- namestring“Case-insensitive substring filter on the book name, e.g.”
- poet_idinteger“Only books belonging to this poet id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_categoryreads or searches
“Get a Ganjoor category (a book, section, or sub-collection) by numeric id.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 1 required
- cat_idintegerrequired“Category id.”
- include_poemsboolean“Include the poems contained directly in this category.”
- include_childrenboolean“Include the direct child categories.”
- poem_limitinteger“Maximum poems to include when include_poems is true.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_list_category_poemsreads or searches
“List the poems contained in a Ganjoor category, optionally filtered by the author's name.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 1 required
- cat_idintegerrequired“Category id to list poems from.”
- title_containsstring“Optional case-insensitive substring filter applied to poem titles.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_category_geotagsreads or searches
“Get the geographic and historical locations tagged to poems within a Ganjoor category and its descendants.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- cat_idintegerrequired“Category id whose subtree should be scanned for geo tags.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_category_people_graphreads or searches
“Get the network of historical people relevant to a Ganjoor category or work.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- cat_idintegerrequired“Category id to build the people graph for.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_search_poemsreads or searches
“Full-text search across all poems on Ganjoor, optionally scoped to one poet or category.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
7 inputs, 1 required
- termstringrequired“Persian text to search for, e.g.”
- poet_idinteger“Restrict to a poet id.”
- cat_idinteger“Restrict to a category id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- include_textboolean“Include the full poem text for each result.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_semantic_search_poemsreads or searches
“Meaning-based ("find a poem about...") search over Ganjoor's poetry collection.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 1 required
- querystringrequired“Natural-language description of the theme, e.g.”
- top_kinteger“Number of poems to return (1-50, default 10).”
- poet_idinteger“Restrict to a poet id.”
- cat_idinteger“Restrict to a category id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poemreads or searches
“Fetch a complete poem by its Ganjoor URL, including verses, metre, rhyme, and recitations.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
8 inputs, 1 required
- urlstringrequired“Ganjoor URL slug.”
- include_categoryboolean“Include the poem's category/book metadata.”
- include_siblingsboolean“Include all other poems in the same book.”
- include_recitationsboolean“Include audio recitations of the poem.”
- include_imagesboolean“Include manuscript image links.”
- include_commentsboolean“Include published reader comments.”
- include_verse_detailsboolean“Include per-verse ids, positions, and AI summaries.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_by_idreads or searches
“Fetch a complete poem by its numeric Ganjoor id.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
6 inputs, 1 required
- poem_idintegerrequired“Numeric poem id, e.g.”
- include_categoryboolean“Include category metadata.”
- include_recitationsboolean“Include audio recitations.”
- include_commentsboolean“Include reader comments.”
- include_verse_detailsboolean“Include per-verse ids, positions, and summaries.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”

Show 32 more tools

ganjoor_get_poem_versesreads or searches
“Get just the verses of a poem by id — a lightweight alternative to fetching the whole poem.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- couplet_indexinteger“Return only this 0-based couplet.”
- include_summaryboolean“Include the modern Persian summary attached to each couplet.”
- include_original_textboolean“Include the pre-correction original text where the API has it.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_random_poemreads or searches
“Get a random poem from Ganjoor, optionally from a specific poet.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs
- poet_idinteger“Poet id to draw from.”
- include_recitationsboolean“Include audio recitations.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_hafez_faalreads or searches
“Draw a random Hafez ghazal as a Persian divination (فال حافظ).”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
1 input
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_page_urlreads or searches
“Resolve any Ganjoor page id (poem, category, or poet) to its public web URL path.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- idintegerrequired“Page id to resolve.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_redirect_urlreads or searches
“Resolve a legacy or short Ganjoor URL to its current canonical address.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- urlstringrequired“URL path to resolve, e.g.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_list_rhythmsreads or searches
“List every Persian prosodic metre (وزن) used in the Ganjoor corpus, with its verse-pattern notation.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_analyze_poem_rhythmreads or searches
“Detect the prosodic metre (وزن) of a poem by its numeric id.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id to analyze.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_analyze_poem_rhymereads or searches
“Detect the rhyme letter (قافیه) and rhyme pattern of a poem by its numeric id.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id to analyze.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_find_similar_poemsreads or searches
“Find poems that share a poem's prosodic metre and rhyme letter — the basis of Ganjoor's "related poems" (شعرهای مرتبط) pages.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
9 inputs, 1 required
- metrestringrequired“Prosodic metre pattern exactly as returned by ganjoor_list_rhythms, e.g.”
- rhymestring“Optional rhyme letter, e.g.”
- poet_idinteger“Restrict to a poet id.”
- cat_idinteger“Restrict to a category id.”
- couplet_count_mininteger“Only poems with at least this many couplets.”
- couplet_count_maxinteger“Only poems with at most this many couplets.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_sectionsreads or searches
“Get the structural sections of a poem — the stanzas (بند), couplets (مثنوی), and tercets (رباعی) it is built from.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_sectionreads or searches
“Get one section of a poem by its section id, including its verses and its own related sections.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs, 1 required
- section_idintegerrequired“Section id from ganjoor_get_poem_sections.”
- include_versesboolean“Include the section's verses.”
- include_relatedboolean“Include sections from other poems related to this one.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_related_sectionsreads or searches
“Find sections from other poems that match a given poem section in metre and rhyme.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 2 required
- poem_idintegerrequired“Numeric poem id.”
- section_indexintegerrequired“0-based section index within the poem.”
- skipinteger“Results to skip for pagination.”
- items_countinteger“How many related sections to return.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_couplet_sectionsreads or searches
“Find which structural sections a specific couplet of a poem belongs to.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs, 2 required
- poem_idintegerrequired“Numeric poem id.”
- couplet_indexintegerrequired“0-based couplet number.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_language_tagged_sectionsreads or searches
“List poem sections Ganjoor has tagged with a specific language, newest-scoped by poet.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs, 1 required
- languagestringrequired“Language code to filter by, e.g.”
- poet_idinteger“Restrict to a poet id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_search_recitationsreads or searches
“Search the published audio recitations (روایت) of Ganjoor poems, optionally by reciter or poem.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
6 inputs
- search_termstring“Text to match against the reciter's name.”
- poet_idinteger“Restrict to a poet id.”
- cat_idinteger“Restrict to a category id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_recitationreads or searches
“Get one published recitation by its numeric id, including its audio file location and poem reference.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- recitation_idintegerrequired“Numeric recitation id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_recitation_sync_inforeads or searches
“Get the per-verse timing map for a recitation, showing when each couplet begins in the audio.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- recitation_idintegerrequired“Numeric recitation id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_recitationsreads or searches
“List every audio recitation published for one poem.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_category_top_recitationsreads or searches
“Get the most-liked recitations within a category — Ganjoor's "top 1" (بهترین) listings for a book.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs, 1 required
- cat_idintegerrequired“Category id.”
- include_poem_textboolean“Include the full poem text alongside each recitation.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_list_peoplereads or searches
“List the historical and literary figures Ganjoor has catalogued as related persons (شخصیت‌ها).”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs
- searchstring“Case-insensitive substring filter on the person's name.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_personreads or searches
“Get one person's full record — biography, dates, places, and external references.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- person_idintegerrequired“Numeric person id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_person_poemsreads or searches
“Get every poem Ganjoor has tagged with a given person.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs, 1 required
- person_idintegerrequired“Numeric person id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_person_relationsreads or searches
“Get a person's kinship and affiliation edges — parents, siblings, spouses, teachers, and contemporaries.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
3 inputs, 1 required
- person_idintegerrequired“Numeric person id.”
- relation_typestring“Optional filter on the relation kind, e.g.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_person_family_treereads or searches
“Get the full connected kinship component reachable from a person — ancestors, descendants, spouses, and siblings.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- person_idintegerrequired“Numeric person id to start the traversal from.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_recent_commentsreads or searches
“Get the most recent published reader comments across Ganjoor, optionally filtered.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
5 inputs
- termstring“Optional substring filter applied to comment text.”
- filter_user_idstring“Optional user UUID — only that user's comments.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_list_faq_categoriesreads or searches
“List the Ganjoor site's published FAQ (پرسش‌های متداول) categories.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
1 input
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_faq_itemsreads or searches
“Get every published question-and-answer in a Ganjoor FAQ category.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
4 inputs, 1 required
- cat_idintegerrequired“FAQ category id.”
- pageinteger“Page number, starting from 1.”
- page_sizeinteger“Maximum items to return per page (1-100, default 20).”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_faq_itemreads or searches
“Get one Ganjoor FAQ entry by its numeric id.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- faq_idintegerrequired“Numeric FAQ item id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_images
“Get the manuscript and facsimile images Ganjoor holds for a poem.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_quoted_poems
“Get the poems that a given poem quotes or alludes to, and the poems that quote it.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
7 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- only_both_poemsboolean“Only include quotations both poems acknowledge.”
- published_onlyboolean“Only include published records.”
- main_list_onlyboolean“Only include records curated onto the main related-poems list.”
- skipinteger“Results to skip.”
- items_countinteger“How many results to return.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_effective_corrections
“Get the editorial corrections applied to a poem's text — the before/after record of every fix.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”
ganjoor_get_poem_geotags
“Get the geographic and historical locations tagged to a single poem.”
Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes
2 inputs, 1 required
- poem_idintegerrequired“Numeric poem id.”
- response_formatstring“Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

How well are its tools described?

Features #4 and #5

How clearly this server's own tool descriptions say what a tool does, and how consistent its tool list is. The first part is an AI model's yes/no reading of each description; the second part is counted. We do not turn it into a grade.

Descriptions

AI reading of each description

Says what the tool does: 100% of 40 tools
Says what it returns: 100% of 40 tools
States limits, defaults or errors: 40% of 40 tools
Says when to use it: 100% of 13 tools
Items covered per tool: 3.4 of 4 on average

Counted from the listing

Parameters with a description: 100% of 158
Tools with a description: 100% of 44
Typical description length: 833 characters

The tool set

Counted from the listing

Tools: 44
Size of the list: about 19,435 tokens for an agent to load (characters ÷ 4)
Naming: 44 of 44 names use snake_case

AI reading: easy to mix up

No pair found.

The AI items cover 40 of 44 tools: for a tool where two differently worded runs disagreed, that item is left out. They were not checked by hand, and no tool was called. “Easy to mix up” means two tools whose names or descriptions overlap without saying how they differ; the AI found none, comparing tools within groups of 40. We do not rate whether the tool set is complete or whether side effects are spelled out, because our AI reading of those was not reliable enough.

How do I add it to my client?

Config from the registry entry

From the npm package ganjoor-mcp-server

Our sandbox started this package on 2026-10-23 (a read-only session: no tool was called).

Add to CursorAn install link in the format Cursor documents, holding the Cursor config below. The command runs the publisher’s code on your machine.

Claude Desktop · claude_desktop_config.json (Settings → Developer → Edit Config)

{
  "mcpServers": {
    "ganjoor-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ganjoor-mcp-server@0.1.0"
      ]
    }
  }
}

Cursor · .cursor/mcp.json in a project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ganjoor-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ganjoor-mcp-server@0.1.0"
      ]
    }
  }
}

VS Code · .vscode/mcp.json

{
  "servers": {
    "ganjoor-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ganjoor-mcp-server@0.1.0"
      ]
    }
  }
}

VS Code (command line) · Bash or zsh terminal (macOS, Linux)

code --add-mcp '{"name":"ganjoor-mcp-server","type":"stdio","command":"npx","args":["-y","ganjoor-mcp-server@0.1.0"]}'

Claude Code

claude mcp add --transport stdio ganjoor-mcp-server -- npx -y ganjoor-mcp-server@0.1.0

Try it in the MCP Inspector · runs on your machine, opens in your browser · Node 22.19+

npx @modelcontextprotocol/inspector@2.11.0 -- npx -y ganjoor-mcp-server@0.1.0

This runs the publisher's code on your machine (npx). Read its README first.
The MCP Inspector lists the server's tools, resources and prompts; a tool you call there runs for real.

Built from the server's registry entry with each client's documented format (checked 2026-10-14; the Cursor link and the VS Code command 2026-10-19; the MCP Inspector command 2026-10-21). Values in < > are yours to fill in; this page never contains a key. Where the server needs a setting the entry does not declare, it can still fail to start.

Can it be installed, and is it up to date?

Version pin · advisories

Listed version

Registry lists: 0.1.0
Latest stable: 0.1.0
Status: current
Withdrawn: no

Source: registry.npmjs.org · 2026-10-23. About the version the registry lists; a manual install may resolve to a different one.

Dependency advisories

Counted in the full dependency tree as resolved on 2026-10-23 (npm audit). Bars share one scale. The package itself has no known vulnerability (OSV.dev).

Integrity, provenance, license

Integrity: sha512-M0mozIHhNcwqGlsXu…
Signature: signed
License: MIT

Source: the package registry · 2026-10-23.

Usage

Downloads: 37 in the last month

Source: api.npmjs.org · 2026-10-23.

Does the registry listing match what we found?

Feature #6

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.

Registry says	We found	Result	Source · date
Published package can be started	Started and answered	matches	our test · 2026-10-23
Version 0.1.0 on npm	Exists and can be installed	matches	npm · 2026-10-23
Repository github.com/ganjoor/ganjoor-mcp-server	Opens publicly	matches	api.github.com · 2026-10-23

Who made it?

Feature #7 · lineage

Facts about the publisher. We do not turn them into a trust score.

Namespace: io.github.ehsanghaffar
GitHub owner: an organization (ganjoor)
Build record: signed

Repository: github.com/ganjoor/ganjoor-mcp-server
Stars: 7
Repository age: 0–30 days
Last push: 0–30 days ago
Archived: no
Security policy: SECURITY.md

Source: the registry entry and api.github.com · 2026-10-23; security policy read from GitHub · 2026-10-23.

Publish this server? Run these checks against it yourself before release, from your own machine: a server the command starts, or your own server at its URL after a one-time proof that you control it: npx protocolprobe-selftest.

Choosing

Record checks

Public records · not a safety rating

8 of 9 record checks met

#14,666 of 15,112 packages by monthly downloads, tied with 5 others
Not ranked by stars: 7 stars (ranked from 10)

MetRegistry entry is active and says how to run itActive, with a package or a remote address.
MetSource repository link opensThe linked GitHub repository is public. It belongs to the GitHub account "ganjoor", not "ehsanghaffar" from this server's name; the registry does not check that a publisher owns the repository it links, so the repository checks below describe that repository.
MetRepository is not archivedNot archived.
MetCode pushed to the repository in the 90 days before our checkLast push 0-30 days before our check.
MetRepository publishes a security policy (SECURITY.md)SECURITY.md found.
MetPackage names its licence with a standard (SPDX) identifierMIT
MetThe version the registry lists can be installed and is not withdrawnThe listed version exists and is current.
Not metnpm package carries build provenance (attestation)Signed by npm, but no build attestation.
MetNo known critical or high advisory in the package or its dependenciesNone known in the package or its dependency tree.

Read from public records only: the registry entry, npm/PyPI, GitHub and advisory databases, checked 2026-10-23. No tool was called. Only “met” and “not met” are counted, so the total differs between servers; a check that does not apply or that we could not run is listed, never counted against it. It is not a safety rating. How each check works · Leaderboards

Common questions about io.github.ehsanghaffar/ganjoor-mcp-server

Answered from the data above

Is io.github.ehsanghaffar/ganjoor-mcp-server safe to install?

We do not rate servers as safe or unsafe. 8 of its 9 applicable record checks are met (facts from public records, each listed on this page). What the records show: Its source repository opens publicly. Its repository had a push in the last 90 days. The listed version is the latest stable release. The package itself has no known vulnerability (OSV.dev). Its full dependency tree has no known advisory. These are facts with their sources on this page, not a safety guarantee, and we did not run its tools.

Has io.github.ehsanghaffar/ganjoor-mcp-server been security tested?

Partly. 2 of the 12 checks that apply to it were exercised. We started the package in an isolated sandbox and read what it declares, but this test round was read-only, so its tools were not called. No security verdict is published before verification.

What can io.github.ehsanghaffar/ganjoor-mcp-server do?

It lists 44 tools. In our AI model's reading of their descriptions (two runs had to agree, nobody checked it by hand), they include tools that read or search. We did not call any tool, so this describes the text, not the behaviour.

Can io.github.ehsanghaffar/ganjoor-mcp-server change or delete data?

None of its 44 tools is described as changing anything (our AI model's reading of the descriptions; nobody checked it by hand). We did not call any tool.

Does io.github.ehsanghaffar/ganjoor-mcp-server publish a security policy?

Yes: its repository has a public security policy (github.com/ganjoor/ganjoor-mcp-server/blob/HEAD/SECURITY.md). That is the publisher's statement, not permission for us to test the server, and we call none of its tools.

Is the listed version current?

Yes. The registry lists 0.1.0, the latest stable release on npm.

Where is the source code of io.github.ehsanghaffar/ganjoor-mcp-server?

In github.com/ganjoor/ganjoor-mcp-server, which opens publicly.

Found this page useful?

Anonymous · no sign-in

A quick, anonymous reaction — no account, no email. One per kind from your browser. The tally updates when the page is next refreshed, and it is only a rough count, never a safety rating or a measured number of people.

Compare with another server

Side by side: registry entry, our read-only session, the tools and the 18 classification fields. Same values as each page; no score.

Security testing

What did we test, and what did we leave out?

18 checks · features #1, #2

Not probed (read-only run)

We started the package in an isolated sandbox and read what it declares, but this test round was read-only, so its tools were not called. No security score is given; a check we did not run is never counted as passed.

The 18 checks at a glanceour test · 2026-10-23

Inventory: exercised
Hidden instructions: exercised
Real execution: not run · our policy
Secret leak: not run · nothing to check it against
Internal addresses: not run · our policy
Unconfirmed changes: not run · our policy
Bad input: not run · our policy
Model requests: not run · nothing to check it against
Sensitive questions: not run · nothing to check it against
Folder boundary: not run · our policy
Log leaks: not run · nothing to check it against
Hidden content: not run · nothing to check it against
Fake assistant turns: not applicable
Token passthrough: not applicable
Token audience: not applicable
Sign-in redirect: not applicable
Consent handling: not applicable
Sign-in metadata: not applicable

2 exercised10 not run (reason given)6 not applicable

Each check ends in exactly one state: exercised, not run (with the reason), or not applicable (with the reason). 2 of the 12 checks that apply to it were exercised. We do not publish security-check outcomes for named servers.

Exercised · 2

1Inventory
tool-listReads the declared tools, resources and prompts.exercised
2Hidden instructions
description-poisoningLooks for hidden instructions in tool descriptions.exercised

Not run, with the reason · 10

3Real execution
real-executionCalls a tool and checks what really happens.This check calls the package's tools. This test round was read-only, so no tool was called; tools can act on outside services with the publisher's or a user's account.not run · our policy
4Secret leak
canary-leakPlants a fake secret and checks whether it leaks.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
5Internal addresses
ssrfChecks whether a tool can be steered to internal addresses.This check calls the package's tools. This test round was read-only, so no tool was called; tools can act on outside services with the publisher's or a user's account.not run · our policy
6Unconfirmed changes
write-without-confirmationChecks whether tools that change data act without asking.This check calls the package's tools. This test round was read-only, so no tool was called; tools can act on outside services with the publisher's or a user's account.not run · our policy
7Bad input
error-handlingSends bad input and watches how the server answers.This check calls the package's tools. This test round was read-only, so no tool was called; tools can act on outside services with the publisher's or a user's account.not run · our policy
8Model requests
samplingChecks whether the server asks the client's model to act for it.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
9Sensitive questions
elicitation-sensitive-dataChecks whether the server asks users for sensitive data.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
10Folder boundary
root-boundaryChecks whether the server reaches outside the folders it was given.This check calls the package's tools. This test round was read-only, so no tool was called; tools can act on outside services with the publisher's or a user's account.not run · our policy
11Log leaks
logging-side-channelChecks whether log messages carry data they should not.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
12Hidden content
audience-hidingChecks resources that hide content from the user.This check needs content the server returns, and nothing was read or called.not run · nothing to check it against

Does not apply to this server · 6

13Fake assistant turns
fake-assistant-turnChecks prompts that pose as the assistant's own words.The server exposes no prompts.not applicable
14Token passthrough
token-passthroughChecks whether the server forwards a user's token to other services.The server runs locally over standard input/output, so there is no sign-in flow to check.not applicable
15Token audience
token-audience-validationChecks whether tokens meant for another service are accepted.The server runs locally over standard input/output, so there is no sign-in flow to check.not applicable
16Sign-in redirect
open-redirectChecks the sign-in redirect for abuse.The server runs locally over standard input/output, so there is no sign-in flow to check.not applicable
17Consent handling
confused-deputyChecks consent handling when one service acts for another.The server runs locally over standard input/output, so there is no sign-in flow to check.not applicable
18Sign-in metadata
oauth-url-schemeChecks the published sign-in metadata for unsafe URLs.The server runs locally over standard input/output, so there is no sign-in flow to check.not applicable

Source: our own test in an isolated sandbox, 2026-10-23, mcp-runtime-engine@0.1.0. Which checks count and why follows our published scoring model.

What happened during the test?

Feature #8

The steps in order, as the test record holds them.

0 msStarted the published package in an isolated sandbox (read-only mode)
110,430 msConnected after 0 redirects.
Read the inventory: 44 tools, 0 resources, 0 prompts.
111,453 msFinished: 2 checks exercised.

Reference

How is it classified?

18 fields

One value per field, each with its source. Fields written by AI models are marked. A field with no value says why.

TopicAI-classified

no value

No value: the two AI models (Gemini and Claude) disagreed, so neither answer is shown.

Pricing modelAI-classified

not checked

no website in the registry entry

Programming language

TypeScript

api.github.com · 2026-10-23

Hosting type

local package

registry · 2026-10-23

MCP capability

tools

our test · 2026-10-23

Transport

standard input/output

registry · 2026-10-23

Required credentials

none declared

registry · no declaration is not a guarantee

Package registry

npm

registry · 2026-10-23

Freshness

0–30 days

registry updatedAt · 2026-10-23

Lifecycle status

active

registry · 2026-10-23

License class

permissive

package registry · 2026-10-23

Integrity hash

declared (sri)

package registry · 2026-10-23

Signature / provenance

signed

package registry · 2026-10-23

Dependency advisories

none known

npm audit · 2026-10-23

Popularity

37 downloads a month

package registry · 2026-10-23

Publisher signals

owner: an organization · repository age: 0–30 days · stars: 0–9 · build record: signed

api.github.com · 2026-10-23

Maintenance

active

api.github.com · 2026-10-23

Environment

your machine

where it runs, from the hosting type

“Not stated” means the source did not state it; “does not apply” means it does not apply to this kind of server; “our limit” means our own lookup failed. A linked value opens the directory filtered to the same value.

Cite or correct this page

Sources and corrections

Suggested citation

ProtocolProbe. “io.github.ehsanghaffar/ganjoor-mcp-server: MCP server record.” Data checked 2026-10-23. https://protocolprobe.com/mcp/servers/io.github.ehsanghaffar/ganjoor-mcp-server

Figures are valid for the date shown. Our facts on this page are CC BY 4.0: reuse them with a link and the check date. Quoted text (the publisher’s descriptions, website quotes, tool names) is not ours to license.

As JSON: this record in the API · API documentation.

Badge for your README

[![ProtocolProbe](https://protocolprobe.com/api/v1/badge/io.github.ehsanghaffar/ganjoor-mcp-server)](https://protocolprobe.com/mcp/servers/io.github.ehsanghaffar/ganjoor-mcp-server)

It shows this server's record-check count: facts from public records, no tool called. It is not a security rating or a pass. It links here and updates after each data reload.

Something wrong, or is this yours?

If a fact here is wrong, tell us and we will re-check it. If you operate this server, you can run our checks on it yourself with the free self-test command; we call no server’s tools ourselves for anything shown here.

Write to hello@protocolprobe.com · corrections log · methodology