argila MCP server

Version 1.0.0 · argila.ai

Andorran and Spanish law: legislation with in-force status, case law and binding tax doctrine; legal research with citable passages, and citation checks against the official sources.

Connect

Server URL:

https://mcp.argila.ai/mcp
Transport
Streamable HTTP, stateless: POST https://mcp.argila.ai/mcp
Sign-in
OAuth 2.1 with PKCE, with your argila account (free to create). Clients identify themselves with a client ID metadata document (CIMD).
Discovery
/.well-known/oauth-protected-resource names the authorization server, clerk.arcilla.ai, and the scope mcp.
Machine-readable
/docs.json: this page's content, as the server lists it.

Claude

  1. Settings › Connectors › Add custom connector.
  2. Paste the server URL and connect.
  3. Sign in with your argila account and allow access.

ChatGPT

  1. Add a custom connector (app) with the server URL.
  2. Sign in with your argila account and allow access.

Then ask

Write @argila in your message — «Consulta-ho a @argila», «Pots verificar aquesta resposta amb @argila?» — and the assistant picks the tool it needs.

Tools (11)

VerificarCitacions

Verify citations
Saves to your accountOwn corpus

Checks the legal statements and citations of a brief, contract, opinion or any legal text against the sources they cite in Spanish or Andorran law (verificar citas; verificar citacions). For each statement it reports whether the source supports it (verified), exists but does not support it (not_supported), could not be found (not_found; the source may still exist outside this corpus), or states nothing that can be checked (not_verifiable), with the passage used as evidence. Optionally searches for a source for statements that cite none. The codes name the verdicts for the tools; the brief states each in the user's language.

ParameterTypeDescription
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
claimsrequiredobject[]
at least 1 item · up to 50 items
idrequiredstring
1–40 characters
statementrequiredstringThe legal proposition, as written.
3–1500 characters
citationstringWhat the statement cites: free text, a source id, or the number of a research's source such as [3].
up to 300 characters
quotestringWords the statement quotes from the source; checked literally.
up to 2000 characters
pinpointstringWhere in the source: apartado 4, FD tercero.
up to 100 characters
pack_idstringLets a citation be the number of one of that research's sources, such as [3].
up to 40 characters
suggestbooleanSearch for a source for statements that cite none or whose source is not found.
default false
language"es" | "ca" | "en"The language of the user's conversation, for the explanations and the card: es, ca or en. By default, the claims' own.
Result fields (structuredContent)
FieldTypeDescription
resultsobject[]
idrequiredstring
statementstringThe claim's statement, as it was sent.
citationstringThe claim's citation, as it was sent.
verdictrequired"verified" | "not_supported" | "not_found" | "not_verifiable"
reason"contradicts" | "not_stated" | "partially" | "figure_mismatch" | "quote_not_literal" | "wrong_court" | "not_in_force" | "unresolved_reference" | "ambiguous" | "outside_coverage" | "generic_statement" | "opinion_or_strategy" | "no_source_cited" | "source_type_not_covered"
explanationrequiredstring
sourceobject
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
candidatesany[]
evidenceobject
textrequiredstring
locatorstring
literalrequiredboolean
correctionobject
citationstring
quotestring
noterequiredstring
suggested_sourcesany[]
confidencerequired"high" | "medium" | "low"
verdict_labelstringThe verdict in the user's language, the words for the user; the code beside it is for the tools.
reason_labelstringWhy, when it isn't verified, in the user's language, the words for the user; the code beside it is for the tools.
confidence_labelstringHow sure the check is in the user's language, the words for the user; the code beside it is for the tools.
countsobject
verifiedrequiredinteger
not_supportedrequiredinteger
not_foundrequiredinteger
not_verifiablerequiredinteger
reportobject
createdAtrequiredstring
seqrequirednumber
savedobject
task_idrequiredstring
urlrequiredstringThe full report in the user's account on arcilla.ai (argila.ai for Andorran law), for the user to open.
languagestring
counts_labelstringThe verdicts counted in the user's language, the words for the user; the code beside it is for the tools.
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

ResoldreCitacions

Resolve citations
Read-onlyOwn corpus

Finds the sources that legal references point to in Spanish or Andorran law — articles of named laws (art. 1902 CC), rulings by ECLI, ROJ or number (STS 111/2015), binding tax rulings by code (V0787-25) — and returns their text and in-force status.

ParameterTypeDescription
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
referencesrequiredstring[]One reference per item, as written: art. 242.2 CP, artículo 14 de la Ley 29/1994, ECLI:ES:TS:2018:2363, STS 101/2018, V1234-24.
at least 1 item · up to 100 items
include_textbooleanfalse: each source's status and a line on what it is about, without its text, for large batches.
default true
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
resultsrequiredobject[]
referencerequiredstring
statusrequired"resolved" | "ambiguous" | "not_found"
sourcesrequiredobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
notestring
status_labelstringWhether the reference was found in the user's language, the words for the user; the code beside it is for the tools.

InvestigarQuestio

Research a legal question
Saves to your accountOwn corpus

Researches a question of Spanish law, state or regional (Catalonia, Madrid…), or of Andorran law across legislation, case law and binding tax doctrine (investigación jurídica; recerca jurídica), and returns the sources found, numbered [1]…[n]: exact passages, official links, in-force status, how the sources relate, and what could not be found. It takes the question in natural language and does its own analysis: the issues, the legal concepts and the terms courts use, and a search plan across the three corpora. It does not write an answer. Research usually takes 10–60 seconds.

ParameterTypeDescription
questionrequiredstringThe question as the user asked it, in their words and language, with the facts of the conversation it depends on. The research analyses it itself: it finds the issues, the legal concepts and the terms courts use for them, and plans its own searches.
3–4000 characters
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
regionstringSpanish autonomous community or court the question is about (Cataluña, Madrid, Andalucía…), if the question doesn't say.
up to 200 characters
depth"standard" | "extended"standard: up to 20 sources, with tax doctrine when the matter is tax. extended: up to 35, with tax doctrine in every case.
default "standard"
Result fields (structuredContent)
FieldTypeDescription
pack_idrequiredstringHandle for continuing this research with other tools (get_research, the searches, verify_citations); it means nothing to the user.
statusrequired"complete" | "running" | "needs_detail" | "out_of_scope"
jurisdictionrequired"es" | "ad"
languagerequiredstring
resultsrequiredobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
issuesrequiredobject[]
labelrequiredstring
sourcesrequiredinteger[]
findingsrequiredobject[]
textrequiredstring
sourcesrequiredinteger[]
conclusionstringWhat the sources, together, answer to the question, in two sentences at most.
noticesrequiredobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
gapsrequiredobject[]
topicrequiredstring
textrequiredstring
clarificationstring
coveragerequiredobject
legislation_untilrequiredstring
case_law_untilrequiredstring
doctrine_untilrequiredstring
statsrequiredobject
elapsed_msrequirednumber
stepsrequirednumber
revisionsrequirednumber
candidatesrequirednumber
savedobject
task_idrequiredstring
urlrequiredstringThe full report in the user's account on arcilla.ai (argila.ai for Andorran law), for the user to open.
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.
status_labelstringThe research's state in the user's language, the words for the user; the code beside it is for the tools.

RecuperarInvestigacio

Get research
Read-onlyOwn corpus

Reopens a research by the id InvestigarQuestio gave it, for 24 hours after its last use: complete, or as it stands at that moment while it is still running. It returns at once and doesn't wait; a research not done in time returned a job, and ObtenirResultat waits for it.

ParameterTypeDescription
pack_idrequiredstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idrequiredstringHandle for continuing this research with other tools (get_research, the searches, verify_citations); it means nothing to the user.
statusrequired"complete" | "running" | "needs_detail" | "out_of_scope"
jurisdictionrequired"es" | "ad"
languagerequiredstring
resultsrequiredobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
issuesrequiredobject[]
labelrequiredstring
sourcesrequiredinteger[]
findingsrequiredobject[]
textrequiredstring
sourcesrequiredinteger[]
conclusionstringWhat the sources, together, answer to the question, in two sentences at most.
noticesrequiredobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
gapsrequiredobject[]
topicrequiredstring
textrequiredstring
clarificationstring
coveragerequiredobject
legislation_untilrequiredstring
case_law_untilrequiredstring
doctrine_untilrequiredstring
statsrequiredobject
elapsed_msrequirednumber
stepsrequirednumber
revisionsrequirednumber
candidatesrequirednumber
savedobject
task_idrequiredstring
urlrequiredstringThe full report in the user's account on arcilla.ai (argila.ai for Andorran law), for the user to open.
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.
status_labelstringThe research's state in the user's language, the words for the user; the code beside it is for the tools.

BuscarLleis

Search legislation
Read-onlyOwn corpus

Searches Spanish legislation, state and regional laws, codes and regulations (legislación, leyes, BOE), or Andorran laws (lleis, BOPA) for the articles that regulate one matter, and returns them with their text, in-force status and official links. Retrieval combines meaning and words; the articles are ranked against the whole query. With a law named, the articles the query or the name gives by number ("Código Civil, art. 92") are read from that law and come first. ResoldreCitacions looks up references already known, without a matter to search.

ParameterTypeDescription
queryrequiredstringThe matter the articles regulate, as a sentence in the language the corpus is written in — Spanish for jurisdiction "es", Catalan for "ad" —, whatever language the user writes in: retrieval combines meaning and words, and the results are ranked against the whole query.
3–1000 characters
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
in_force_onlyboolean
default true
lawstringRestrict the search to one law, by name or abbreviation. Articles it names by number ("Código Civil, art. 92") come first.
up to 300 characters
limitinteger
1–10 · default 5
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
overviewstringCase-law search: what the rulings found decide on the matter searched, in two sentences at most. Not their wording: quote only their passages.
resultsobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
noticesobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

BuscarJurisprudencia

Search case law
Read-onlyOwn corpus

Searches Spanish case law — Tribunal Supremo, Audiencia Nacional, regional High Courts, Audiencias Provinciales and other courts, Catalonia's included, from their official sources — or Andorran case law (jurisprudencia, sentencias; jurisprudència, sentències), and returns the most relevant rulings with the court, the ruling's number, the date, the relevant passages and official links, for one legal issue. Retrieval combines meaning and words; the rulings and their passages are ranked against the whole query. A court, region or date range narrows the ranking.

ParameterTypeDescription
queryrequiredstringThe legal issue the rulings decide, with the facts that matter, as a sentence in the language the corpus is written in — Spanish for jurisdiction "es", Catalan for "ad" —, whatever language the user writes in: retrieval combines meaning and words, and the results are ranked against the whole query.
3–1000 characters
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
courtstringA court by name: Tribunal Supremo, Audiencia Provincial de Barcelona. It raises that court's rulings and keeps only them.
up to 200 characters
regionstringA Spanish autonomous community or province (Cataluña, Barcelona, Madrid…). It raises its courts' rulings and keeps only them.
up to 200 characters
date_fromstring
pattern ^\d{4}-\d{2}-\d{2}$
date_toany
limitinteger
1–10 · default 5
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
overviewstringCase-law search: what the rulings found decide on the matter searched, in two sentences at most. Not their wording: quote only their passages.
resultsobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
noticesobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

BuscarDoctrinaTributaria

Search tax doctrine
Read-onlyOwn corpus

Searches binding tax rulings — Spain's Dirección General de Tributos (consultas vinculantes, doctrina tributaria), Andorra's consultes vinculants and comunicats tècnics — on taxes such as IRPF, IVA, Sociedades or IGI, and returns them with their code, date, relevant passages and official links, ranked against the whole query.

ParameterTypeDescription
queryrequiredstringThe tax matter the rulings answer, as a sentence in the language the corpus is written in — Spanish for jurisdiction "es", Catalan for "ad" —, whatever language the user writes in: retrieval combines meaning and words, and the results are ranked against the whole query.
3–1000 characters
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
date_fromstring
pattern ^\d{4}-\d{2}-\d{2}$
date_toany
limitinteger
1–10 · default 5
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
overviewstringCase-law search: what the rulings found decide on the matter searched, in two sentences at most. Not their wording: quote only their passages.
resultsobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
noticesobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

LlegirFont

Get source
Read-onlyOwn corpus

Returns the text of a source by id: the full text in pages, or with a query, the passages of that source whose meaning is closest to it.

ParameterTypeDescription
idrequiredstringA source's id as a result gives it: es:law:BOE-A-1995-25444:a242, es:ruling:ECLI:ES:TS:2018:2363.
3–200 characters
querystringWhat to find in the source, as a sentence: its passages are ranked against it by meaning.
up to 1000 characters
offsetinteger
≥ 0 · default 0
max_charsinteger
1000–30000 · default 20000
pack_idstringThe id of a research (rp_…), from research_legal_question: the call adds its sources to that research's numbered list.
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
sourcerequiredobject
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
offsetrequiredinteger
next_offsetrequiredinteger | null
total_charsrequiredinteger

ConsultarXifresOficials

Get official figures
Read-onlyOwn corpus

Returns official legal and tax figures for a year — legal interest rate (interés legal del dinero), minimum wage (SMI), IPREM, tax scales, social security bases, Andorran CASS and IGI rates — with the provision of the corpus that sets them.

ParameterTypeDescription
figurerequired"interes_legal_dinero" | "interes_demora_tributario" | "salario_minimo_interprofesional" | "iprem" | "tipo_impuesto_sociedades" | "escala_irpf_estatal" | "bases_cotizacion_seguridad_social" | "salari_minim" | "tipus_igi" | "cotitzacio_cass"
jurisdictionrequired"es" | "ad"es = Spanish law (Spain, España, Espanya), ad = Andorran law (Andorra). One legal system per call. A user who names argila or @argila usually means Andorran law; arcilla or @arcilla, Spanish law.
yearrequiredinteger
1990–2100
regionstring
up to 200 characters
language"es" | "ca" | "en"The language of the user's conversation, for the explanations and the card: es, ca or en. By default, the legal system's: Catalan for Andorra, Spanish for Spain.
Result fields (structuredContent)
FieldTypeDescription
figurestring
jurisdiction"es" | "ad"
yearinteger
foundboolean
valuestring
unitstring
periodstring
sourceobject
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
explanationstring
languagestring
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

BuscarSentenciesQueCiten

Find citing rulings
Read-onlyOwn corpus

Returns later Spanish or Andorran rulings that cite a given ruling or article, with the passage where they cite it.

ParameterTypeDescription
idrequiredstringA source's id as a result gives it: es:law:BOE-A-1995-25444:a242, es:ruling:ECLI:ES:TS:2018:2363.
3–200 characters
date_fromstring
pattern ^\d{4}-\d{2}-\d{2}$
courtstring
up to 200 characters
limitinteger
1–10 · default 5
Result fields (structuredContent)
FieldTypeDescription
pack_idstring
overviewstringCase-law search: what the rulings found decide on the matter searched, in two sentences at most. Not their wording: quote only their passages.
resultsobject[]
ninteger
idrequiredstring
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
jurisdictionrequired"es" | "ad"
titlerequiredstring
citationrequiredstring
short_namestringThe source as arcilla names it on its citation chips: 92.2 CC, STS 568/2015, FD Segundo, V0787-25.
source_namestringWhat arcilla shows under the citation: the law's common name or title, the ruling's ROJ or court.
urlrequiredstring | nullThe official text: BOE, the courts' official case-law source, the DGT's database, Andorra's Portal Jurídic or BOPA. Null when the source has no public link.
viewer_urlstringOnly on the sources of a saved research or citation check: the source inside that saved work in the user's arcilla account (argila for Andorra), the cited passage highlighted. Other sources have no arcilla link.
daterequiredstring | null
statusrequired"in_force" | "repealed" | "exhausted" | "pending"
applies_fromstring
not_in_force_sincestring
territorystring
courtstring
numberstring
rojstring
eclistring
passagesrequiredobject[]
textrequiredstring
locatorstring
beforestringA ruling's paragraph before the passage, up to 60 words: the passage in context.
afterstringA ruling's paragraph after the passage, up to 60 words.
fragmentsstring[]The passages of one paragraph this passage joins, each found in its text.
summarystringWhat the source is about, in a line: a ruling's summary, the question a tax ruling answers, an article's opening words. Not the source's wording: quote only its passages.
summary_onlytrue
text_charsrequiredinteger
status_labelstringWhether the law is in force in the user's language, the words for the user; the code beside it is for the tools.
kind_labelstringThe kind of source in the user's language, the words for the user; the code beside it is for the tools.
noticesobject[]
typerequired"pending_law" | "other_territory" | "summary_only" | "article_not_found" | "version" | "fewer_results" | "research_note" | "time_limit" | "interrupted"
textrequiredstring
sourcesinteger[]
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

ObtenirResultat

Get result
Read-onlyOwn corpus

Returns the result of a job: the verification, search or research that a tool returned as a job because it was not done within about 45 seconds. It is the one way to wait for a job, research included. While the job is still queued or running it returns the job again, waiting up to wait_seconds for it. A result is kept 10 minutes after the job ends, or 1 minute once collected; a research stays readable with RecuperarInvestigacio for 24 hours.

ParameterTypeDescription
job_idrequiredstringThe id of a job a tool returned when it wasn't done in time.
1–80 characters
wait_secondsinteger
0–45 · default 30
Result fields (structuredContent)
FieldTypeDescription
statusrequired"done" | "queued" | "running"
toolrequiredstring
resultobjectThe tool's own result, once done.
jobobject
idrequiredstring
statusrequired"queued" | "running"
positioninteger
retry_after_srequiredinteger
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.
status_labelstringThe job's state in the user's language, the words for the user; the code beside it is for the tools.

Panel tools (2)

Called by the server's interactive panel (MCP Apps), never by the model.

ProgresInvestigacio

Research progress
Panel onlyRead-onlyOwn corpus

Shows a running research's progress in arcilla's panel: its state, its steps and the sources found so far, by citation only, without their text. It isn't needed to answer a question: a research's sources and findings come with its result.

ParameterTypeDescription
pack_idrequiredstringThe id of a running research (rp_…).
up to 40 characters
Result fields (structuredContent)
FieldTypeDescription
pack_idrequiredstringHandle for continuing this research with other tools (get_research, the searches, verify_citations); it means nothing to the user.
statusrequired"complete" | "running" | "needs_detail" | "out_of_scope"
jurisdictionrequired"es" | "ad"
statsrequiredobject
elapsed_msrequirednumber
stepsrequirednumber
revisionsrequirednumber
candidatesrequirednumber
issuesrequiredstring[]
sourcesrequiredobject[]
nrequiredinteger
kindrequired"law_article" | "law_provision" | "ruling" | "doctrine"
citationrequiredstring
short_namestring
statusrequired"in_force" | "repealed" | "exhausted" | "pending"

ProgresCrida

Call progress
Panel onlyRead-onlyOwn corpus

Shows in arcilla's panel how a call it is showing is going, found by the call's tool and arguments: queued or running, and the steps it has taken, by name only. It isn't needed to answer a question: every call's result comes with the call.

ParameterTypeDescription
toolstringThe tool the call is to; without it, every tool the arguments fit.
up to 64 characters
argumentsrequiredobjectThe call's arguments, as the call was made.
Result fields (structuredContent)
FieldTypeDescription
staterequired"queued" | "running" | "done" | "unknown"
toolstring
jurisdiction"es" | "ad"The call's legal system: the language a get_result's panel speaks.
positioninteger
started_atstring
stepsrequiredobject[]
researchobject

Prompts (2)

Ready-made workflows: your AI client lists them in its prompt menu.

check_citations

Check citations

Checks every legal statement of a document or text in the conversation against the source it cites.

ArgumentDescription
jurisdictionrequiredes = Spanish law, ad = Andorran law

Resources (4)

NameURIDescription
arcilla panelui://arcila/panel-{version}.htmlEvery tool's result as a panel, at the address of its current version.
arcilla panelui://arcila/panel.htmlEvery tool's result as a panel: citation checks, searches, research, the reader and official figures, each source a chip that opens it in arcilla.
Citation reportui://arcila/citation-report.htmlThe earlier address of the same panel.
arcilla panelui://arcila/panel-05c3db9a6d5a.htmlEvery tool's result as a panel, at the address of its current version.

What the server tells AI clients

arcilla (arcilla.ai; argila.ai for Andorra) holds Spanish and Andorran law: consolidated legislation with in-force status, state and regional; case law (official sources of the Spanish and Andorran courts); binding tax doctrine (Spain's Dirección General de Tributos; Andorra's consultes vinculants and comunicats tècnics). It researches legal questions, finds articles, rulings and tax rulings, and checks the citations of legal texts against the official sources. Every call names one legal system: jurisdiction es or ad. Each result starts with a brief for the reader in the user's language — citations ready to paste, statuses, official links, the link to the report saved in the user's account — then the JSON. Tell the user what a result means in their own words, as the brief does: the values the JSON names things with — a verdict such as verified, not_supported, not_found or not_verifiable; a status, reason or notice type; an error code; an id — are for the tools, and the user should see none of them. What a source says comes from the results: when they don't hold an article, ruling or passage the answer needs, or a notice says it wasn't found, say so, and don't supply its content from memory. Passages, in Spanish or Catalan, are quoted as they are. InvestigarQuestio takes a question in natural language, as the user asked it, and plans its own searches; each search looks for one matter; ResoldreCitacions looks up references already known; LlegirFont reads a source whole or finds passages in it. A research numbers its sources [1]…[n] and lasts 24 hours after its last use; its pack_id, a handle the user doesn't know, lets the searches add to it, RecuperarInvestigacio reopen it and VerificarCitacions cite its numbers. A call not done in about 45 seconds returns a job; ObtenirResultat returns its result. When the user's monthly arcilla usage is used up, every tool returns quota_exceeded until it resets: don't retry; tell the user when it resets and where to see their plan, as the error says.