dontes.app

Machine access (MCP)

You can connect dontes.app to your own Claude or ChatGPT (or any other MCP-capable AI tool): your AI uses the dontes.app search to find and read the decisions, and you keep asking right there in the conversation. You sign in with your own dontes.app account; calls count against your machine-access quota.

How to connect

This is the address to enter:

https://dontes.app/mcp

Claude (claude.ai, desktop and mobile app)

  1. On claude.ai or in the desktop app: Customize → Connectors → + → Add custom connector. It also works on the free plan (one custom connector).
  2. Name: dontes.app, URL: the address above. Leave the other (OAuth) fields empty, then click Add.
  3. Click Connect, sign in with your dontes.app account and approve access.
  4. In a chat: the + button → Connectors → switch on dontes.app. After that it's available in the mobile app as well.

On Team or Enterprise plans an organization admin adds it (Organization settings → Connectors); members then connect under Customize → Connectors with the Connect button.

ChatGPT (personal Plus or Pro plan)

  1. On the chatgpt.com website: Settings → Apps (formerly: Connectors) → Advanced settings → turn on Developer mode.
  2. In the same place: Create. Name: dontes.app, URL: the address above, authentication: OAuth.
  3. In the pop-up, sign in with your dontes.app account and approve access.
  4. In a chat: the + button → Developer mode → tick dontes.app.

ChatGPT's menu names change often: if you see something different, look for “Developer mode” and “Apps” or “Connectors”. This isn't available on the free ChatGPT plan.

ChatGPT (workplace: Business, Enterprise, Edu)

  1. The workspace's ChatGPT admin creates a custom app (Apps / MCP) with the address above.
  2. Authentication: OAuth. Choose “End-user account”, so that everyone uses it with their own dontes.app account and quota.
  3. On first use, sign in with your dontes.app account in the pop-up and approve access.

Tools

  • search Search decisions — the main tool. 10 results by default, up to 50; fast, the agent does the analysis.
  • fetch The full text of one decision from the search results.
  • ask dontes.app's own analysed answer with word-for-word verified quotes (20–50 s). Scarce (3 per day by default), works from at most 10 decisions — the agent can do the search and the analysis itself with search + fetch.
  • usage Your quota status (doesn't count).

Machine access is free too, and dontes.app runs entirely on donations. If your assistant searches it regularly, please help keep it running. If 10 people give about €13 a month, it is covered – 2 already do. Support it →

Full reference for power users

Everything machine access can do: courts, tools and their parameters, every filter field, what a result contains, and the limits and quotas. Your AI reads all of this from the MCP description by itself; this section is for you, so you know what you can ask it for.

Courts (courts)

  • ab Hungarian Constitutional Court
  • bhgy Hungarian ordinary courts incl. the Kúria (Collection of Court Decisions)
  • eub Court of Justice of the EU (Court of Justice, General Court, Civil Service Tribunal)
  • efta EFTA Court
  • kdb Hungarian Public Procurement Arbitration Board
  • kir Curia guidance: college opinions and positions, case-law analyses, old guidelines and principled decisions (NON-binding)
  • gvh Hungarian Competition Authority: administrative (not court) decisions; OFF by default, only with courts:['gvh']
  • ejeb European Court of Human Rights (HUDOC; English or French text; aliases: echr, ecthr, egmr)

If courts is omitted, all seven are searched. Queries work best in Hungarian; case numbers work too.

Tools and their parameters

search1 search

Hybrid (semantic + keyword) search with reranking. The most relevant decisions with section-labelled excerpts, full metadata and the appeal chain. Writes no analysis.

querycourtsmax_results: 1–50 (10)lang: hu | enfiltersexcludecited_section_min_status: uncertain | probable | confirmed
fetch1 fetch / part

The full text of one decision: data sheet (all metadata), appeal chain with ids, section map (operative part, reasoning, facts, dissent… with character ranges), then the text. Long decisions come in 40,000-character parts; for the next part use offset = next_offset. It also gives the decision's public page and the paragraph anchors, so every quote can carry a link to its paragraph.

idoffset
verify_quotesfree

Deterministic check of quotes against the full text of the decision, without AI. For each quote it says whether it is there word for word; if so, it gives the paragraph and a link to the public decision page that opens at that paragraph with the quote highlighted. If not, it returns the closest real passage of the decision. It cannot check translations, only text in the original language.

quotes: [{ id, quote }] (1–20)
ask1 ask

dontes.app's own finished answer: summary, analysis and word-for-word verified quotes, with the list of decisions used. 20–50 seconds, from at most 10 decisions. Takes no filters.

questioncourtsmax_decisions: 1–10 (10)lang: hu | en
list_filtersfree

The list of filter fields: type, which courts each applies to, allowed values with frequencies, year ranges, examples.

courts
filter_valuesfree

The exact values of one field, most frequent first (judges, rapporteurs, court names, statutes, codes, contracting authorities). contains is case- and accent-insensitive; name variants of one person are grouped.

fieldcontainscourtslimit: 1–100 (25)
usagefree

Your remaining quota.

eurlex_* (13)fulltext_search + sparql: shared daily quota; the rest only per-minute limited

Text of EU legislation from EUR-Lex (regulations, directives, decisions, Treaties; CELEX number, e.g. 32016R0679): resolve, search, fulltext_search, info, toc, section, grep, read_lines, compare_languages, relations, cases, sparql, abbreviations. Start with eurlex_resolve, read with eurlex_section.

Filter fields (for search filters / exclude)

year_from / year_toapplies to: AB, BHGY, EUB, EFTA, KDB, EJEB

Decision year at least / at most (year precision).

e.g. 2018

sectionapplies to: AB, BHGY, EUB, EFTA, KDB, EJEB

Search only these parts (the excerpt comes from there too): reasoning (the court's own reasoning), facts (facts, history, parties' and lower court's arguments), operative, dissent (AB, EJEB), cited_laws (AB), header, closing.

e.g. reasoning

judgeapplies to: AB, BHGY, EUB, EFTA, KDB

Any panel member (rapporteur included). Accent-, case-, “dr.”- and order-insensitive; exact form: filter_values.

judge_allapplies to: AB, BHGY, EUB, EFTA, KDB

All given judges sat on the panel (AND), e.g. two judges' joint decisions.

rapporteurapplies to: AB, BHGY, EUB, EFTA, KDB

Rapporteur judge (at the CJEU, for an AG opinion the Advocate General).

court_nameapplies to: BHGY

Court name.

e.g. Kúria

court_levelapplies to: BHGY

Court level.

e.g. kuria, itelotabla, torvenyszek, jarasbirosag, kozig_munkaugyi

collegeapplies to: BHGY

College (division).

e.g. polgári, büntető, közigazgatási, gazdasági, munkaügyi

legal_areaapplies to: BHGY

Legal area (values: list_filters).

e.g. polgári jog

cited_law / cited_law_allapplies to: BHGY

Statute cited by the decision (any / all); exact form: filter_values.

e.g. 2013. évi V. törvény (Ptk.)

cited_sectionapplies to: BHGY

Cited provision (section, paragraph, point, EU law too), from the court database's text-checked tags and the decision text. Reliability: cited_section_min_status.

e.g. Ptk. 6:94. §

code_appliedapplies to: BHGY

Old or new code applied (about 99 % accurate).

e.g. Ptk=új, Pp=régi, Btk=mindkettő

document_typeapplies to: AB, EUB, EFTA, KDB, EJEB

Document type: decision, order, ag_opinion (CJEU), opinion (CJEU/EFTA/ECtHR advisory). At the ECtHR decision means judgments only; otherwise use ejeb_document_type.

eu_courtapplies to: EUB

EU court.

e.g. court_of_justice, general_court, civil_service_tribunal

procedureapplies to: EFTA

Procedure type.

e.g. advisory, direct_action

contracting_authorityapplies to: KDB

Contracting authority.

e.g. Magyar Közút Nonprofit Zrt.

respondent_stateapplies to: EJEB

Respondent State (English name or ISO3).

e.g. Hungary, HUN

convention_articleapplies to: EJEB

Convention or Protocol article concerned; “6” means all of Article 6.

e.g. 8, 6, P1-1

importanceapplies to: EJEB

HUDOC importance: key (key case), 1–3.

formationapplies to: EJEB

Formation.

e.g. GC, Chamber, Committee, Panel, Plenary, Other

ejeb_document_typeapplies to: EJEB

Judgment, decision (admissibility, strike-out) or advisory opinion.

e.g. judgment, decision, advisory_opinion

decision_kindapplies to: EJEB

Kind of decision.

e.g. inadmissible, strike_out, partly_inadmissible_strike_out, admissible, advisory_request, advisory_competence, other

type_descriptionapplies to: EJEB

HUDOC type description.

e.g. Judgment (Just Satisfaction)

Rules

  • OR within a field, AND across fields; at most 20 values per field. A year is a single whole number between 1950 and 2100. exclude has the same shape and removes matches (no year fields there).
  • If a filter doesn't apply to a court, that court is left out; the answer's SZŰRŐ block states what was applied, what was left out and why.
  • With filters and an empty query, search lists matches without ranking.
  • Filters can also be written into the query: field:value, field:"two words", OR: |, exclude: -field:value. Only exact field names (from the list above) work; any other word stays part of the query. Example: felmondás court_level:kuria year_from:2018 section:reasoning
  • cited_section_min_status: uncertain (default: all tags), probable (confirmed + probable), confirmed (text-confirmed only; most precise, fewer hits).
  • An unknown parameter or field is rejected with a clear error and a suggestion (never silently ignored).

What a search returns

  • Per decision: section-labelled excerpts (reasoning, facts…), court, case number, date with its precision (day / year only / estimated from the case number), judges, rapporteur, college/legal area, cited statutes.
  • BHGY: provision-level cited_sections (unmarked = confirmed or probable, * = uncertain), old/new code; authority documents (HATÓSÁGI IRAT) are flagged, since they are not court rulings.
  • The appeal chain in chronological order, with each member's status (upheld, overturned, final…) and its own id; every id works in fetch.
  • A fetch id can be a result id or a case number, e.g. bhgy:Mfv.10046/2015/4, eub:C-311/18, efta:E-1/05, kdb:D.719/2025, ejeb:001-57506, ejeb:20261/12, ECLI.

Limits and quotas

  • One search returns at most 50 decisions (default 10); fetch delivers 40,000-character parts; ask works from at most 10 decisions.
  • Default quota per user: search 60 / day, fetch 1000 / day, ask 3 / day; search, fetch and ask together at most 20 calls per minute. An admin can also set weekly and monthly ask caps. Your own actual quota is shown above in the Quota table.
  • The daily window resets at midnight Budapest time. You can set your own lower limits above (e.g. against an agent stuck in a loop).
  • Shared daily cap for all users together: search 2,000, ask 100, fetch 20,000. If it is reached, you can continue the next day.
  • EUR-Lex: eurlex_fulltext_search and eurlex_sparql share a daily quota of 100 per person; full-text search is capped at 900 per day for all users together; all EUR-Lex tools at most 30 calls per minute, at most 2 running at once. EUR-Lex is available to every account by default, but an admin can switch it off per account.
  • Every tool is read-only: machine access writes or changes nothing. Filters work in search only, not in ask.