iran-dictionary-mcp: Persian dictionary (لغتنامه) MCP server for AI agents, Abadis + Vajehyab
iran-dictionary-mcp is an unofficial, read-only MCP server that lets an AI agent look up Persian words, synonyms, antonyms and translations on two dictionary sites at once: Abadis (آبادیس, abadis.ir) and Vajehyab (واژهیاب, vajehyab.com).
Its 7 tools return Dehkhoda, Moein and Amid meanings, synonyms and antonyms, pure-Persian equivalents, English, Arabic and Turkish translation with example sentences, spelling autocomplete and Persian first names.
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 abadis.ir and vajehyab.com, merged: word meanings, synonyms and antonyms, translation, autocomplete, plus each site's own tools (Abadis first names, Vajehyab scoped search and full entries).
- Install:
uvx iran-dictionary-mcporclaude mcp add iran-dictionary -- uvx iran-dictionary-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
IRAN_DICTIONARY_MCP_PROXY(one HTTP proxy URL) applies to both sites; system proxy settings are ignored. - Access: read-only. It cannot log in or save words.
- Tools: 7, all prefixed
dic_. Four merged tools takesource(alldefault,abadis,vajehyab) and answer with one block per site; if one site fails its block holds anerrorand the other still answers. The other three are one site's own tools. - Use when: the user asks what a Persian word means, wants synonyms, antonyms or a pure-Persian equivalent, a Persian-English, Arabic or Turkish translation, the right spelling, rhymes, or a Persian first name by meaning.
- Output: compact JSON, mostly Persian text. Meaning text is cut short by default;
fullreturns more.
Quick start
You need uv. No API key or account.
Claude Code:
claude mcp add iran-dictionary -- uvx iran-dictionary-mcp
Claude Desktop, Cursor, VS Code and other clients:
{
"mcpServers": {
"iran-dictionary": { "command": "uvx", "args": ["iran-dictionary-mcp"] }
}
}
Example prompts:
- "What does the Persian word سلام mean, according to Dehkhoda?"
- "Give me synonyms and antonyms of دوست."
- "Translate hello into Persian with example sentences."
- نام دخترانهٔ ایرانی با معنی گل پیشنهاد بده.
- معنی واژهٔ «دمساز» در لغتنامه دهخدا چیست؟
Real result (17 Nov 2026), dic_synonyms(word="دوست"): Abadis returns 19 synonyms (آشنا، حبیب، خلیل، دمساز، دوستدار، رفیق ...); Vajehyab returns the same 19, antonyms دشمن، عدو، خصم، متخاصم, and 6 entries that list دوست as their synonym (برادر، جانان، حریف، حمیم، حواری، مقترن).
Tools
Merged (both sites, source argument):
| Tool | What it does |
|---|---|
dic_lookup |
Look a word up in the Persian dictionaries of Abadis and Vajehyab, one block per site. |
dic_synonyms |
Find synonyms, antonyms and pure-Persian equivalents (برابر پارسی) of a Persian word, one block per site. |
dic_translate |
Translate a single word or short phrase between Persian and English, Arabic or Turkish, one block per site. |
dic_suggest |
Complete the start of a word into dictionary headwords, one list per site; use it to find the exact spelling. |
Single site:
| Tool | What it does |
|---|---|
dic_abadis_names |
Search Abadis's Persian first-name list by name, gender, origin, theme or first letter. |
dic_vajehyab_search |
Search Vajehyab's dictionaries with a scope: exact entries, entries naming it a synonym or antonym, rhymes, sound-alikes. |
dic_vajehyab_entry |
Read one whole Vajehyab entry (for example the full Dehkhoda text with its poetry), cut at max_chars. |
Limits
- Single words and short phrases, not sentences.
ar-fawith Arabic-letter spellings (such as كتاب with an Arabic kaf) was not checked and may find nothing. - Abadis has no Arabic or Turkish to Persian. Vajehyab's English translation is shorter than its site page, which adds a subscription source.
- There is no public proverb or poetry search; Dehkhoda entries quote poetry.
- Vajehyab engine excerpts are about 200 characters; use
dic_lookup(full=True)ordic_vajehyab_entryfor the whole entry. - Dictionary text is third-party content. Both sites answer from outside Iran.
How it works
Neither site has a public API. Abadis pages are fetched and parsed as HTML; Vajehyab is read through its own search engine JSON and the data embedded in its entry pages. The tools were mapped in Chrome and checked against the real pages on 2026-11-16 (meanings, 19 synonyms, antonyms, English translation with examples, first names). One mismatch found there (synonym lists that mention the word) is fixed in dic_synonyms.
فارسی
iran-dictionary-mcp یک سرور MCP غیررسمی و فقطخواندنی است که معنی واژهها، مترادف و متضاد، برابر پارسی، ترجمه به انگلیسی، عربی و ترکی و نامهای ایرانی را همزمان از دو سایت آبادیس و واژهیاب (شامل لغتنامه دهخدا، معین و عمید) برای عامل هوش مصنوعی میآورد. نصب در Claude Code:
claude mcp add iran-dictionary -- uvx iran-dictionary-mcp
Development
uv sync
uv run ruff check . && uv run ruff format --check .
uv run pytest -q # offline tests on recorded fixtures
uv run pytest -m live -q # live calls to Abadis and Vajehyab
Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI.
Disclaimer
Unofficial and not affiliated with or endorsed by Abadis or Vajehyab. It is read-only and uses the public pages and endpoints of those sites, which can change without notice.
Author
Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.
License
Metadata
Release files for iran-dictionary-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iran_dictionary_mcp-0.1.0.tar.gz | 485.6 kB | With provenance | Details for iran_dictionary_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iran_dictionary_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iran_dictionary_mcp-0.1.0-py3-none-any.whl |
Total release size: 509.9 kB
Release files / iran_dictionary_mcp-0.1.0.tar.gz
| Download URL | iran_dictionary_mcp-0.1.0.tar.gz |
|---|---|
| Size | 485.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d4f34fa444b8c7c203281e0a6d84111b20f9f3e5e710c16369c6391cab71b8e
|
|
BLAKE2b-256 checksum How to use checksums |
4a5c3095ef6707b8030724a55f1a6e711335bec489545a8aeab739584b7d8ee9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logRelease files / iran_dictionary_mcp-0.1.0-py3-none-any.whl
| Download URL | iran_dictionary_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 24.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e680aa9bd1e5196bd0f72f3fddf0c7a69ea056aca7d7700f3974755c9d0eeec
|
|
BLAKE2b-256 checksum How to use checksums |
b1e457dee79d0f3c280333f9149468a363792b03f76df94124bd7d85ad354c8c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logSecurity for iran-dictionary-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for iran_dictionary_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.