YokTez MCP
An MCP server that searches theses in Turkey's YOK National Thesis Center and returns PDF text page by page as Markdown.
- 135 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Search queries go to the author's server and to `tez.yok.gov.tr`.
- The skill executes JavaScript in a browser tab.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/yoktez-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Search queries go to the author's server and to `tez.yok.gov.tr`.
- The skill executes JavaScript in a browser tab.
This is third-party code. Review the repository files before installing.
What it does
YokTez MCP connects an agent to the Ulusal Tez Merkezi database of Turkish master's and doctoral theses. The `search_yok_tez_detailed` tool searches by title, author, advisor, university, institute, department, year, type, language and permission status. The `get_yok_tez_document_markdown` tool takes a page of a chosen thesis PDF and returns it as Markdown with metadata. For those who prefer no server, `skills/yoktez` holds the same functions as a skill that runs requests from an open `tez.yok.gov.tr` tab in Claude in Chrome or the Claude Desktop browser.
Who it is for. Researchers and students who study Turkish theses and ask an agent to find them and read chapters.
Good fit when
- A literature review needs theses from Turkish universities by topic and year.
- An agent summarizes a thesis chapter after reading the needed PDF pages.
- A thesis is searched by number or advisor.
- Claude Desktop needs a connector without installing Python or `uv`.
Not a fit when
- You need theses from outside Turkey.
- Queries cannot go to a third-party remote server and a local run does not suit you.
- The author restricted the thesis and its PDF is not served.
Example request
Find theses on machine learning from 2022 to 2025, show the advisors and read the introduction of the most recent one.MCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
Documentation is in Turkish and the YÖK interface is Turkish too. A local run needs Python 3.11 and `uv`, plus Microsoft Visual C++ Redistributable on Windows. The ready remote address is the author's own server, so queries pass through it; for sensitive topics run your own instance. When an author restricted access to the text, the server reports it and returns no PDF. The skill works through JavaScript in a browser tab and does not suit agents without browser access.
How to disable. Remove the connector or the `YokTez MCP` entry from `claude_desktop_config.json` and restart the app. Remove the skill by deleting `~/.claude/skills/yoktez`.
FAQ
How do I connect YokTez MCP without installing anything?
In Claude Desktop open Settings, Connectors, Add Custom Connector and enter `https://yoktezmcp.fastmcp.app/mcp`. Python and `uv` are not needed.
How do I run the server locally?
Add the `uvx` command with the arguments `--from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp` to the client configuration. Python 3.11 and `uv` are required.
Is there a Claude Code version?
Yes, the skill in `skills/yoktez`. Copy it to `~/.claude/skills/` with the command from the README. It works in an open `tez.yok.gov.tr` tab through Claude in Chrome.
What does a restricted thesis return?
Metadata and a message that the author restricted access. The PDF text is unavailable in this case.
Which search criteria are available?
Title, author, advisor, university, institute, department, number, subject, type, language, permission status and year range. Results are paged.
Discussion
No questions or reviews yet.
Related
MCP serversA web search MCP server that gives the agent full page text at once: Stack Overflow answers, GitHub threads, arXiv papers
A research MCP server: searches the web, SEC, courts and patents, reads whole pages and checks that cited sources really exist.
A local MCP server with no API keys: multi-engine web search, page fetching and document reading tuned for LLMs.
Paper search across five databases with deduplication, citation checks and RIS or BibTeX export for Claude Code and Codex
Remote Consensus MCP server: Claude Code, Codex and Cursor search 220M peer-reviewed papers and answer with links to the studies
Yandex search MCP server in TypeScript
yandex-search-mcp
A TypeScript MCP server for the Yandex Search API with its own result parser and tests
README in short
The Turkish README describes three ways to connect: the remote address, a local `uvx` run for 5ire and Claude Desktop, and a serverless skill. Search results are paged, and document text is served by PDF page number.