Overview

YokTez MCP is a FastMCP server that provides programmatic access to the Turkish Council of Higher Education (YÖK) National Thesis Center. It integrates with LLM applications like Claude Desktop and 5ire through the Model Context Protocol.

The YÖK National Thesis Center is Turkey's central repository for all master's and doctoral theses submitted to Turkish universities, similar to ProQuest Dissertations in the US.

Features

Advanced Thesis Search: Multi-criteria search by title, author, advisor, university, year range, access status
PDF-to-Markdown Conversion: Thesis document conversion for LLM processing
Metadata Extraction: Information extraction from thesis detail pages
PDF Access Control: Appropriate notifications for restricted content
Claude Desktop and Other MCP Clients: Wide compatibility

Installation

Quick Setup (Remote MCP - No Installation Required)

Claude Desktop Settings → Connectors → Add Custom Connector:

Name: YokTez MCP
URL: https://yoktezmcp.fastmcp.app/mcp

For 5ire and Other Clients

Requirements: Python 3.11, uv, Git, Microsoft Visual C++ Redistributable

uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp

Claude Desktop Configuration

{
  "mcpServers": {
    "YokTez MCP": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/saidsurucu/yoktez-mcp", "yoktez-mcp"]
    }
  }
}

Tools

search_yok_tez_detailed: Thesis search with title, author, university, year and 17+ parameters
get_yok_tez_document_markdown: Retrieve thesis PDF content as formatted Markdown

Usage Examples

"Search for PhD theses on artificial intelligence"
"List theses written at ITU (Istanbul Technical University) in 2023"
"Find theses supervised by Prof. Dr. Ahmet Yılmaz"
"Get openly accessible theses in machine learning"

Search Criteria

Title and keywords
Author name
Advisor name
University
Institute
Department
Year range
Thesis type (Master's / PhD)
Access status (Open / Restricted)

License

MIT License

YokTez MCP