Server facts
Yargı MCP
Project
- Author
- saidsurucu
- Repository
- github.com/saidsurucu/yargi-mcp
- License
- MIT
- Category
- Search & Web Data
Tech
- Runtime / language
- pythonPython
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 1,007
- Last commit
- Data as of
Tags
- Court Decisions
- Document Retrieval
- Legal Research
- Python
- Turkish Law
Overview
Yargı MCP makes Turkish legal sources available to assistants through a FastMCP server. It supports searching decisions and retrieving document text from courts and public bodies, including Yargıtay, Danıştay, the Constitutional Court, and procurement and competition authorities. Additional coverage includes data protection, banking and communications regulators, tax rulings, and insurance arbitration publications. The focus is source discovery and document access within an MCP client rather than a separate legal research interface.
Search capabilities vary by source. The README describes chamber or board selection, date ranges, keyword criteria, and exact-phrase matching for the Bedesten-backed tools. Some courts have more than one API path. Retrieved decisions are converted to Markdown, and several long-document operations return paginated text. This gives an assistant a way to inspect lengthy legal material in smaller portions. The supplied README describes these capabilities but does not enumerate their exact MCP tool identifiers.
Users can run the package locally through uvx or connect to a hosted streamable HTTP endpoint without local installation. The README prominently announces a move to a new remote address; the previous endpoint now returns only a relocation warning tool. It also explains that opening the MCP endpoint in a browser can produce an acceptance-header error without indicating a service outage. Local execution accesses the legal sources directly from the user's machine and does not depend on that remote server.
Install & configure
Requirements
- Python 3.11 or newer for local execution
- uv for the local uvx launch
- An MCP-compatible client
- Microsoft Visual C++ Redistributable for the documented Windows setup
uvx yargi-mcpThe command is the local stdio option; remote_url is the separate hosted streamable HTTP alternative. The former fastmcp.app endpoint is no longer usable for research. The README's Claude Desktop custom-connector instructions require a paid subscription.
Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Use Settings → Developer → Edit Config when available. Do not assume a Linux configuration path; check the client documentation for your platform. Remote servers use the app’s connector flow when supported, not the local stdio file shown here. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"yargi-mcp": {
"command": "uvx",
"args": [
"yargi-mcp"
],
"env": {}
}
}
}Config file · Project: .cursor/mcp.json
User: ~/.cursor/mcp.json
The project path is relative to the workspace root. The tilde denotes your user home directory. Use Cursor’s MCP settings to confirm which configuration and scope your installed version is reading. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"yargi-mcp": {
"command": "uvx",
"args": [
"yargi-mcp"
],
"env": {}
}
}
}Config file · Workspace: .vscode/mcp.json
For user scope, use the “MCP: Open User Configuration” command if available. Do not guess a user configuration path across operating systems, profiles, containers, or remote workspaces; check the client documentation. Merge this example with existing settings; do not overwrite unrelated servers.
{
"servers": {
"yargi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"yargi-mcp"
],
"env": {}
}
}
}Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Open the MCP configuration through Windsurf’s settings when possible to confirm the active file. Paths can differ in managed or future releases; check the client documentation if this location is not present. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"yargi-mcp": {
"command": "uvx",
"args": [
"yargi-mcp"
],
"env": {}
}
}
}Config file · Project scope: .mcp.json at the repository root
The project file uses mcpServers. For user scope, use claude mcp add --scope user rather than assuming .mcp.json in your home directory is the user configuration. Check the client documentation for managed settings and storage details. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"yargi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"yargi-mcp"
],
"env": {}
}
}
}Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Tools
No individual tool names were confirmed in the source material. Check the repository for its current tool list.
Names, permissions, and defaults can change. Check the current upstream documentation before granting access.
Use cases
- Find Turkish appellate decisions by subject and date.
- Retrieve Constitutional Court decision text in manageable pages.
- Research regulatory decisions across several public bodies.
- Access legal sources from a local MCP assistant without using the hosted server.
Strengths
- Covers multiple Turkish courts and regulators.
- Converts retrieved decisions into Markdown.
- Provides both local and hosted connection options.
Limitations
- Search filters and retrieval behavior differ between sources.
- Clients configured with the old hosted URL must migrate.
- Exact tool identifiers are not stated in the supplied README.
Frequently asked questions
Independent listing, not an affiliation or security review. Grant the least access needed and verify the upstream instructions before running code.