YokTez MCP

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