{"id":"saidsurucu-yoktez-mcp","name":"yoktez-mcp","homepage":null,"repo_url":"https://github.com/saidsurucu/yoktez-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","fastmcp","llm-tools","retrieval","pdf-to-markdown","research","education","python"],"what_it_does":"Provides an MCP (FastMCP) server that lets MCP-capable LLM clients search the Turkish YÖK National Thesis (Ulusal Tez Merkezi) database and fetch thesis PDF content converted to Markdown by PDF page. Also extracts/returns thesis metadata from detail pages.","use_cases":["LLM-assisted thesis discovery by metadata filters (title/author/advisor/university/discipline/year/etc.)","Retrieval of thesis document content as page-level Markdown for summarization/QA","Building agent workflows for research assistance on Turkish theses","Creating searchable knowledge bases from thesis PDFs (with page-by-page extraction)"],"not_for":["Use as a primary, authoritative legal or academic citation source without verification of retrieved content","High-volume bulk crawling without considering rate limits and remote service policies","Applications requiring strict compliance guarantees or guaranteed availability/SLA (not documented)","Use cases needing complex authentication/tenanting or user-specific permissions"],"best_when":"You want an agent/tool interface (MCP) to programmatically query and read Turkish thesis documents in Markdown form for downstream LLM reasoning.","avoid_when":"You need fine-grained access control, contractual reliability guarantees, or documented retry/idempotency semantics; or you require robust error semantics and rate-limit guidance beyond what is provided.","alternatives":["Direct integration via the official YÖK/Ulusal Tez Merkezi web interfaces/APIs (if available)","Building a custom RAG pipeline that scrapes/ingests thesis pages/PDFs into a document store","Using a generic web search + PDF extraction toolchain without MCP (e.g., HTTP fetch + PDF to text/Markdown), then connecting it to your agent framework"],"af_score":54.8,"security_score":45.2,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:21:46.937427+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"https://yoktezmcp.fastmcp.app/mcp","has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No authentication mechanism (API key/OAuth) is described for the remote MCP endpoint; local execution is also shown without any auth layer in the README."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing/tiers information is provided in the README or manifest snippet."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":54.8,"security_score":45.2,"reliability_score":28.8,"mcp_server_quality":60.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":10.0,"tls_enforcement":100.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"Uses HTTPS for the documented remote MCP URL. No auth/authorization model is described, so access appears open (at least for the remote endpoint). Secret handling and logging behavior are not described. Dependency list includes common parsing/HTML/PDF libraries; specific vulnerability posture/lockfile/CVE status is not provided, so hygiene is estimated.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":50.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"parameters-based (page/results_per_page)","retry_guidance_documented":false,"known_agent_gotchas":["Markdown conversion and PDF page extraction can be slow or incomplete depending on source PDFs/HTML structure.","Tool parameters include many free-form filters; agents may pass empty/irrelevant values—ensure the server tolerates missing/optional fields.","Remote MCP availability/performance is not documented; timeouts should be handled by the client/agent framework.","No explicit guidance is given for rate limits, error codes, or retry/idempotency behavior."]}}