argüman.ai
arguman.ai for Claude · Documentation

Turkish, European and German case law
queried directly from Claude.

arguman.ai's index of roughly 15 million court decisions connects to Claude from its official connector directory in a few clicks. You run case-law search, citation lookup and sentence-execution computation in the course of an ordinary conversation, and every finding is tied back to the source decision. No code, no API key.

Setup

Connect to Claude

Prerequisite: The Claude connection is included in the arguman.ai Standard and Professional subscriptions and academic accounts; new accounts can also connect during their trial. Plans

argüman.ai is in Claude's official connector directory. No code, URL or API key: three clicks, about a minute.

Open in the Claude directory ↗
  1. 1
    Find argüman.ai in the directory
    In Claude, open the Directory (claude.ai/directory) and search for "argüman" — or use the button above to go straight to the listing.
  2. 2
    Click Connect
    Click Connect on the argüman.ai card.
  3. 3
    Sign in to arguman.ai
    Sign in with your e-mail and password in the window that opens. Skipped if you are already signed in.
  4. 4
    Click İzin ver (Allow) on the consent screen
    Done — the connection is set up.

Return to the chat; Claude calls the tools as a question requires. You can remove the connection at any time from Customize → Connectors.

Can't see the directory? Add it as a custom connector›

Some organisation accounts have the directory disabled. Go to Customize → Connectors → + → Add custom connector, enter argüman.ai as the name and the URL below, then Connect and İzin ver (Allow).

https://mcp.arguman.ai/mcp
Claude Code (terminal) — one-liner›

From a terminal:

claude mcp add --transport http arguman https://mcp.arguman.ai/mcp

Then in a Claude Code session run /mcp; the OAuth flow opens in your browser. Click Allow and the connection persists.

OpenAI Codex CLI — two commands›

From a terminal:

codex mcp add arguman --url https://mcp.arguman.ai/mcp
codex mcp login arguman

The second command opens a browser tab; click Allow and the token is stored.

Google Gemini CLI — one-liner›

From a terminal:

gemini mcp add --transport http --scope user arguman https://mcp.arguman.ai/mcp

Then in a Gemini session run /mcp auth arguman; the OAuth flow opens in your browser. Approve and you're connected.

If you're using Claude Desktop›

Open Settings → Developer → Edit Config from the app menu and add this block toclaude_desktop_config.json:

{
  "mcpServers": {
    "arguman-legal": {
      "type": "http",
      "url": "https://mcp.arguman.ai/mcp"
    }
  }
}

Restart Claude. On first use, a browser tab opens for approval; once you click Allow the connection persists.

If you're using Google Antigravity›

From the ···menu at the top of the agent panel, open MCP Store → Manage MCP Servers → View raw config. Add this block to~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "arguman": {
      "serverUrl": "https://mcp.arguman.ai/mcp"
    }
  }
}

Save and reload Antigravity. Then open Agent Settings(⌘, / Ctrl+,) → Customizations tab and click Authenticate next to arguman; approve in the browser, copy the code and paste it back. OAuth is handled automatically (no manual client setup needed).

Usage

How to ask

Ask Claude in plain language. Two habits sharpen results noticeably:

  • Write doctrinal terms in Turkish. "Haksız tahrik" rather than "I lost my temper"; "tasarrufun iptali davası" rather than "he's hiding assets".
  • Start with the citation when you have one. Esas/karar number or ECLI fetches the decision directly.
Citation → full textExample 1
Claude looking up a Yargıtay Court of Cassation General Criminal Assembly decision by docket number and fetching the full text through arguman.ai
Given an esas/karar number, Claude locates the correct case and pulls the full text.
Doctrine research → synthesisExample 2
Claude assembling Yargıtay 1st Criminal Chamber precedent on the haksız tahrik (unjust provocation) defence and producing a cited synthesis
On a doctrinal question Claude fetches several decisions, reads their full text and writes a sourced synthesis.
Tools

Eight tools, all read-only

Claude calls these eight tools as a question requires; the names appear verbatim in Claude's tool strip. There is no endpoint for account profile, billing or personal data.

Hybrid case-law search

Free

Search by topic, concept or doctrine. A Turkish-language query also surfaces ECtHR and BGH decisions in their original language. No credits; the optional expanded search costs 1 credit.

Look up case by docket

Free

Direct lookup by esas/karar number or ECLI. Resilient to OCR and typing errors.

Get case full text

Free

Paged full text of a decision. Long judgments are returned page by page.

Find similar cases

Free

Doctrinal neighbours of a given decision — same issue, across chambers.

Find citing cases

Free

Reverse citation index: later decisions that cite a given case, with direnme/bozma context labels to verify.

Get legislation article

Free

Current text of a statute article (TCK, TMK, TBK, HMK, CMK, İİK, KVKK, the Constitution and more).

Search legislation

Free

Keyword search across statute articles when the article number is not known.

Turkish criminal sentence-enforcement calculator

1 credit

Conditional release, supervised release and open-prison dates under Law 5275 (CGTİHK).

Skills

Ready-made research workflows

Skills package frequently-needed research workflows. You don't need to select one manually; Claude applies the right one based on the question.

caselaw-search

Case-law search

Collection routing, translating lay wording into doctrine ("I got into a fight and hit him" → "haksız tahrik"), drift detection on results.

citation-network

Citation network

Walk from an anchor case through similar and citing decisions. Annotates HGK/CGK binding status.

karsi-arguman

Counter-argument

Stress-tests a legal position: pulls counter-authority and grades threat on a five-level scale.

Coverage

Which courts, which languages

The full set of Turkish high courts, the European Court of Human Rights' complete HUDOC corpus, and the German Federal Court (BGH) are unified in a single index. Total: approximately 15 million decisions.

Yargıtay

Court of Cassation · Türkiye
TR

Criminal and civil chambers, including HGK and CGK precedent-unifying decisions. The "hukuk" collection also includes regional appeal court (BAM) civil chamber decisions; the court type is always shown in the citation.

cezahukuk

Danıştay

Council of State · Türkiye
TR

Administrative law — taxation, zoning, public services, regulatory review.

idare

Anayasa Mahkemesi

Constitutional Court · Türkiye
TR

Norm review and individual applications (post-2012).

anayasa

Uyuşmazlık Mahkemesi

Court of Conflicts · Türkiye
TR

Resolves jurisdictional conflicts between civil, administrative and criminal courts.

uyusmazlik

ECtHR

European Court of Human Rights · Strasbourg
ENFR

Full HUDOC corpus in original languages. Cross-lingual semantic retrieval makes it reachable from Turkish queries.

aihm

Bundesgerichtshof

German Federal Court · Karlsruhe
DE

Criminal and civil divisions — the standard reference for comparative civil-law research in Turkish doctrine.

bgh_strafbgh_zivil

Query and result languages

Ask in Turkish, English, French or German. Cross-lingual semantic retrieval will surface Strasbourg cases in their original English, or Karlsruhe decisions in German, from a single Turkish query.

Turkish results
Yargıtay, Danıştay, AYM, Uyuşmazlık
EN / FR results
ECtHR (HUDOC originals)
German results
BGH (Straf & Zivil)
Privacy

Data & GDPR/KVKK

The connector receives only the arguments of the tool Claude calls, never your conversation. Each call is logged against your account for credit accounting and rate limiting. Details on what is collected, who processes it and how long it is kept are in the connector privacy policy.

FAQ

Frequently asked

What is MCP?›
Model Context Protocol — an Anthropic-led standard for connecting language models to external tools and data sources. arguman.ai exposes a single MCP server; Claude calls into it for case-law search, citation lookup and sentence-execution computation.
Who can connect?›
The connector is included in the arguman.ai Standard and Professional subscriptions, and in academic accounts. New accounts can connect during their trial (7 days for an open sign-up). Other accounts can be granted access on request — write to [email protected].
How are credits consumed?›
Expanded case-law search and the sentence-enforcement calculator deduct 1 credit per successful call. Basic search and the other tools use no credits, subject to daily fair-use limits. Credits draw from your arguman.ai subscription; there is no separate Claude wallet.
Can Claude write to my account or modify anything on my behalf?›
No. Every tool exposed over MCP is read-only. There is no endpoint for account profile, billing or personal data — the authorisation Claude receives only covers calling legal-research tools.
Can I use this from multiple devices?›
Yes. Each Claude client runs its own session, producing a separate connection record. Revoking from one device does not affect the others.
How do I revoke the connection?›
In your arguman.ai account, go to Settings → MCP Connections and remove the connection. Revocation is immediate; the associated tokens are invalidated and Claude will request fresh authorisation on the next call.
Does it make sense to ask about ECtHR cases in Turkish?›
Yes. Cross-lingual semantic retrieval surfaces ECtHR cases from their original English/French text even when the query is Turkish. Write the doctrinal term in Turkish; you do not need to translate it yourself.