MCP server

Server on tavaline HTTP lõpp-punkt: kohalikku programmi ei ole vaja paigaldada. API võti on vabatahtlik, kuid ilma selleta saab kasutada ainult otsinguid ja ettevõtte üldandmeid.

claude mcp add --transport http adre https://adre.ee/mcp

# Võtmega:
claude mcp add --transport http adre https://adre.ee/mcp --header "Authorization: Bearer adre_…"

{
    "mcpServers": {
        "adre": {
            "type": "http",
            "url": "https://adre.ee/mcp",
            "headers": {
                "Authorization": "Bearer adre_…"
            }
        }
    }
}

{
    "mcpServers": {
        "adre": {
            "url": "https://adre.ee/mcp",
            "headers": {
                "Authorization": "Bearer adre_…"
            }
        }
    }
}

https://adre.ee/mcp

Ilma API võtmeta saab kasutada tööriistu search_companies, search_addresses, get_company (viimane annab ainult üldandmed). Ülejäänud vajavad kontoga seotud võtit.

Tärniga (*) argumendid on kohustuslikud. Kirjeldused on ingliskeelsed: neid loeb assistent, mitte lehe lugeja.

MCP tööriist list_companies võtab need filtrid argumendis filters; Business'i nimekirjade koostaja kasutab samu. Tasuta võti kasutab tasuta filtreid ja saab eelvaate — esimesed 5 ettevõtet ja vastete koguarvu —, Business-võti kasutab kõiki filtreid ja saab kuni 50 ettevõtet korraga. Summad on eurodes, protsendid protsentides (20 = 20 %), kuupäevad kujul AAAA-KK-PP.

Business-paketiga seotud võti avab kolm tööriista, mis teevad tööd, mida avalikud lehed ei tee. Seadistus on sama, mis ülal — muutub ainult võti.

• list_companies: lause muutub filtriteks ja filtrid otsinguks. Mudel loeb ainult lauset; otsingu teeb sama determineeritud filter, mida vorm kasutab, ja vastus ütleb alati, milliseid filtreid kasutati — nii saab vale tulemuse parandada ühe filtri võrra ja uuesti küsida. Business'ita võti saab eelvaate: esimesed 5 ettevõtet ja vastete koguarvu.
• area_overview: mis seisab ja mis ehitatakse piirkonnas või raadiuses. Ohutus on alati piirkonna aste, mitte üksikjuhtum.
• get_report: sama PDF, mille annab töölaud, tagastatuna lingina, mis kehtib 24 tundi. Läheb kuu raportite arvestusse.
• Ilma Business-võtmeta vastab server 403-ga ja ütleb, et tegu on paketiga — mitte et võti puudub, sest võti võib täiesti korras olla.

Kümme küsimust, mida tasub proovida

Kirjuta need oma assistendile tavalise jutuna; tööriistad valib ta ise.

1. Kontrolli enne lepingut ettevõtet 10234957: juhatus, omanikud, maksuvõlg, kohtuasjad.
2. Leia kõik ettevõtted, kellel on sama omanik mis Telia Eesti AS-il.
3. Mis ehitatakse 500 m raadiuses aadressist EE00634037?
4. Koosta taustakontroll ettevõttest 10256137 PDF-ina.
5. Harjumaa ehitusettevõtted käibega üle miljoni, kellel ei ole maksuvõlga.
6. Võrdle ettevõtteid 10234957 ja 10256137 koos tegevusala mediaaniga.
7. Millised ettevõtted on registreeritud aadressil Mulla tn 4, Tallinn?
8. Kes on Tallinna suurimad tööandjad ja mis tegevusaladel?
9. Jälgi ettevõtet 10234957 ja anna teada juhatuse või omaniku muutusest.
10. Näita Tartu maakonna IT-ettevõtteid, kes on oma Adre lehe üle võtnud.

Võti on sama kujuga nagu iga teine Adre API võti; paketi otsustab konto, mitte võti. Adre Business →

Iga tööriist vastab kolmes osas, et vastust saaks nii lugeda kui ka edasi töödelda:

1. lõik lausetega, mille lõpus on selle lehe aadress, kust arvud pärinevad;
2. samad andmed JSON-ina;
3. sama JSON structuredContent väljal, kui klient seda toetab.

JSON-i sees on alati sources: iga andmestiku nimi, avaldaja, litsents ja kuupäev, mil Adre seda viimati luges. Palume vastuses nimetada Adre ja lisada lehe link — nii jõuab lugeja allikani.

• adre://sources The public registers behind every figure on Adre: publisher, how often they publish, the licence, and the day Adre last read each one.
• adre://llms.txt What Adre is, its URL patterns, the machine-readable surfaces, the data sources and their cadence, the method pages and the re-use terms — the long form, with the content rules and the FAQ inlined.
• adre://method/{slug} How Adre computes what it publishes, as markdown: "top" for the rankings (formulas, thresholds, what each list counts) and "ohutus" for the registered-offence bands (windows, normalisation, cut-offs and the limits of the data).

Valmisküsimused

• background_check (company) Check an Estonian company before dealing with it: what it is, how it trades, who is behind it and what the registers flag.
• home_report (address) What the registers know about one Estonian address: the building, its permits, the area's prices and what is nearby.
• industry_overview (emtak, county) The leading companies of one activity or one county in Estonia, from the stored rankings.

Võtme saab kontolt. Võtit näidatakse ainult üks kord, seega salvesta see kohe; kaotatud võtme asemel tuleb teha uus.

Minu konto → · JSON API dokumentatsioon

• Kõik andmed pärinevad avalikest registritest. Iga vastus nimetab allika ja kuupäeva.
• Eraisikust on teada ainult nimi ja sünniaasta ning seosed ettevõtetega. Aadresse ega isikukoode ei ole andmestikus olemas.
• Kinnisvara omanikke ei avaldata. Kinnistusraamat ei ole selle portaali allikas.
• Maksevõime hinnang on reeglipõhine statistiline hinnang, mitte krediidiotsus.
• Ohutuse andmed on piirkonna astmed võrreldes sarnaste piirkondadega, mitte juhtumid aadressi juures.

Andmestikud ja allikad →