yoktez-mcp
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.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
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.
⚡ Reliability
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.
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
Interface
Authentication
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
No pricing/tiers information is provided in the README or manifest snippet.
Agent Metadata
Known 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.
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for yoktez-mcp.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.