← Back to blog # How to Use the Apify MCP in Claude to Query Spanish Tax Authority Administrative Doctrine
Learn how to connect the Apify MCP to Claude and use the legaltech/hacienda actor to query TEAC tax administrative doctrine, DGT binding rulings, and historical resolutions directly from the chat.
Querying Spanish tax administrative doctrine — whether from the TEAC, the regional Economic-Administrative Tribunals, or the DGT — means navigating multiple official search engines with complex interfaces. In this guide you will learn how to connect the **Apify MCP** to **Claude** so that the assistant itself searches and analyses the doctrine for you, all from a simple conversation.
## 🏛️ What Sources Does the `legaltech/hacienda` Actor Cover?
The [`legaltech/hacienda`](https://apify.com/legaltech/hacienda?fpr=legaltech) actor automates searches across three official sources of Spanish tax administrative doctrine from the Ministry of Finance:
- **DYCTEA** — binding and non-binding criteria from the TEAC and the regional TEAR tribunals. Covers the central TEAC and all Regional Economic-Administrative Tribunals.
- **DGT** — Binding Rulings from the Directorate General of Taxes. Only binding rulings (V-XXXX-YY).
- **TEAC Histórica** — the classic search engine with historical resolutions classified by tax concept and Vocalía.
## 🤖 Tutorial: Connect Apify to Claude and Start Querying
Thanks to the **Model Context Protocol (MCP)**, Claude can connect to external tools such as Apify. This means that, instead of navigating the official Hacienda search engines, you can ask Claude in natural language to retrieve the doctrine you need and work with it.
### **Step 1: Create an Apify Account and Get Your Token**
The first thing you need is an Apify account. The free plan provides enough monthly usage credits to run the actor.
<br>
<a href="https://console.apify.com/sign-up?fpr=legaltech" target="_blank" rel="noopener noreferrer" style="display: inline-block; padding: 10px 20px; font-size: 16px; font-weight: bold; text-align: center; text-decoration: none; color: #ffffff; background-color: #6B46C1; border-radius: 8px;">
Create a free Apify account
</a>
<br>
Once inside, go to **Settings → API & Integrations**, click **Create new token**, and copy it.

### **Step 2: Download Claude Desktop**
Download and install the Claude Desktop app from [claude.com/download](https://claude.com/download). This desktop version is the one that allows you to add external MCP connectors.
### **Step 3: Install the Apify Connector and Paste Your Token**
Open Claude Desktop, go to the connector settings, and select **Add custom connector**. Enter the Apify MCP URL and paste the token you copied in the previous step.


https://mcp.apify.com/?tools=actors,docs,runs,storage,tasks,legaltech/cendoj,legaltech/hacienda,legaltech/tribunal-constitucional,legaltech/tjue,legaltech/fiscalia,legaltech/catastro,legaltech/ine,legaltech/aepd

With this you now have access to all LegalTech actors from Claude: `legaltech/hacienda`, `legaltech/cendoj`, `legaltech/tribunal-constitucional`, and many more.
> 📱 **Bonus:** Once the connector is set up in your account, you can also use it from the **Claude mobile app**. The connector is linked to your account, so you can query Hacienda doctrine from any device without any additional configuration.
### **Step 4: Query Administrative Doctrine from the Chat**
Once the connector is configured, open the Claude chat and verify that Apify appears as an available tool.

Now you can ask Claude in natural language to find the doctrine you need. For example:
> **Use the legaltech/hacienda actor and find DGT binding rulings on the taxation of cryptocurrencies under personal income tax**
> **Use the legaltech/hacienda actor and give me the latest TEAC resolutions on the deductibility of financial expenses**
> **Use the legaltech/hacienda actor and search DYCTEA for criteria on the tax liability of company directors**
Claude will run the actor with the criteria you specified, automatically selecting the most appropriate source (DYCTEA, DGT, or TEAC Histórica), and return the results ready for analysis.
### **Step 5: Analyse the Doctrine from the Chat**
Once Claude has the results, you can keep working with them without leaving the conversation. Beyond answering questions, Claude can generate **conceptual graphs** that connect tax resolutions with each other and link them to related case law, letting you visualise the evolution of a criterion and the relationships between sources at a glance.

Some examples of what you can ask:
- *Summarise the criterion of each binding ruling in two sentences.*
- *Has the DGT's position on this matter changed in the last three years?*
- *Identify which of these TEAC resolutions are binding in administrative proceedings.*
- *Generate a table with the reference, date, and main criterion of each resolution.*
- *What recurring arguments do the tribunals use in these cases?*
The analysis is a conversation: you refine your questions and Claude responds drawing on the doctrine it retrieved directly from the official Hacienda sources.
Published on by Miguel Gonzalez Herrera
Querying Spanish tax administrative doctrine — whether from the TEAC, the regional Economic-Administrative Tribunals, or the DGT — means navigating multiple official search engines with complex interfaces. In this guide you will learn how to connect the Apify MCP to Claude so that the assistant itself searches and analyses the doctrine for you, all from a simple conversation.
🏛️ What Sources Does the legaltech/hacienda Actor Cover?
The legaltech/hacienda actor automates searches across three official sources of Spanish tax administrative doctrine from the Ministry of Finance:
DYCTEA — binding and non-binding criteria from the TEAC and the regional TEAR tribunals. Covers the central TEAC and all Regional Economic-Administrative Tribunals.
DGT — Binding Rulings from the Directorate General of Taxes. Only binding rulings (V-XXXX-YY).
TEAC Histórica — the classic search engine with historical resolutions classified by tax concept and Vocalía.
🤖 Tutorial: Connect Apify to Claude and Start Querying
Thanks to the Model Context Protocol (MCP), Claude can connect to external tools such as Apify. This means that, instead of navigating the official Hacienda search engines, you can ask Claude in natural language to retrieve the doctrine you need and work with it.
Step 1: Create an Apify Account and Get Your Token
The first thing you need is an Apify account. The free plan provides enough monthly usage credits to run the actor.
Once inside, go to Settings → API & Integrations, click Create new token, and copy it.
Step 2: Download Claude Desktop
Download and install the Claude Desktop app from claude.com/download. This desktop version is the one that allows you to add external MCP connectors.
Step 3: Install the Apify Connector and Paste Your Token
Open Claude Desktop, go to the connector settings, and select Add custom connector. Enter the Apify MCP URL and paste the token you copied in the previous step.
With this you now have access to all LegalTech actors from Claude: legaltech/hacienda, legaltech/cendoj, legaltech/tribunal-constitucional, and many more.
📱 Bonus: Once the connector is set up in your account, you can also use it from the Claude mobile app. The connector is linked to your account, so you can query Hacienda doctrine from any device without any additional configuration.
Step 4: Query Administrative Doctrine from the Chat
Once the connector is configured, open the Claude chat and verify that Apify appears as an available tool.
Now you can ask Claude in natural language to find the doctrine you need. For example:
Use the legaltech/hacienda actor and find DGT binding rulings on the taxation of cryptocurrencies under personal income tax
Use the legaltech/hacienda actor and give me the latest TEAC resolutions on the deductibility of financial expenses
Use the legaltech/hacienda actor and search DYCTEA for criteria on the tax liability of company directors
Claude will run the actor with the criteria you specified, automatically selecting the most appropriate source (DYCTEA, DGT, or TEAC Histórica), and return the results ready for analysis.
Step 5: Analyse the Doctrine from the Chat
Once Claude has the results, you can keep working with them without leaving the conversation. Beyond answering questions, Claude can generate conceptual graphs that connect tax resolutions with each other and link them to related case law, letting you visualise the evolution of a criterion and the relationships between sources at a glance.
Some examples of what you can ask:
Summarise the criterion of each binding ruling in two sentences.
Has the DGT’s position on this matter changed in the last three years?
Identify which of these TEAC resolutions are binding in administrative proceedings.
Generate a table with the reference, date, and main criterion of each resolution.
What recurring arguments do the tribunals use in these cases?
The analysis is a conversation: you refine your questions and Claude responds drawing on the doctrine it retrieved directly from the official Hacienda sources.
💙 Found this guide useful? You can help me keep creating this kind of content by signing up for Starlink through my link: you get €45 in cash or service credit when you sign up. Fast, reliable internet at home and on the road.
How to search ECHR case law (HUDOC) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/tedh connector to Claude or ChatGPT and search judgments and decisions of the European Court of Human Rights in HUDOC: by respondent State, Convention article and violation found, with official headnote, operative part and passages.
How to Search French Administrative Case Law (Conseil d’État, CAA and TA) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/conseil-etat connector to Claude or ChatGPT and search decisions of the Conseil d’État, the administrative courts of appeal and the administrative tribunals: panel, ECLI, Lebon publication status and relevant passages.
How to Search German Federal Court Case Law (BGH, BVerfG, BAG…) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtsinformationen-bund connector to Claude or ChatGPT and search decisions of the BVerfG, BGH, BVerwG, BFH, BAG, BSG and BPatG: headnote, operative part, cited statutes, lower-court decisions and passages with margin numbers.
How to Search Swiss Federal Supreme Court Case Law (BGer / BGE) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/bger connector to Claude or ChatGPT and search judgments of the Swiss Federal Supreme Court (Bundesgericht / Tribunal fédéral) since 2000 and BGE/ATF leading cases since 1954: official Regeste, considerations, operative part and relevant passages.
How to Search Italian Constitutional Court Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/corte-costituzionale connector to Claude or ChatGPT and search over 20,000 judgments and orders of the Corte costituzionale since 1956: official massime, operative part, reporting judge and constitutional articles invoked.
How to Search Portuguese Case Law (DGSI: STJ, Courts of Appeal and STA) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/dgsi connector to Claude or ChatGPT and search rulings of the Supreme Court of Justice, the Supreme Administrative Court, the courts of appeal and the TCAs in the DGSI databases: headnote, descriptors, reporting judge and outcome.
How to Search Danish Case Law (Domsdatabasen) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/domsdatabasen connector to Claude or ChatGPT and search judgments of Højesteret, the high courts and Danish district courts in Domsdatabasen: ECLI, status (final or appealed), amount claimed and the case's path through the instances.
How to Search Swedish Case Law (Högsta domstolen and Rättspraxis) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/domstol-se connector to Claude or ChatGPT and search precedents of Högsta domstolen, the Supreme Administrative Court, the courts of appeal and Swedish specialist courts: NJA reports, keywords, applied statutes by SFS number and relevant passages.
How to Search Finnish Case Law (Finlex: KKO and KHO) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/finlex connector to Claude or ChatGPT and search precedents of the Finnish Supreme Court (KKO), the Supreme Administrative Court (KHO) and Finnish courts on Finlex: ECLI, official keywords, summary and applied provisions.
How to Search Italian Administrative Case Law (Consiglio di Stato and TAR) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/giustizia-amministrativa connector to Claude or ChatGPT and search judgments of the Consiglio di Stato, the Sicilian CGA and the 29 regional TARs: outcome, chamber, reporting judge, operative part (P.Q.M.) and relevant passages.
How to Search Dutch Case Law (Rechtspraak) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtspraak connector to Claude or ChatGPT and search decisions of the Hoge Raad, the Council of State and Dutch courts from Rechtspraak Open Data: ECLI, summary, links between instances and annotations.
How to Search Austrian Case Law (RIS) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/ris-austria connector to Claude or ChatGPT and search decisions of the OGH, VfGH, VwGH, BVwG and Austrian courts in the RIS: legal principles (Rechtssätze), operative part, cited statutes, ECLI and official PDF.
How to Search Portuguese Constitutional Court Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/tribunal-constitucional-pt connector to Claude or ChatGPT and search rulings (acórdãos) of Portugal's Constitutional Court since 1983 by text, chamber, proceeding type, reporting judge and date, with the operative part and full text.
How to Search UK Case Law (Find Case Law) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/find-case-law-uk connector to Claude or ChatGPT and search judgments of the Supreme Court, Court of Appeal, High Court and UK tribunals on The National Archives’ Find Case Law: neutral citation, judges, parties and PDF.
How to Search Brandenburg and Berlin-Brandenburg Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/gerichtsentscheidungen-brandenburg connector to Claude or ChatGPT and search decisions from 31 Brandenburg courts and the joint Berlin-Brandenburg courts: ECLI, operative part, statutes and procedural history.
How to Search Bavarian Case Law (gesetze-bayern.de) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/gesetze-bayern connector to Claude or ChatGPT and search Bavarian court decisions on the official gesetze-bayern.de portal, including by applied statute (e.g. BGB § 536): headnotes, keywords and operative part.
How to Search Belgian Case Law (Juportal) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/juportal connector to Claude or ChatGPT and search decisions of the Court of Cassation, the Constitutional Court, the Council of State and Belgian courts on Juportal: ECLI, case notes, thesaurus and legal bases.
How to Search North Rhine-Westphalia Case Law (NRWE) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/nrwe connector to Claude or ChatGPT and search decisions from every North Rhine-Westphalia court in the official NRWE database: headnotes, operative part, ECLI and lower-court decision, just by asking in plain language.
How to Search Lower Saxony Case Law (NI-VORIS) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtsprechung-niedersachsen connector to Claude or ChatGPT and search some 32,000 Lower Saxony court decisions in NI-VORIS: ECLI, applied statutes, headnote and operative part, just by asking in plain language.
How to Use the Apify MCP with a Local Model (Ollama) to Search CENDOJ Rulings
Learn how to search Spanish CENDOJ rulings in natural language with a language model that runs on your own computer: Ollama, AnythingLLM and the Apify MCP, without sending your conversations or documents to Claude or ChatGPT.
How to Use the Apify MCP in Claude to Find Which Cadastral Parcel You Are In and Look Up Its Data
Learn how to connect the Apify MCP to Claude and use the legaltech/catastro actor to get a parcel's cadastral reference from your coordinates or an address, and look up its official data without going through the Spanish Cadastre website.
How to Use the Apify MCP in Claude to Cross-Reference Spanish Mortgage and Foreclosure Data from the INE
Learn how to connect the Apify MCP to Claude and use the legaltech/ine actor to cross-reference Spain’s Mortgage Statistics and Mortgage Foreclosure Statistics from the INE, and reach the provincial figure no article publishes.
How to Use the Apify MCP in ChatGPT to Access LegalTech Legal Connectors
Learn how to use LegalTech legal connectors from a free ChatGPT account: enable Developer Mode, add the Apify MCP (@Apify), and query Fiscalía, CENDOJ, Hacienda, Property Registry, and more directly from the chat.
How to Use the Apify MCP in Claude to Query Doctrine from the Spanish State Prosecutor Office
Learn how to connect the Apify MCP to Claude and use the legaltech/fiscalia actor to search Circulares, Instrucciones and Consultas from the Spanish State Prosecutor Office directly from the chat, simply by asking in natural language.
How to Use the Apify MCP in Claude to Query Spanish Tax Authority Administrative Doctrine
Learn how to connect the Apify MCP to Claude and use the legaltech/hacienda actor to query TEAC tax administrative doctrine, DGT binding rulings, and historical resolutions directly from the chat.
We use Google Analytics cookies to analyze traffic and improve your experience. You can accept them, reject them, or read our Privacy & Cookies policy. Privacy & Cookies.