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/mcpClaude (claude.ai, desktop and mobile app)
- On claude.ai or in the desktop app: Customize → Connectors → + → Add custom connector. It also works on the free plan (one custom connector).
- Name: dontes.app, URL: the address above. Leave the other (OAuth) fields empty, then click Add.
- Click Connect, sign in with your dontes.app account and approve access.
- 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)
- On the chatgpt.com website: Settings → Apps (formerly: Connectors) → Advanced settings → turn on Developer mode.
- In the same place: Create. Name: dontes.app, URL: the address above, authentication: OAuth.
- In the pop-up, sign in with your dontes.app account and approve access.
- 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)
- The workspace's ChatGPT admin creates a custom app (Apps / MCP) with the address above.
- Authentication: OAuth. Choose “End-user account”, so that everyone uses it with their own dontes.app account and quota.
- On first use, sign in with your dontes.app account in the pop-up and approve access.
Tools
searchSearch decisions — the main tool. 10 results by default, up to 50; fast, the agent does the analysis.fetchThe full text of one decision from the search results.askdontes.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.usageYour 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)
abHungarian Constitutional CourtbhgyHungarian ordinary courts incl. the Kúria (Collection of Court Decisions)eubCourt of Justice of the EU (Court of Justice, General Court, Civil Service Tribunal)eftaEFTA CourtkdbHungarian Public Procurement Arbitration BoardkirCuria guidance: college opinions and positions, case-law analyses, old guidelines and principled decisions (NON-binding)gvhHungarian Competition Authority: administrative (not court) decisions; OFF by default, only with courts:['gvh']ejebEuropean 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 searchHybrid (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 | confirmedfetch1 fetch / partThe 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.
idoffsetverify_quotesfreeDeterministic 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 askdontes.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 | enlist_filtersfreeThe list of filter fields: type, which courts each applies to, allowed values with frequencies, year ranges, examples.
courtsfilter_valuesfreeThe 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)usagefreeYour remaining quota.
eurlex_* (13)fulltext_search + sparql: shared daily quota; the rest only per-minute limitedText 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, EJEBDecision year at least / at most (year precision).
e.g. 2018
sectionapplies to: AB, BHGY, EUB, EFTA, KDB, EJEBSearch 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, KDBAny panel member (rapporteur included). Accent-, case-, “dr.”- and order-insensitive; exact form: filter_values.
judge_allapplies to: AB, BHGY, EUB, EFTA, KDBAll given judges sat on the panel (AND), e.g. two judges' joint decisions.
rapporteurapplies to: AB, BHGY, EUB, EFTA, KDBRapporteur judge (at the CJEU, for an AG opinion the Advocate General).
court_nameapplies to: BHGYCourt name.
e.g. Kúria
court_levelapplies to: BHGYCourt level.
e.g. kuria, itelotabla, torvenyszek, jarasbirosag, kozig_munkaugyi
collegeapplies to: BHGYCollege (division).
e.g. polgári, büntető, közigazgatási, gazdasági, munkaügyi
legal_areaapplies to: BHGYLegal area (values: list_filters).
e.g. polgári jog
cited_law / cited_law_allapplies to: BHGYStatute cited by the decision (any / all); exact form: filter_values.
e.g. 2013. évi V. törvény (Ptk.)
cited_sectionapplies to: BHGYCited 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: BHGYOld or new code applied (about 99 % accurate).
e.g. Ptk=új, Pp=régi, Btk=mindkettő
document_typeapplies to: AB, EUB, EFTA, KDB, EJEBDocument 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: EUBEU court.
e.g. court_of_justice, general_court, civil_service_tribunal
procedureapplies to: EFTAProcedure type.
e.g. advisory, direct_action
contracting_authorityapplies to: KDBContracting authority.
e.g. Magyar Közút Nonprofit Zrt.
respondent_stateapplies to: EJEBRespondent State (English name or ISO3).
e.g. Hungary, HUN
convention_articleapplies to: EJEBConvention or Protocol article concerned; “6” means all of Article 6.
e.g. 8, 6, P1-1
importanceapplies to: EJEBHUDOC importance: key (key case), 1–3.
formationapplies to: EJEBFormation.
e.g. GC, Chamber, Committee, Panel, Plenary, Other
ejeb_document_typeapplies to: EJEBJudgment, decision (admissibility, strike-out) or advisory opinion.
e.g. judgment, decision, advisory_opinion
decision_kindapplies to: EJEBKind of decision.
e.g. inadmissible, strike_out, partly_inadmissible_strike_out, admissible, advisory_request, advisory_competence, other
type_descriptionapplies to: EJEBHUDOC 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.