YokTez MCP: YÖK Ulusal Tez Merkezi için MCP Sunucusu

@saidsurucu

About YokTez MCP: YÖK Ulusal Tez Merkezi için MCP Sunucusu

MCP Server for Turkish Thesis Database

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is YokTez MCP?

YokTez MCP is a FastMCP server that provides programmatic access to the YÖK (Turkish Higher Education Council) National Thesis Center. It enables LLM applications such as Claude Desktop and 5ire to search for theses and retrieve their PDF content as Markdown text.

How to use YokTez MCP?

For remote use, add the MCP URL https://yoktezmcp.fastmcp.app/mcp as a custom connector in Claude Desktop or configure it in other MCP clients like Google Antigravity. For local installation, use the uvx command: uvx --from git+https://github.com/saidsurucu/yoktez-mcp yoktez-mcp. In 5ire, create a tool with key yoktezmcp and the same uvx command.

Key features of YokTez MCP

Search theses by title, author, advisor, university, year range, and many other criteria.
Retrieve thesis PDF content page by page in Markdown format.
Extract metadata such as title, author, year, and abstract from thesis detail pages.
Provides clear notifications for theses without permission or access.
Works with any MCP-compatible client (Claude Desktop, 5ire, etc.).
No installation required when using the remote MCP endpoint.

Use cases of YokTez MCP

Researchers querying the YÖK thesis database for specific topics or authors.
LLM-powered assistants that need to read and summarize thesis PDFs.
Automated extraction of metadata from thesis detail pages.
Integrating Turkish thesis search capabilities into custom AI workflows.
Using natural language to search and retrieve academic theses without manual browsing.

FAQ from YokTez MCP

What are the prerequisites for local installation?

Python 3.11, uv (installed via PowerShell or curl), and on Windows the Microsoft Visual C++ Redistributable are required.

What is the remote MCP address?

The remote MCP address is https://yoktezmcp.fastmcp.app/mcp – no local setup needed.

What parameters does the search tool accept?

search_yok_tez_detailed accepts fields such as thesis_title, author_name, advisor_name, university_name, year_start, year_end, thesis_type, permission_status, and more.

What does the document retrieval tool return?

get_yok_tez_document_markdown returns the Markdown content of a specific PDF page, total page count, and metadata from the thesis detail page.

Is YokTez MCP open source?

Yes, it is licensed under the MIT License – see the LICENSE file for details.

Frequently asked questions

What are the prerequisites for local installation?

Python 3.11, `uv` (installed via PowerShell or curl), and on Windows the Microsoft Visual C++ Redistributable are required.

What is the remote MCP address?

The remote MCP address is `https://yoktezmcp.fastmcp.app/mcp` – no local setup needed.

What parameters does the search tool accept?

`search_yok_tez_detailed` accepts fields such as `thesis_title`, `author_name`, `advisor_name`, `university_name`, `year_start`, `year_end`, `thesis_type`, `permission_status`, and more.