GrantCortex/Docs/MCP server
Dokumentáció

GrantCortex MCP server

A GrantCortex az EU-s és nemzeti pályázati életciklus teljes ívét egy tool-réteg mögé rejti, amit az agent már ismer. Csatlakozz a Model Context Protocol-on keresztül, és 10 eszközt kapsz: forráshivatkozott keresés 4 finanszírozási ökoszisztémán, determinisztikus jogosultsági motor, SME-kalkulátor, delta-monitoring és beadási útmutató — egyetlen hosztolt végpontból.

Élő végpont. A szerver a mcp.grantcortex.eu címen él, streamable HTTP-n, teszterenkénti bearer token hitelesítéssel. Nincs telepítés, nincs helyi cache inicializálás.

A szerver túlnyomórészt olvasásra optimalizált: minden tool a napi frissített cache-ből olvas, egyik sem módosítja az adataidat. Az agent írja a prózát — a GrantCortex strukturált adatot, jogosultsági verdikteket és kontextus-eszközöket ad. Minden válasz provenance-adatot hordoz (forrás-URL, lehívás időpontja, konfidencia), így mindegyik visszavezethető egy hivatalos portáloldalra.

Mi van benne#

  • 10 tool — keresés, partnerfelderítés, SME-besorolás, jogosultság, értékelési kritériumok, változásmonitorozás, beadási útmutatók és előkészítési ütemtervek.
  • 2 resource (opcionális) — grantcortex://grants/all és grantcortex://grants/{identifier} közvetlen rekord-hozzáféréshez.
  • 1 prompt (opcionális) — summarise_grant_hu hivatkozott magyar összefoglalóhoz.
  • 4 adatforrás — EU F&T Portal (Horizon Europe · Digital Europe · EDF), CORDIS, Vinnova (SE) és RVO (NL). További öt nemzeti forrás (NKFIH, palyazat.gov.hu, KAP, MTA/HUN-REN, FFG) licenc-felülvizsgálat alatt.

Quickstart#

Válaszd ki a klienst, illeszd be a végpontot és a bearer tokenedet, és az eszközök megjelennek az agent tool-menüjében. Ugyanaz a streamable HTTP végpont minden MCP-kompatibilis kliensnél működik.

1/11Nyisd meg a Settings-et a profil-menüből, majd kattints a Security and login menüpontra.
NameGrantCortex
Server URLhttps://mcp.grantcortex.eu/mcp
AuthenticationOAuth — a consent-oldalon illeszd be a tőlünk kapott API-kulcsot
Fejlesztői módot igényel (Settings → Security and login) és a GrantCortex Pluginként való hozzáadását — a fenti végigvezetés minden kattintást lefed. A csak-olvasó toolok (minden, az admin refresh kivételével) biztonságosan bekapcsolhatók autonóm használatra.

Az első hívás#

Ha bekötötted, kérdezz olyasmit, amit a cache meg tud válaszolni — az agent kiválasztja a megfelelő toolt:

prompt
"Use grantcortex_search_grants to find open Horizon Europe topics about hydrogen,
 max 5 results, and show the deadline + source URL for each."

"Run grantcortex_check_eligibility on HORIZON-CL6-2026-01-CIRCBIO-07
 for a 45-person German SME and surface the verdict note verbatim."
Egy egészséges válasz tartalmazza a pályázati azonosítót, egy provenance.oldest_fetched_at frissességi alsó határt és a kanonikus forrás URL-t. Ha ezeket látod, helyesen vagy bekötve.

Hitelesítés#

Minden kérés bearer tokent visz az Authorization fejlécben. A tester API-kulcs önkiszolgáló: a fiókodban generálod, és csak a létrehozáskor látszik egyszer — tárold secret managerben, ne verziókezelőben.

http
POST https://mcp.grantcortex.eu/mcp
Authorization: Bearer gctx_•••••••••••••••••••
Content-Type: application/json

Tester kulcshoz: regisztrálj a grantcortex.eu/signup címen, erősítsd meg az e-mail-címed, majd a fiókodban (Account) generálhatsz API-kulcsot. A kulcs (gctx_… prefixszel) csak a létrehozáskor látszik egyszer — másold ki azonnal, és tárold secret managerben.

Scope-ok#

ScopeHozzáférés
userMind a 10 csak-olvasó core tool, mindkét resource és a prompt. Ezt kapják a tester-kulcsok.
Rate limitek. Az edge per-IP és per-token korlátot alkalmaz (≈120 / 60 kérés/perc), a /health probe kivételével. Egy burst HTTP 429-et ad vissza egy Retry-After fejléccel — várd ki, ne pumpáld.

Válaszok és provenance#

A legtöbb tool ToolResponse borítékot ad vissza: egy típusos data payload-ot és egy aggregált provenance blokkot. A provenance kötelező — ez teszi a downstream választ audit-védetté.

FieldJelentés
dataA tool típusos eredménye — pályázatok listája, verdikt, útmutató, ütemterv.
provenance.oldest_fetched_atA frissességi alsó határ az összes hozzájáruló rekord között. Kezeld az "as of" dátumként.
provenance.min_confidenceA legalacsonyabb konfidencia a hozzájáruló források között.
provenance.source_urlsAz eredményt alátámasztó hivatalos portáloldalak — hivatkozz ezekre a felhasználó felé.
source_countsgrantcortex_search_grants only — a valódi találatszám backendenként, még akkor is, ha a sorok csonkítottak.
Ha egy rekord hiányzik, a toolok típusos hibát dobnak ahelyett, hogy adatot találnának ki. Egy null pillér vagy egy "unknown" verdikt szándékos szignál, soha nem csendes hallucináció.

Két felület, egy szerver#

A format argumentumot fogadó toolok alapértelmezés szerint strukturált json-t adnak vissza autonóm agenteknek, vagy renderelt markdown-t Claude Desktop-ban olvasó embereknek. Ugyanaz az adat, két alakban — hívásonként választható.

Jogosultsági motor#

grantcortex_check_eligibility determinisztikus szabálymotor — azonos input, azonos output — a topic rögzített kritériumai és az átadott szervezeti profil felett. Négy vödröt értékel és egységes verdiktre aggregál.

  • country — Preferálja a Work-Programme Annex jogosultsági listát; visszaesik az EU-27 + associated-country snapshotra, majd "unknown"-ra.
  • organisation_type — A profilt illeszti a rögzített entitástípus-szabályokhoz.
  • sme_status — A profil company_size mezőjéből számítva.
  • special_conditions — Szabad szöveges szabályok; mindig "unknown" szándékosan, és orthogonálisan az aggregátumhoz.
Jelzőszűrő, nem jogi tanácsadás. A verdikt triázs-szignál. Mindig mutasd meg a response note-ot (a LIMITATIONS_NOTE-ot) verbatim a végfelhasználónak — kötelező döntésként való átfogalmazása kifejezetten tiltott.

Frissesség és korlátok#

A cache naponta egyszer frissül automatikusan (~03:30 UTC) a napi-olcsó forráskészleten. Használd a grantcortex_list_new_grants-t az új kiírások észlelésére (a mezőszintű calls_changed_since diff hamarosan érkezik), és a grantcortex_build_prep_timeline-t a határidőből visszaszámolt tervezéshez.

  • Alapból hibrid, igény szerint tisztán lexikális. A grantcortex_search_grants alapból a kulcsszó-illesztést egy cross-language vektoros rangsorral fuzionálja — egy magyar kérdés angol felhívást is megtalál, a szinonimákkal és fordításokkal együtt. Pontos kulcsszó-egyezéshez add meg a lexical_only: true-t.
  • A többnyelvűség lexical_only módban kikapcsol. A lexical_only: true mellett egy angol kulcsszó kihagyja a magyar nevű pályázatokat és fordítva — hagyd az alapértelmezett hibridet bekapcsolva, vagy próbálj mindkét nyelven.
  • A CORDIS eláraszthat. A 21k+ projektes archívum dominálja a közönséges szavas lekérdezéseket — támaszkodj a source_counts-ra és szűkíts source_system-mel.
  • A lefedettségi hézagok explicitek. Az értékelési kritérium-kinyerés és az Annex-tudatos ország-ellenőrzések dokumentáltan részleges lefedettségűek; a toolok jelzik ezt, nem találnak ki adatot.

Adatforrások#

4 ingesztált ökoszisztéma táplálja a katalógust. A grantcortex_search_grants alapból az EU-szintű forrásokat kérdezi (SEDIA + CORDIS); a nemzeti forrásokat (Vinnova, RVO) a source_system argumentumban nevesítve éred el.

SEsedia
SEDIA · Horizon Europe
EIC · MSCA · ERC · Cluster 1–6
COcordis
CORDIS
Projekt-archívum, FP7 → Horizon Europe
SEvinnova
Vinnova
Svéd innovációs ügynökség
NLrvo
RVO
Holland vállalkozásfejlesztési ügynökség

Az élő cache-ek mellett a GrantCortex egy kurált beadási útmutató tudásbázist szállít (Horizon RIA, EIC Accelerator, Digital Europe, ERC-StG, MSCA, Interreg, NKFIH és palyazat.gov.hu), amelyet a grantcortex_get_submission_guide szolgál ki.

Tools#

10 csak-olvasási core tool a nyilvános launch-felületen. Minden tool deklarálja a read-only / idempotens hinteket ahol alkalmazható, hogy az MCP-kliensek helyes badge-eket mutassanak. Az opcionális argumentumoknak ésszerű alapértelmezésük van.

Elérhető most vs. hamarosan. A nyilvános launch a 10 core toolt szolgálja ki. A coming soon jelölésű toolok (proposal-támogató eszközök, szervezet-kereső és a felhívás-dokumentum eszközök) a publikus roadmapen szerepelnek — lásd a roadmap oldalt.
grantcortex_search_grants()read-only

Kulcsszavas keresés a cache-elt pályázat-katalóguson — 4 élő backend: Horizon/SEDIA (Horizon Europe · Digital Europe · EDF), CORDIS, Vinnova (SE), RVO (NL). Alapból HIBRID: az FTS5 kulcsszó-rangsor (ékezet-érzéketlen, több szavas AND, BM25) egy cross-language vektoros rangsorral fuzionál, így egy magyar kérdés angol felhívást is megtalál; add meg a `lexical_only: true`-t a tiszta, pontos kulcsszó-egyezéshez. Az alapértelmezett scope EU-szintű (SEDIA + CORDIS) — a nemzeti forrásokat (Vinnova, RVO) csak a `source_system`-ben nevesítve keresi.

Paraméterek
NameTypeLeírás
keywordkötelezőstringKeresési kifejezések, vagy egy pontos topic/felhívás-azonosító — az ID-alakú kulcsszó közvetlenül a cache-elt rekordra oldódik fel. Üresen az első találatokat adja vissza a backendek natív sorrendjében.
max_resultsopcionálisint1–100, alapértelmezett 10. Aggregált módban a keretet round-robin osztja el a backendek között.
offsetopcionálisintLapozza a rangsorolt eredményt — add meg a válasz `next_offset`-jét (vagy offset=max_results-t) a következő oldalhoz. A sorrend lapok között stabil. Alapértelmezett 0.
source_systemopcionálisenumSzűkítés egy backendre: sedia · cordis · vinnova · rvo. Elhagyva (alapértelmezés): csak az EU-szintű források (SEDIA + CORDIS) — a nemzeti ügynökségeket, a vinnovát (SE) és az rvo-t (NL) csak itt nevesítve keresi.
lexical_onlyopcionálisboolKikapcsolja az alapértelmezett cross-language vektoros réteget, és tisztán FTS5 kulcsszóval illeszt (pontos, BM25-ranggal). Akkor használd, ha pontos szó szerinti egyezés kell, és a szemantikus fúzió nem kívánt szomszédokat hozna be. A be nem ágyazott Cordis-archívum ettől függetlenül lexikális. Alapértelmezett false.
verbosityopcionálisenumconcise (alapértelmezett): minden sor ~300 karakteres lead-összefoglalót hordoz a related_calls / attribution extrák nélkül — a legolcsóbb átfutáshoz. detailed: a teljes sor (teljes summary, related_calls kereszthivatkozások, attribution-jelzés).
only_openopcionálisboolBackendeken átívelő "jelenleg pályázható" szűrő — csak a még nyitott pályázatokat adja vissza, és teljesen kizárja a Cordis-archívumot (eltér a csak-SEDIA status="open"-től). Alapértelmezett false.
exclude_archiveopcionálisboolCsak a Cordis finanszírozott-projekt archívumot dobja el, minden élő-felhívás backendet megtartva (nyitott és lezárt felhívások). Az only_open ezt magában foglalja. Alapértelmezett false.
programmeopcionálisenumCsak-SEDIA facet: horizon (Pillar 2) · digital_europe · eic (EIC-divízió) · pillar1 („Excellent Science"). Automatikusan SEDIA-ra szűkít; nem-SEDIA source_system mellett hibát dob.
status / deadline_from / deadline_to / min_budget_europcionálisSEDIA filtersNyitott-státusz, határidő-ablak (ÉÉÉÉ-HH-NN), minimum költségvetés. Csak SEDIA.
Visszatérési érték

Kompakt GrantSummary sorok listája, mindegyik kanonikus forrás-portál url-lel, plusz a lapozó-trió: total_count / has_more / next_offset. A source_counts a valódi találatszámot jelenti backendenként — mérvadó akkor is, ha a sorokat a max_results csonkítja.

Az illesztés alapból hibrid (FTS5 kulcsszó + cross-language vektorok) — egy magyar kérdés angol felhívást is megtalál. A pontos kulcsszó-egyezéshez add meg a lexical_only: true-t. Az alap-scope EU-szintű (SEDIA + CORDIS): nemzeti felhíváshoz nevesítsd a source_system: "vinnova" / "rvo"-t, és kérdezz rá egyetlen source_system-re, ha a source_counts csonkított találatokat mutat.
grantcortex_recommend_grants()read-only

Egy céghez illő, jelenleg nyitott pályázatok rangsorolása. Pipeline: kérdés-bővítés → csak-nyitott multi-backend lekérdezés (Cordis-archívum és lezárt felhívások kizárva) → determinisztikus illeszkedés-pontozás → durva jogosultsági előszűrő (a szabálymotort újrahasznosítja, a hard-block bukásokat kidobja) → rangsorolt rövidlista pályázatonkénti fit_score-ral és emberi nyelvű indoklással.

Paraméterek
NameTypeLeírás
profilekötelezőBusinessProfileMind opcionális: keywords, sector, nace_code, company_size, country_id, region_nuts, budget_eur, consortium_role, registry_year. Egy üres profil a megmaradó szignálok szerint rangsorolt nyitott-pályázat korpuszt adja vissza.
max_resultsopcionálisintKorlátozza a rövidlistát. Alapértelmezett 10.
Visszatérési érték

Egy RecommendGrantsResultrecommendations (mindegyik fit_score-ral és emberi nyelvű indoklással), query_terms, eligibility_prefilter_applied, és egy note.

Heurisztikus rangsorolás, nem tanács — mutasd meg a válasz note-ját szó szerint. A mérvadó jogosultság-ellenőrzés az grantcortex_check_eligibility tool.
grantcortex_check_eligibility()read-only

Futtatja a determinisztikus 4-vödrös szabálymotort egy topic rögzített jogosultsági kritériumai plusz a megadott szervezeti profil felett — ország, szervezet-típus, SME-státusz és különleges feltételek — és strukturált verdiktet ad vissza.

Paraméterek
NameTypeLeírás
grant_idkötelezőstringHorizon Europe topic-azonosító.
profilekötelezőOrganisationProfilecountry, organisation type, company_size, és bármilyen különleges-feltétel jelző.
include_criteriaopcionálisboolFalse (alapértelmezett): a válasz a verdiktet hordozza vödrönkénti indoklással és a note-tal — a kérdés megválaszolásához elég. True: emellett minden rögzített jogosultsági kritériumot visszaad a provenance-borítékával (payload-nehéz audit-nézet; csak akkor kérd, ha a nyers kritérium-szöveg kell).
Visszatérési érték

Egy Verdict (decision: pass · fail · unknown), vödrönkénti indoklás bizonyíték-részletekkel, súlyosság (soft_block vs hard_block) és egy fix note, amely a LIMITATIONS_NOTE-ot hordozza.

Jelzőszűrő, nem kötelező érvényű döntés. Mutasd meg a válasz note-ját szó szerint — az ország-vödör egy feldolgozott Work-Programme Annex-et preferál, de visszaesik egy EU-27 + társult-ország pillanatképre, a különleges-feltételek vödör pedig szabad szöveges szabályoknál mindig "unknown".
grantcortex_compute_sme_status()read-only

Egy céget mikro / kis / közép / nagy kategóriába sorol a 2003/361/EK bizottsági ajánlás alapján. A kapcsolt vállalkozásokat 100%-ban, a partner-vállalkozásokat arányosan konszolidálja (a 25%-os küszöb alatt figyelmen kívül hagyva).

Paraméterek
NameTypeLeírás
headcountkötelezőintA fókuszban lévő cég éves munkaegység-létszáma.
annual_turnover_eurkötelezőfloatA fókuszban lévő cég árbevétele EUR-ban.
balance_sheet_total_eurkötelezőfloatA fókuszban lévő cég mérlegfőösszege EUR-ban.
linked_enterprisesopcionálisobject[]Mindegyik: headcount, turnover, balance, ownership_pct. Teljesen konszolidálva.
partner_enterprisesopcionálisobject[]Mindegyik: headcount, turnover, balance, ownership_pct (ez vezérli az arányosítást + a 25%-os küszöböt).
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

category, autonomous jelző, konszolidált headcount / turnover / balance, breach_reasons nagy cég esetén, és computation_notes. Mindig hivatkozik a rendeletre.

grantcortex_list_new_grants()read-only

Delta-monitorozás: az adott időbélyeg óta újonnan indexelt pályázatokat adja vissza. Kiegészíti a calls_changed_since-t — ez az első-látás sorokra fókuszál az utoljára-módosított helyett, így egy könnyű pipeline a teljes katalógus újra-átvizsgálása nélkül is elkapja a vadonatúj lehetőségeket.

Paraméterek
NameTypeLeírás
sincekötelezőint | ISO-8601Napszám (7 = az elmúlt hét) vagy ISO-8601 dátum/időbélyeg, pl. 2026-06-01T00:00:00Z. Csak azokat a sorokat adja vissza, amelyeknek first_seen_at mezője a küszöbbel egyenlő vagy annál későbbi.
sourceopcionálisenumall (alapértelmezett) · topics · vinnova · rvo — a változás-követett források; a többi licenc-felülvizsgálat alatt inaktív.
only_openopcionálisboolEldobja a beadásra már lezárt sorokat. Alapértelmezett true.
region / keyword / min_amount_eur / deadline_within_daysopcionálisfiltersOpcionális szűkítés: durva finanszírozó-régió (EU · HU · V4 · AT · SE · NL · INTL), kulcsszó, minimum támogatás EUR-ban, határidő-ablak napokban.
limit / offsetopcionálisintLapozás. limit 1–200, alapértelmezett 50; a válasz total_count / has_more / next_offset mezőket hordoz.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

{ source, identifier, title, first_seen_at, deadline, is_open, url } alakú sorok — first_seen_at szerint csökkenő sorrendben (legújabb elöl), mindegyik a hivatalos forrásoldalra mutató url-lel. Egy üres lista azt jelenti, hogy semmi sem került be a megadott idő után.

Használd a grantcortex_list_new_grants-t ütemezett pipeline-futásokban (pl. naponta) az újonnan közzétett felhívások hatékony elkapásához. Meglévő felhívások határidő-változásait vagy státusz-frissítéseit a calls_changed_since fedi majd le (hamarosan).
grantcortex_get_evaluation_criteria()read-only

Lekéri a három Horizon Europe értékelési pillért — Excellence, Impact, és Quality & efficiency of the implementation — egy topichoz. Az elsődleges forrás az F&T Portal call-fiche PDF-je, HTML-regex fallbackkel.

Paraméterek
NameTypeLeírás
grant_idkötelezőstringTopic-azonosító. GrantNotFoundError-t dob, ha nincs cache-elve.
Visszatérési érték

EvaluationCriteria excellence_text / impact_text / implementation_text mezőkkel (mindegyik lehet null, ha a forrás nem hozza felszínre), plusz total_max_score / scoring_threshold, ha a PDF tartalmazza őket.

Szándékos none-honesty: egy pillér null, nem kitalált, ha a forrásdokumentum nem mutatja fel felismerhető formában. A call-fiche nélküli fő Horizon clusterek ismert lefedettségi hézagot jelentenek.
grantcortex_find_cordis_partners()read-only

CORDIS által finanszírozott partnerszervezeteket talál elmosódott (fuzzy) cégnév-illesztéssel, az FP7 / H2020 / Horizon Europe résztvételt összesítve. Hasznos konzorcium építéséhez vagy egy leendő partner múltjának átvilágításához.

Paraméterek
NameTypeLeírás
namekötelezőstringSzervezet cégneve. Trigram + substring fuzzy illesztés kezeli az elgépeléseket (fraunhoffer ↔ Fraunhofer).
countryopcionálisISO-3166 a2Szűrés egy országra, pl. DE, NL.
frameworkopcionálisenumFP7 · H2020 · HE.
include_projectsopcionálisboolMély mód — lapozott projektenkénti listát ad hozzá (szerep, topic, EU-hozzájárulás, időszak).
limit / offsetopcionálisintLapozás. limit 1–50, alapértelmezett 20.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

Egy PartnerSummary szervezetenként — összes projekt, összes EU-hozzájárulás (EUR), jelenlévő keretprogramok, aktív évek és reprezentatív topicok. Projektszám, majd finanszírozás szerint rendezve.

grantcortex_get_submission_guide()read-only

Visszaadja egy program kurált "hogyan nyújtsd be" tudásanyagát: beadási portál, pályázat-struktúra (Part A / Part B + oldalkeretek és formátumok), aláírói szerepek (LEAR / LSIGN / FSIGN), gyakori buktatók súlyossággal, és hivatalos sablon-linkek.

Paraméterek
NameTypeLeírás
programmekötelezőstringProgram-kulcs — horizon-ria · eic-accelerator · digital-europe · erc-stg · msca · interreg-europe · nkfih-kfi · palyazat-gov (kis-nagybetű-érzéketlen).
Visszatérési érték

Egy teljes SubmissionGuide. Minden buktató hordoz source_url + fetched_at mezőt; egy elavultság-figyelmeztető note jelenik meg, ha a kurátori felülvizsgálat 180 napnál régebbi — ilyenkor a forrás-URL-eket részesítsd előnyben a cache-elt szöveggel szemben.

grantcortex_build_prep_timeline()read-only

Finanszírozó-tudatos felkészülési ütemtervet épít egy felhíváshoz, a beadási határidőből visszaszámolva — koncepció, draft, megfelelőség és beadás mérföldkövek, plusz forrás-specifikus előfeltételek, mint a PIC/LEAR vagy EPTK-regisztráció.

Paraméterek
NameTypeLeírás
topic_idkötelezőstringHorizon topic-azonosító — további forrás-specifikus profilok aktiválódnak, ahogy a nemzeti források átmennek a licenc-felülvizsgálaton.
todayopcionálisISO dateEgy fix dátumhoz (ÉÉÉÉ-HH-NN) számol determinisztikus tervezéshez. Alapból a szerver UTC-dátumát használja.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

Sorba rendezett mérföldkövek cél-dátumokkal, egy javasolt kezdő dátum, és egy pályázat-státusz (upcoming · in_window · urgent · overdue). no_deadline / not_a_call-t ad vissza, ha a rekordnak nincs határideje, vagy egy post-award projekt.

Heurisztikus becslések, nem hivatalos követelmények — egy tervezési vázlat, nem megfelelőségi checklist.
grantcortex_render_hu_summary_template()read-only

Visszaad egy magyar nyelvű összefoglaló prompt-sablont egy topichoz, előtöltve a cache-elt metaadataival és egy négyelemes hivatkozás-lábléccel. Ugyanaz a törzs, mint a summarise_grant_hu prompt, de toolként kitéve, hogy a Claude Desktop automatikusan felfedezze.

Paraméterek
NameTypeLeírás
grant_idkötelezőstringTopic-azonosító. GrantNotFoundError-t dob, ha nincs cache-elve.
Visszatérési érték

Egy meta-instrukció string (≤200 szavas brief, hivatkozás-lábléc-követelmények, fallback-útmutatás) az ágensnek egy hű magyar összefoglaló megrenderelésére.

Hamarosan

calls_changed_since()coming soon

Delta-monitorozás: az adott időbélyeg után elsőként látott vagy utoljára módosított felhívásokat adja vissza. Mutass rá az utolsó ellenőrzésed idejére, hogy az új lehetőségeket és frissített határidőket a teljes katalógus újra-átvizsgálása nélkül elkapd.

Paraméterek
NameTypeLeírás
sincekötelezőISO-8601pl. 2026-05-19T00:00:00Z. Az ennél újabb sorok kerülnek vissza bármelyik időbélyeg alapján.
sourceopcionálisenumall (alapértelmezett) · topics — további backendek, ahogy a forrásaik átmennek a licenc-felülvizsgálaton.
limitopcionálisint1–200, alapértelmezett 50.
include_diffopcionálisboolMezőszintű diffet (deadline, status, amount…) csatol a frissített sorokhoz, ha van tárolt pillanatkép.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

{ source, identifier, change_type, first_seen_at, last_modified_at } alakú sorok — a change_type new vagy updated; include_diff-fel minden frissített sor hordozza a megváltozott mezőket.

check_proposal_compliance()coming soon

Formális megfelelőségi QA-átfutást végez egy pályázati draft felett. Megbecsüli a karakter- / szószámot és az oldalszámot (~400 szó / A4 oldal), és összeveti a program oldalkeretével. Horizon-családbeli programoknál (horizon-ria, digital-europe, eic-accelerator, erc-stg, msca) a kötelező Part-B fejezetcímeket és a GEP / Open Science / Data-Management-Plan checklistet is ellenőrzi; más programoknál ezek a tartalom-ellenőrzések kimaradnak.

Paraméterek
NameTypeLeírás
proposal_textkötelezőstringA QA-zandó draft-szöveg.
programme_idopcionálisstringpl. horizon-ria — ez vezérli az oldalkeretet és azt, hogy a tartalom-struktúra ellenőrzések lefutnak-e.
check_content_structureopcionálisboolFelülírja a tartalom-ellenőrzéseket. Alapból a programme_id-ból automatikusan derül.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

character_count, word_count, estimated_pages, page_limit, limit_exceeded, chapters[], checklist[], is_compliant, és egy note.

Az is_compliant egy legjobb-erőfeszítés heurisztika, nem hivatalos döntés.
analyze_reviewer_feedback()coming soon

Strukturálja egy Horizon Europe / H2020 Evaluation Summary Report-ot (ESR) újrabeadás-tervezéshez. Az ESR-szöveget te magad emeled ki a (pályázó-bizalmas) PDF-ből — a te oldaladon marad — és `esr_text`-ként adod át.

Paraméterek
NameTypeLeírás
esr_textkötelezőstringAz ESR törzsszövege, amit a PDF-ből kiemeltél. Üres / értelmezhetetlen szöveg hibát dob eredmény-kitalálás helyett.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

Adminisztratív metaadatok (proposal number, acronym, title, call, type of action, topic, duration), a total_score és a három pillérenkénti pontszám, a konzorciumi pályázók táblázata, és pillérenként a nyers értékelői kommentár-blokk plusz heurisztikus erősségek / gyengeségek / javaslatok.

Az átdolgozást a nyers comments-re alapozd — a heurisztikus erősségek / gyengeségek listák csak ötletek.
search_organisations()coming soon

Keresés az F&T Portal / SEDIA szervezeti könyvtárában kulcsszó és/vagy ország szerint. A könyvtár még nincs beolvasva ebbe a telepítésbe, ezért a tool egy rövid "hamarosan" jelzést ad vissza eredmények helyett.

Paraméterek
NameTypeLeírás
keyword / country / limit / offset / formatopcionálisBekötve, de inaktív, amíg a szervezet-szinkron pipeline meg nem érkezik.
Visszatérési érték

Egy "hamarosan" jelzés. Partner-felderítéshez ma használd a grantcortex_search_grants-t (lehetőségek) vagy a grantcortex_find_cordis_partners-t (korábbi résztvevők).

find_consortium_partners()coming soon

Tapasztalt konzorciumi partnerszervezeteket derít fel a cache-elt CORDIS projekt-történelemből, a megnyert összes EU-hozzájárulás szerint rangsorolva. Kiegészíti a grantcortex_find_cordis_partners-t: aszerint keres, amire egy topicnak vagy témának szüksége van, nem egy ismert szervezetnév szerint.

Paraméterek
NameTypeLeírás
topic_idopcionálisstringPontos CORDIS topic-azonosító.
keywordsopcionálisstring[]FTS5 teljes-szöveges keresés a projekt title / acronym / objective mezőin.
countryopcionálisISO-3166 a2Szűkítés egy országra, pl. DE, NL.
limitopcionálisintLapozás. Alapértelmezett 20.
formatopcionálisenumjson (alapértelmezett) vagy markdown.
Visszatérési érték

Egy jelölt szervezetenként — pic, legal_name, country, project_count, total_contribution_eur, coordinator_count, partner_count és associated_projects. A megnyert összes EU-hozzájárulás szerint rangsorolva.

A topic_id vagy a keywords közül legalább az egyik kötelező — egy szűretlen hívás üres listát ad vissza. Felderítő segédeszköz historikus adatokon: a korábbi részvétel nem jelent elérhetőséget — ellenőrizd a szervezetnél.
get_call_document()coming soon

Feloldja, lekéri, feldolgozza, cache-eli és visszaadja egy felhívás-dokumentum teljes szövegét — a munkaprogram call-fiche / topic PDF-jét egy keresési találat mögött. Visszatartva a publikus felülettől, amíg a felhívás-dokumentum korpusz át nem áll egy zöld, újraközölhető forrásra.

Paraméterek
NameTypeLeírás
identifierkötelezőstringPályázat-azonosító, ahogy a grantcortex_search_grants visszaadja (topic id, vagy egy palyazat tender-kód / UUID — a kanonikus kódra feloldva).
sectionopcionálisstringCsak a feldolgozott dokumentum egy megnevezett szakaszát adja vissza.
max_charsopcionálisintKorlátozza a visszaadott szöveg hosszát — a teljes dokumentum nagy lehet.
document_urlopcionálisstringMegkerüli a feloldást, és egy konkrét dokumentum-URL-t kér le.
Visszatérési érték

Egy CallDocumentResult a feldolgozott dokumentum-szöveggel és egy forrás-hivatkozott provenance-blokkal.

search_grant_documents()coming soon

Szemantikus passzus-keresés az indexelt felhívás-dokumentumokon belül: beágyazza a kérdésedet, és cosine-pontszám szerint a legjobban illeszkedő passzusokat adja vissza — megtalálja a releváns bekezdést a teljes fiche elolvasása nélkül. Visszatartva a publikus felülettől, amíg a felhívás-dokumentum korpusz át nem áll egy zöld, újraközölhető forrásra.

Paraméterek
NameTypeLeírás
querykötelezőstringTermészetes nyelvű kérdés vagy kulcsszavak (többnyelvű).
grant_idopcionálisstringA keresést egy felhívásra korlátozza (tender-kód).
limitopcionálisint1–25, pontszám szerint legjobb-elöl.
Visszatérési érték

Egy DocumentPassageSearchResult — rangsorolt passzusok, vagy egy üres lista egy őszinte megjegyzéssel, ha az index üres vagy az embedding modell nem elérhető (ilyenkor használd a get_call_document-et).

Haladó (opcionális)#

A legtöbb MCP-kliens csak a toolokat használja — a legtöbb tesztelőnek ez a szekció nem szükséges. A resource-ok és a prompt haladó primitívek: akkor hasznosak, ha egy rekordot azonosító alapján közvetlenül szeretnél lekérni, vagy a nyers összefoglaló-sablonhoz akarsz hozzáférni. Van tool-megfelelő is (grantcortex_render_hu_summary_template), így ezekre nincs feltétlenül szükség.

Resource-ok

URIMit ad vissza
grantcortex://grants/all
eulex://grants/all elavult — 2026-10-07 után megszűnik
GrantSummary sorok JSON tömbje, azonosító szerint rendezve, 100-nál levágva. Szűkebb szeletekhez használd a grantcortex_search_grants-t.
grantcortex://grants/{identifier}
eulex://grants/{identifier} elavult — 2026-10-07 után megszűnik
Egy topic teljes rekordja — a HorizonTopic payload plusz a Provenance-borítékja (forrás-URL, fetched_at, konfidencia). Prefix-kiegészítést támogat.
A resource-URI séma eulex://-ról grantcortex://-ra változott (brand-egységesítés). A régi eulex:// azonosítók a visszafelé-kompatibilitási ablak alatt még működnek, de 2026-10-07 után megszűnnek — kérjük, frissítsd a grantcortex:// sémára.

Prompts

NameLeírás
summarise_grant_huMagyar ≤200 szavas összefoglaló-sablon egy topichoz, kötelező hivatkozás-lábléccel. A grantcortex_render_hu_summary_template mögötti haladó-felhasználói felület.
A Claude Desktop automatikusan injektálja a toolokat, de a promptokhoz és resource-okhoz + / @ megemlítés szükséges. Ezért a magyar összefoglaló a grantcortex_render_hu_summary_template toolként is elérhető.

Hibák#

A toolok hangosan hibáznak — típusos hibát dobnak félrevezető üres adat visszaadása helyett. Minden hiba üzenete megnevezi az okot.

HibaMikor dobTeendő
GrantNotFoundErrorA grant_id / topic_id nem talál sort a cache-ben.Futtasd újra a grantcortex_search_grants-t az azonosító megerősítéséhez, vagy indíts egy frissítést.
InvalidArgumentErrorEgy argumentum kívül esik az érvényes tartományon, vagy nem kompatibilisen kombinálódik (pl. egy SEDIA-szűrő source_system=cordis mellett).Az üzenet megnevezi a hibás argumentumot és az érvényes halmazt.
ProgrammeNotFoundErrorA grantcortex_get_submission_guide ismeretlen programkulccsal lett meghívva.A hiba felsorolja az összes ismert kulcsot — válassz egyet, és próbáld újra.
PermissionErrorEgy user-scope-ú kulcs (vagy a stdio transport) hívja meg egy csak-adminos toolt.A tester-kulcsok szándékosan user-scope-úak; a napi beolvasás automatikusan lefut, így admin-hívásra nincs szükség.

Megfelelőség és korlátozások#

EU AI Act · limited-risk. A GrantCortex toolok determinisztikus szűrőként működnek, nem jogi döntéshozóként. Az grantcortex_check_eligibility verdikt triázs-szignál — mindig mutasd meg a LIMITATIONS_NOTE-ot a végfelhasználónak szó szerint. Az agent hallgatólagos hallucinációja tiltott: egy null pillér vagy "unknown" verdikt szándékos szignál.

Az összes tool csak forrással hivatkozott választ ad: minden GrantSummary és EvaluationCriteria objektum tartalmaz source_url és fetched_at mezőket. Ha egy rekord nem elérhető, a tool GrantNotFoundError-t dob ahelyett, hogy kitalálna adatot.