MCP API-referentie

Ontdek de 11 MCP-tools van Maguyva, hun parameters en wanneer je ze gebruikt. Controleer het tools/list-antwoord van je verbonden client voor de beschikbare argumenten.

API-overzicht

De tools zijn ingedeeld in 4 categorieën:

Kernzoektools - Geavanceerde zoekmogelijkheden over je codebase
Structurele en graaftools - AST-queries, symbol lookup en dependency-analyse
Codeanalysetools - Diepgaande codeanalyse en relatiemapping
Systeem- en hulptools - Repositorycontext, uitleg over tools en feedback

Gebruik voor tools die een repository accepteren dit repository-identifierformaat: "owner/repo:branch". Zonder opgave is de standaardbranch main.

Laat repository weg wanneer je MCP-client een standaardwaarde voor het verzoek opgeeft of wanneer de sleutel toegang heeft tot precies één repository; geef deze anders expliciet door. Gebruik repository_context(action="info", repository="owner/repo") om te controleren hoe een repository wordt herleid.

Repository-parameterformaat

Gebruik deze notaties als je een repository opgeeft:

Met branch: "owner/repo:branch" - bijv., "owner/repository:develop"
Standaardbranch: "owner/repo" - gebruikt de main-branch wanneer geen branch is opgegeven "owner/repository"
Standaard voor verzoek of enige repository: Laat de repository weg wanneer de MCP-client een standaardwaarde voor het verzoek opgeeft of wanneer de sleutel toegang heeft tot precies één repository; geef deze anders expliciet door

Voorbeeldprompts:

Vraag naar een specifieke opslagplaats:  "Zoek in owner/my-repo naar authenticatie-middleware"
Lijst met toegankelijke repo's:          "Tot welke opslagplaatsen heeft deze Maguyva-sleutel toegang?"
Overschrijven voor één query:            "Zoek in owner/other-repo:develop naar authenticatiepatronen"

Taalfiltering

Gebruik language_filter in ondersteunde zoekmodi. Kies bij text_pattern_search search_scope="content"; gebruik bij get_task_context scope="semantic" zonder startpunten of gerelateerde context.

language_filter="python" - Filter op alleen Python-bestanden
language_filter="typescript" - Filter op alleen TypeScript-bestanden
Hoofdlettergevoelig: Gebruik taalnamen in kleine letters
Standaard: Lege string (geen filtering) - geeft resultaten uit alle talen terug
Ondersteunde dekking: Taalfilters werken over de volledige 285+ ondersteunde talen en tekstgebaseerde technologieën. Zie compatibiliteit voor de volledige lijst.

"Vind authenticatie-middleware alleen in Python-bestanden"
"Zoek naar databaseverbindingen in TypeScript"

API-referentie gegenereerd vanuit de broncode op 21 oktober 2026.

Kernzoektools

intelligent_search Stabiel

Begin hier voor elke vraag over de codebase. Standaard stuurt auto/balanced vragen die met voldoende zekerheid als definitievragen worden herkend naar structureel zoeken, vragen over verwijzingen of impact naar de graaf en vragen om exacte overeenkomsten naar tekstzoeken. Andere vragen gebruiken semantische betekenis en geïndexeerde tekst. Gebruik mode=hybrid of auto met quality=thorough om alle vier de zoekmodaliteiten aan te vragen; een expliciete modus heeft voorrang op quality. language_filter sluit de graaf uit van auto/hybrid en wijst expliciet mode=graph af. Gebruik dit bij voorkeur in plaats van Grep/Glob als je het pad nog niet kent.

Parameters:

query Verplicht

Type: str minLength=1
Beschrijving: Zoekopdracht

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

mode Optioneel

Type: Literal[auto, hybrid, semantic, text, structural, ast, graph]
Standaard: auto
Beschrijving: Zoekmodus

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 10
Beschrijving: Maximumaantal resultaten in dit gerangschikte top-K-venster

language_filter Optioneel

Type: str
Beschrijving: Taalfilter

path_filter Optioneel

Type: str
Beschrijving: Filtert zoekkandidaten op bestandspadvoorvoegsel. Aangrenzende knopen in de graaf en toegevoegde communitycontext kunnen bestanden buiten dit voorvoegsel bevatten.

boost_by_importance Optioneel

Type: bool
Standaard: false
Beschrijving: Opt-in: herrangschikken op centraliteit met symbool-specifieke graafmetrieken (is_articulation_point, bridge_count, k_core, centrality enz.). Standaard uit voor agent-veilige rangschikking (globale hubs kunnen implementatietreffers verdringen); inschakelen voor architectuurrondleidingen. Geldt voor alle 4 modaliteiten wanneer elk resultaat een symboolkoppeling heeft.

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

quality Optioneel

Type: Literal[quick, balanced, thorough]
Standaard: balanced
Beschrijving: Voorinstelling voor zoekkwaliteit

include_content Optioneel

Type: bool
Standaard: true
Beschrijving: Neem inhoud op in de resultaten

explain_routing Optioneel

Type: bool
Standaard: false
Beschrijving: Inclusief uitleg van routeringsbeslissingen

importance_weight Optioneel

Type: float minimum=0, maximum=1
Standaard: 0.3
Beschrijving: Gewicht voor belangrijkheidsverhoging (0=geen, 1=vol)

orphans Optioneel

Type: bool
Standaard: false
Beschrijving: Weessymbolen opnemen (geen inkomende referenties)

include_community_context Optioneel

Type: bool
Standaard: false
Beschrijving: Voeg gerelateerde symbolen uit dezelfde codegemeenschap toe

community_depth Optioneel

Type: int minimum=1, maximum=3
Standaard: 1
Beschrijving: Diepte van de uitbreiding van de gemeenschapscontext

graph_view Optioneel

Type: Literal[dependency, type, data_flow, control_flow]
Standaard: dependency
Beschrijving: Graafweergave voor statistieken

seed_symbol_ids Optioneel

Type: list[str] maxItems=20
Beschrijving: Tier-1-startpunten voor de taak: symbool-ID's die centraal staan in de huidige taak. Indien ingesteld, worden samengevoegde treffers opnieuw gerangschikt volgens Approach A: nabijheid met afnemend gewicht bij grotere diepte (exacte overeenkomst met een startpunt + stappen langs graafverbindingen). Aanvullend — laat weg voor globale rangschikking.

seed_file_paths Optioneel

Type: list[str] maxItems=10
Beschrijving: Tier-1-startpunten voor de taak: geïndexeerde bestandspaden die de agent open heeft staan of zojuist heeft bewerkt. Indien ingesteld, worden samengevoegde treffers opnieuw gerangschikt op padnabijheid, met een gewichtsafname van 1/(1+d) bij grotere diepte (hetzelfde bestand → dezelfde map → nabijgelegen pakketten). Aanvullend — laat weg voor globale rangschikking.

Beste toepassing:

Index-brede verkenning of een koude start wanneer niet duidelijk is welke tool de juiste is
Multimodale rangschikking die semantische, tekstuele, structurele en graafresultaten samenvoegt

Niet aanbevolen voor:

Een bekende symboolnaam — gebruik find_symbol direct
Een bekend pad op schijf — gebruik eerst de lokale Read/Grep

semantic_search Stabiel

Vind code op betekenis, niet op exacte tekst. Gebruik dit voor conceptuele vragen zoals 'logica voor herpogingen' of 'introductieproces voor gebruikers' als je het trefwoord of de symboolnaam niet kent. Geeft relevante fragmenten met begrensde bestandsdiversiteit; herschikken op graafbelang zet je optioneel aan via boost_by_importance. Verkies dit boven Grep voor conceptuele zoekopdrachten.

Parameters:

query Verplicht

Type: str minLength=1
Beschrijving: Zoekopdracht (conceptueel, betekenisgebaseerd)

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 5
Beschrijving: Maximumaantal resultaten in dit gerangschikte top-K-venster

similarity_threshold Optioneel

Type: float minimum=0, maximum=1
Standaard: 0.6
Beschrijving: Minimale gelijkenisscore

language_filter Optioneel

Type: str
Beschrijving: Taalfilter (python, typescript, enz.)

path_filter Optioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

boost_by_importance Optioneel

Type: bool
Standaard: false
Beschrijving: Optioneel: herschikken op genormaliseerd graafbelang per symbool (standaard uit; maximaal 1,5 keer de gelijkenis).

branch Optioneel

Type: str
Beschrijving: Branch overschrijven (standaard: uit de repositoryparameter of main)

include_content Optioneel

Type: bool
Standaard: true
Beschrijving: Voeg chunk-inhoud toe aan de resultaten

graph_view Optioneel

Type: Literal[dependency, type, data_flow, control_flow]
Standaard: dependency
Beschrijving: Graafweergave voor metrieken

Beste toepassing:

Conceptuele zoekopdrachten ("hoe werkt auth?", "caching-strategie")
Gelijkeniszoekopdracht over meerdere packages heen

Niet aanbevolen voor:

Een bekende symboolnaam — gebruik in plaats daarvan find_symbol
Exacte strings of foutmeldingen — gebruik text_pattern_search

text_pattern_search Stabiel

Doorzoek geïndexeerde inhoud. exact en regex gebruiken grep op het volledige bestand-/blobcorpus; fuzzy content doorzoekt het begrensde semantische fragmentcorpus. De bereiken file en symbol gebruiken alleen trigrammen — de standaard mode=exact wordt omgezet naar fuzzy. Instellingen voor taal, hoofdletters en een eigen drempel vereisen het bereik content. Padfilters gebruiken een begrensd kandidatenvenster en melden onvolledige dekking. Gebruik lokale Grep voor een kleine map die al op schijf staat.

Parameters:

query Verplicht

Type: str minLength=1
Beschrijving: Tekstpatroon waarnaar moet worden gezocht

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

mode Optioneel

Type: Literal[fuzzy, exact, regex]
Standaard: exact
Beschrijving: Zoekmodus. Regex voert de geavanceerde/POSIX-syntaxis van PostgreSQL uit; gebruik \y voor woordgrenzen (\b betekent backspace). Patronen doorlopen ook een JavaScript-veiligheidsvalidator, dus PostgreSQL-specifieke constructies zoals inline (?i)-vlaggen worden afgewezen; gebruik in plaats daarvan case_sensitive.

search_scope Optioneel

Type: Literal[content, symbols, files]
Standaard: content
Beschrijving: Wat te zoeken

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 5
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

language_filter Optioneel

Type: str
Beschrijving: Taalfilter

path_filter Optioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

case_sensitive Optioneel

Type: bool
Standaard: false
Beschrijving: Hoofdlettergevoelige matching

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

fuzzy_algorithm Optioneel

Type: Literal[hybrid, trigram, levenshtein]
Standaard: hybrid
Beschrijving: Fuzzy matching-algoritme

threshold Optioneel

Type: float minimum=0, maximum=1
Standaard: 0.05
Beschrijving: Minimale gelijkenisdrempel voor fuzzy

semantic_fallback Optioneel

Type: bool
Standaard: false
Beschrijving: Probeert een semantische zoekopdracht nadat de eerste lexicale pagina leeg was; metadata.fallback_status onderscheidt de fallbackstatussen used, empty en unavailable.

Beste toepassing:

Exacte strings, foutmeldingen en regex
Trigram fuzzy matching voor bijna-overeenkomende tekst

Niet aanbevolen voor:

Een bekend pad op schijf — geef de voorkeur aan lokale Grep
Conceptuele zoekopdrachten — gebruik semantic_search

Structurele en graaftools

structural_search Stabiel

Gebruik bij voorkeur preset=functions|classes|methods|imports|variables (of een vrij pattern=). Zoek code op AST-structuur, niet op tekst. Tussenliggende filters: name_pattern, node_type, decorator, parent_child. Pad-/ltree-/aanroepfilters zijn geavanceerd: stel advanced=true in als je ze bewust gebruikt. Zonder die instelling worden geavanceerde filters toegepast met een waarschuwing in de metadata. Geef minstens één structurele selector op.

Parameters:

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

preset Optioneel

Type: Literal[functions, classes, methods, imports, variables]
Beschrijving: Voorkeurs-structurele selector. Wordt uitgebreid naar taaloverschrijdende AST-knooptypen — functions (functie-/arrow-/methodedefinities in alle talen); classes (class-/struct-/interface-declaraties, typebodies en implementaties); methods (methodedefinities, en function_definition voor talen zonder methodeknoop); imports (import-/use-/include-statements); variables (variable-/let-/const-/static-declaraties). Geef hier de voorkeur aan boven vrij pattern/node_type voor browse-achtige query's.

pattern Optioneel

Type: str
Beschrijving: Een vrije-vorm pattern vult ontbrekende selectors aan (automatisch gedetecteerd: 'def foo(' → node_type + name_pattern). Kan worden gecombineerd met preset; expliciete selectors hebben voorrang. Geef bij browse-query's de voorkeur aan preset=.

name_pattern Optioneel

Type: str maxLength=256
Beschrijving: Symboolnaampatroon (shell-wildcard, begrensde POSIX-regex of fuzzy tekst; max. 256 tekens)

node_type Optioneel

Type: str
Beschrijving: AST-knooptype (function_definition, class_definition enz.) — geef de voorkeur aan preset= voor veelvoorkomende vormen

decorator Optioneel

Type: str
Beschrijving: Decoratornaam-filter

base_class Optioneel

Type: str
Beschrijving: Basisklassefilter

language_filter Optioneel

Type: str
Beschrijving: Taalfilter (python, typescript, enz.)

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 20
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

path_filter Optioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

query_type Optioneel

Type: Literal[node_type, name_pattern, parent_child]
Beschrijving: Expliciet zoektype

parent_type Optioneel

Type: str
Beschrijving: Bovenliggend AST-knooppunttypefilter

relationship Optioneel

Type: Literal[parent, ancestor]
Standaard: parent
Beschrijving: Voor parent_child-query's: alleen de directe parent of een willekeurige ancestor (gebruik ancestor voor klassemethoden die binnen de body/het blok van een klasse zijn genest)

has_modifier Optioneel

Type: str
Beschrijving: Filter op modifier (export, async, static enz.)

advanced Optioneel

Type: bool
Standaard: false
Beschrijving: Stel true in als je bewust geavanceerde pad-/ltree-/aanroepfilters gebruikt (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Bij false worden opgegeven geavanceerde filters toegepast met een waarschuwing in de metadata. Gebruik bij voorkeur preset= voor gangbare structurele zoekopdrachten.

callee_text Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op callee-tekst van een aanroepexpressie. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

callee_name Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op callee-naam van een aanroepexpressie. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

field_role Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op AST-veldrol. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

ltree_ancestor Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op AST-ltree-voorouderpad. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

ltree_descendant Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op AST-ltree-nakomelingenpad. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

definition_name Optioneel

Type: str
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Filter op definitienaam. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

min_depth Optioneel

Type: int
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Minimale AST-diepte. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

max_depth Optioneel

Type: int
Beschrijving: Geavanceerd — geef de voorkeur aan preset=functions|classes|methods|imports|variables. Maximale AST-diepte. Stel advanced=true in wanneer je bewust path-/ltree-/call-filters gebruikt.

Beste toepassing:

Structuur op AST-niveau: classes, decorators, function-/method-presets
Code vinden op vorm in plaats van op tekst

Niet aanbevolen voor:

Vrije tekst of conceptuele zoekopdrachten — gebruik semantic_search of intelligent_search

dependency_search Stabiel

Primaire tool voor impactradius en graafanalyse. Beantwoordt «vanuit welke code wordt dit aangeroepen?» en «welke onderdelen gebruikt dit?» via de echte aanroep-/importgraaf. Voor impact vóór een wijziging: analysis_type="dependents" of analysis_type="impact" (inkomend, standaard beperkte diepte bij impact), standaard include_metrics=false (schakel in voor centraliteit en refactor_risk). dependents/impact bevatten standaard production_callers: unieke gebruikslocaties in productiecode per soort (call, instantiate, value_reference voor functies die als waarden worden doorgegeven), plus IMPORT-locaties, zonder tests en met EXTRACTED/INFERRED-betrouwbaarheid — geen kale verzameling metrieken. PR/diff-impact: geef changed_paths en/of patch (unified diff) mee; zoekt de symbolen per pad en retourneert compacte gegevens over inkomende afhankelijke componenten op beperkte diepte, zonder een symboolnaam te vereisen. Stel na een wijziging verify_after_edit=true in met targets en/of changed_paths voor een compacte nieuwe zoekopdracht vanuit meerdere wortels voor de getroffen symbolen. Ondersteunt ook dependencies, centrality en orphans. analyze_dependencies gebruikt dezelfde graafdoorloop voor impactanalyse over meerdere stappen.

Parameters:

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

query Optioneel

Type: str
Beschrijving: Symboolnaam of zoekterm

target Optioneel

Type: str
Beschrijving: Symboolnaam (alias voor query)

symbol_id Optioneel

Type: UUID
Beschrijving: Selecteer met een UUID een specifieke voorkomenslocatie uit de kandidaten voor de naam in query/target, na filtering op namespace, pad en taal. Gebruik een ID uit find_symbol of de alternatieve graafresultaten. Alleen voor traversals met een opgegeven naam; een ID buiten het begrensde kandidatenvenster veroorzaakt een fout.

changed_paths Optioneel

Type: list[str] maxItems=50
Beschrijving: Exacte paden van bestanden ten opzichte van de reporoot voor PR/diff-impact (standaard) of, met verify_after_edit=true, startpunten voor verificatie na wijzigingen. Niet-opgeloste paden kunnen gelabelde suggesties opleveren; voorgestelde bestanden worden nooit impact-startpunten. PR/diff: zonder regelinformatie doorloopt het de topleveldefinities van elk pad (geëxporteerde eerst, in bestandsvolgorde) en meldt het changed_lines_unknown; geef patch= mee voor symbolen die per regel zijn gewijzigd. Verificatie: maximaal 5 topleveldefinities per pad als startpunten (een lagere limiet geldt binnen de verificatiemodus). Vereist geen query/target voor PR/diff-impact.

patch Optioneel

Type: str maxLength=500000
Beschrijving: PR/diff-impact: unified diff / git-patchtekst. Paden komen uit diff --git / --- / +++ headers; regels uit hunks (oude kant = de geïndexeerde commit) worden gekoppeld aan de omsluitende functies, methoden en klassen, die daarna worden doorlopen voor exacte afhankelijken, public_api_changed en de aanroepers die de diff niet raakt.

head_commit Optioneel

Type: str pattern=^[0-9a-fA-F]{7,64}$
Beschrijving: Commit-SHA van de code waarover je een vraag stelt (git rev-parse HEAD, of de basiscommit van de patch). complete:true vereist dat de index op deze commit staat en door de huidige resolver is gebouwd; anders blijft het complete:false met index_stale / index_freshness_unverified / index_built_by_older_resolver, en index_basis.statement geeft aan binnen welke grenzen het antwoord volledig is. Ook de regel 'base-commit:' van een patch (git format-patch --base) levert deze waarde.

analysis_type Optioneel

Type: Literal[centrality, dependencies, dependents, impact, orphans]
Standaard: dependencies
Beschrijving: Analysemodus. impact = impactradius (inkomende dependents; shallow diepte wanneer depth is weggelaten). dependents beantwoordt ook impact. Wanneer changed_paths of patch is ingesteld, wordt de analyse geforceerd naar PR-/diff-impact. centrality/orphans vereisen geen target. orphans zijn kandidaten voor ongebruikte code, geen bewijs dat verwijderen veilig is; controleer de verwijzingen in de broncode.

depth Optioneel

Type: Literal[shallow, balanced, deep]
Beschrijving: Doorloopdiepte. Standaard balanced; impact en PR/diff impact gebruiken standaard shallow. Een expliciet ingestelde depth overschrijft deze standaardwaarden. De verificatiemodus gebruikt altijd shallow.

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 20
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

path_filter Optioneel

Type: str
Beschrijving: Beperkt de resolutie van het doelsymbool tot een bestandspadprefix; geretourneerde graafrelaties kunnen buiten dat pad reiken

language_filter Optioneel

Type: str
Beschrijving: Filtert doelresolutie en browse-resultaten op taal

direction Optioneel

Type: Literal[outgoing, incoming, both]
Beschrijving: Traversale richting (overschrijft de analysis_type-inferentie)

relationship_types Optioneel

Type: list[str]
Beschrijving: Filtert randtypen (CALL, IMPORT, INHERITS_FROM enz.). Een niet-lege lijst overschrijft de graph_view-standaardwaarden.

exclude_test_paths Optioneel

Type: bool
Standaard: true
Beschrijving: Standaard true: sluit test-, fixture-, vendor- en voorbeeldpaden uit van traversal- en centraliteitsresultaten. Stel false in om ze op te nemen. Orphan-analyse houdt hier alleen rekening mee waar de uitgerolde backend dit ondersteunt; anders houdt ze vast aan haar eigen strengere ruisuitsluitingen en meldt ze de aanpassing.

exclude_generated_paths Optioneel

Type: bool
Standaard: false
Beschrijving: Sluit gegenereerde declaraties en paden naar build-, coverage-, cache-, source-map- en geminificeerde bestanden uit van graafdoorloopresultaten

include_module_symbols Optioneel

Type: bool
Standaard: false
Beschrijving: Standaard false: laat graafverbindingen weg waarvan from_name of to_name het synthetische symbool __module__ is (ruis op moduleniveau). Stel true in om verbindingen op moduleniveau op te nemen in de resultaten van dependents/dependencies.

include_isolated Optioneel

Type: bool
Beschrijving: Alleen voor orphans. Standaard false. Stel true in om ook symbolen zonder rij in de graafmetrieken terug te geven (nergens graafverbindingen). Zolang exclude_test_paths true is, blijven stylesheet-, markup- en datasymbolen (CSS, HTML, ...), .d.ts-declaraties en test/fixture/vendor/example-paden uitgesloten waar de backend dit ondersteunt, tenzij language_filter die taal noemt; eigenschappen van TypeScript-objectliteralen kunnen nog steeds als geïsoleerde functies verschijnen.

exclude_exported Optioneel

Type: bool
Standaard: false
Beschrijving: Alleen voor verweesde symbolen. Standaard false: geëxporteerde symbolen (publieke API) die nergens in de repository worden gebruikt, worden teruggegeven met is_exported=true. Stel true in voor uitsluitend interne kandidaten.

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

per_hop_limit Optioneel

Type: int minimum=1, maximum=300
Beschrijving: Maximumaantal relaties per hop (1-300)

include_metrics Optioneel

Type: bool
Standaard: false
Beschrijving: Optionele graafmetrieken op resultaatregels (gecomprimeerd met refactor_risk). Metrieken worden ook intern opgehaald wanneer min_centrality>0, maar alleen geretourneerd wanneer dit true is.

metrics_detail Optioneel

Type: Literal[summary, full]
Standaard: summary
Beschrijving: Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set

include_edge_metadata Optioneel

Type: bool
Standaard: false
Beschrijving: Neem onbewerkte metadata en gewichten van graafverbindingen op (omvangrijk). Bij compacte impactantwoorden staat dit uit.

symbol_types Optioneel

Type: list[str]
Beschrijving: Filtert geretourneerde symbolen op soort (function, class, method enz.). Niet ondersteund bij orphan-analyse; gebruik daar in plaats daarvan path_filter of language_filter. Een lege lijst past geen filter op soort toe.

exact_match Optioneel

Type: bool
Standaard: false
Beschrijving: Vereisen dat de exacte symboolnaam overeenkomt

find_similar_patterns Optioneel

Type: bool
Standaard: false
Beschrijving: Zoek vergelijkbare gebruikspatronen

min_centrality Optioneel

Type: float minimum=0
Standaard: 0
Beschrijving: Minimale PageRank-score voor het doorlopen van benoemde symbolen en voor PR-/diff-impact. Positieve drempelwaarden worden niet ondersteund in de browse-modi centrality/orphans. Metrieken worden intern opgehaald voor filtering; graph_metrics worden alleen geretourneerd wanneer include_metrics=true. Wordt genegeerd door verify_after_edit, dat vaste compacte instellingen gebruikt.

graph_view Optioneel

Type: Literal[dependency, type, data_flow, control_flow]
Standaard: dependency
Beschrijving: Graafweergave die wordt gebruikt voor traversal-relatiestandaarden, metrieken en centraliteitsrangschikking; orphan-analyse wordt berekend over alle weergaven

verify_after_edit Optioneel

Type: bool
Standaard: false
Beschrijving: Bevraagt de geïndexeerde impactgraaf opnieuw voor bewerkte symbolen in één compact antwoord met meerdere roots. Vereist targets en/of changed_paths (of target/query). Gebruikt een vaste shallow-doorloop en compacte budgetten; de besturingselementen depth/limit/cursor/metrics zijn niet van toepassing. Retourneert standaard incoming dependents; de resultaten weerspiegelen de geïndexeerde graaf (kunnen achterlopen op live bewerkingen). Bij true heeft dit voorrang op PR/diff impact voor dezelfde changed_paths.

targets Optioneel

Type: list[str] maxItems=15
Beschrijving: Wanneer verify_after_edit=true: symboolnamen om opnieuw te controleren (aanroepers/afhankelijke componenten). Samengevoegd met target/query als beide zijn opgegeven.

Beste toepassing:

Impactradius-/impactanalyse vóór het bewerken van een gedeeld symbool
PR-/diff-impact via changed_paths of patch
Verificatie na het bewerken via verify_after_edit

Niet aanbevolen voor:

Eenvoudige tekst- of symboolopzoekingen — gebruik text_pattern_search of find_symbol

Code-analysetools

find_symbol Stabiel

Ga naar de plek waar een functie, klasse of variabele is gedefinieerd en wordt gebruikt. Gebruik dit wanneer je de naam kent (bijv. "getCurrentUser"): sneller en nauwkeuriger dan Grep, over de hele geïndexeerde repository. Retourneert optioneel referenties en belangrijkheidsmetrieken.

Parameters:

symbol_name Optioneel

Type: str
Beschrijving: Symboolnaam waarnaar moet worden gezocht (optioneel – laat weg om op statistieken te bladeren)

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

scope Optioneel

Type: Literal[definitions, references, both]
Standaard: both
Beschrijving: Zoekbereik; references vereist een niet-lege symbol_name.

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 15
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

find_similar Optioneel

Type: bool
Standaard: false
Beschrijving: Voeg vergelijkbare symboolnamen toe

include_metrics Optioneel

Type: bool
Standaard: false
Beschrijving: Neem centraliteitsstatistieken op

metrics_detail Optioneel

Type: Literal[summary, full]
Standaard: summary
Beschrijving: Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set

path_filter Optioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

symbol_type Optioneel

Type: str minLength=1
Beschrijving: Filter op geïndexeerd symbooltype, bijv. function, class, struct, enum of trait. Gebruik het type dat door een symboolresultaat wordt geretourneerd; het type verschilt per taal.

high_impact Optioneel

Type: bool
Standaard: false
Beschrijving: Doorblader architecturaal belangrijke symbolen (laat symbol_name weg). Standaardmodus is popularity (hoogste PageRank-deciel minus utility-megahubs). Stel high_impact_mode=risk in voor articulatie-/bridge-snijpunten.

high_impact_mode Optioneel

Type: Literal[popularity, risk]
Standaard: popularity
Beschrijving: Wanneer high_impact=true: popularity = het hoogste PageRank-deciel zonder megahubs van hulpfuncties en modules; risk = articulatiepunten gerangschikt op SMV bridge_count en daarna k_core (structureel refactorrisico, niet de populariteit van hubs)

in_cycle Optioneel

Type: bool
Standaard: false
Beschrijving: Filtert op symbolen met geregistreerd lidmaatschap van een afhankelijkheidscyclus.

exclude_test_paths Optioneel

Type: bool
Standaard: true
Beschrijving: Wanneer je bladert op graafstatistieken, sluit je tests, fixtures, code van derden en voorbeelden uit voordat je rangschikt. Het opzoeken via een benoemd symbool blijft ongewijzigd.

reference_views Optioneel

Type: list[Literal[dependency, type, data_flow, control_flow, all]] minItems=1, maxItems=5
Beschrijving: Graafweergaven waarvan de inkomende kanten references/reference_count vullen (scope references/both). Standaard ["dependency", "type"]: aanroepen, imports, exports, verwijzingen, instantiaties, overerving, overschrijvingen, decorators en typegebruik. Zonder selectie van data_flow worden exact opgeloste data_flow-gebruiken (callbacks, handlers, sorteersleutels) afzonderlijk teruggegeven als value_references/value_reference_count, zonder overeenkomsten die alleen uit de naam zijn afgeleid. Voeg data_flow of control_flow toe, of geef ["all"] mee voor alle kanttypen en niveaus. Dezelfde weergavefamilies als graph_view van dependency_search.

relationship_types Optioneel

Type: list[str]
Beschrijving: Expliciete typen verwijzingskanten (CALL, IMPORT, READS enz.). Een niet-lege lijst vervangt reference_views.

Beste toepassing:

De definitie, referenties en graafmetrieken van een bekend symbool vastleggen
Bladeren op centrality, high_impact of in_cycle wanneer symbol_name wordt weggelaten

Niet aanbevolen voor:

Conceptuele zoekopdrachten of zoekopdrachten in een onbekend gebied — gebruik intelligent_search of semantic_search

analyze_dependencies Stabiel

Analyseer de impactradius via dezelfde graafdoorloop als dependency_search (dependents/incoming). Gebruik bij voorkeur dependency_search met analysis_type="dependents" of "impact" voor impactanalyse. Geeft een impactantwoord over meerdere stappen met graph, connection_summary en optionele meetwaarden met refactor_risk. connection_summary telt voor de gekozen root de tot de relatiefamilie beperkte randen, vóór enige filtering op tests of paden. De verouderde velden incoming_production/outgoing_production duiden randen buiten modules aan, tests inbegrepen; het zijn geen aantallen productieaanroepers. Gebruik graph_view om de relatietypen te begrenzen: dependency (standaard), type, data_flow, control_flow.

Parameters:

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

target Verplicht

Type: str minLength=1
Beschrijving: Symboolnaam om te analyseren

symbol_id Optioneel

Type: UUID
Beschrijving: Selecteer met een UUID een specifieke voorkomenslocatie uit de target-kandidaten, na filtering op namespace, pad en taal; ID’s buiten het begrensde kandidatenvenster veroorzaken een fout.

depth Optioneel

Type: Literal[shallow, balanced, deep]
Standaard: balanced
Beschrijving: Analysediepte

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 10
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

direction Optioneel

Type: Literal[incoming, outgoing, both]
Standaard: incoming
Beschrijving: Richting van de graafdoorloop

relationship_types Optioneel

Type: list[str]
Beschrijving: Filtert randtypes (CALL, IMPORT, INHERITS_FROM enz.). Een niet-lege lijst overschrijft de standaardwaarden van graph_view; een lege lijst gebruikt die standaardwaarden.

graph_view Optioneel

Type: Literal[dependency, type, data_flow, control_flow]
Standaard: dependency
Beschrijving: Graafweergave: bepaalt zowel de standaard doorlopen randtypes als van welke weergave de metrics worden gebruikt wanneer include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (standaard), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Wordt toegepast als standaardwaarde voor relationship_types wanneer relationship_types wordt weggelaten of leeg is. Komt overeen met de bestaande graph_view-parameternaam van dependency_search, voor consistentie tussen tools.

path_filter Optioneel

Type: str
Beschrijving: Beperkt de resolutie van het doelsymbool tot een bestandspadprefix; geretourneerde graafrelaties kunnen buiten dat pad reiken

language_filter Optioneel

Type: str
Beschrijving: Taalfilter

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

per_hop_limit Optioneel

Type: int minimum=1, maximum=300
Beschrijving: Maximumaantal relaties per hop (1-300)

include_metrics Optioneel

Type: bool
Standaard: false
Beschrijving: Neem graafmetrieken op in de resultaten, elk verrijkt met een afgeleid refactor_risk-blok ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risk is "low" wanneer het symbool in de geselecteerde view geen articulatiepunt is, "medium" wanneer een articulatiepunt weinig randen overbrugt en "high" wanneer het veel randen overbrugt (heuristische drempel, niet empirisch gevalideerd). Voor een symbool wordt dit weggelaten wanneer voor dat symbool en die view geen metriekenrij bestaat.

metrics_detail Optioneel

Type: Literal[summary, full]
Standaard: summary
Beschrijving: Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set

include_edge_metadata Optioneel

Type: bool
Standaard: false
Beschrijving: Voeg onbewerkte metagegevens en gewichten toe. Standaard uitgeschakeld omdat de metagegevens van de extractor groot kunnen zijn; verrijkingsdekking wordt gerapporteerd indien ingeschakeld.

exclude_test_paths Optioneel

Type: bool
Standaard: true
Beschrijving: Standaard true: sluit test-, fixture-, vendor- en voorbeeldpaden uit van de geretourneerde graafverbindingen. Stel false in om ze op te nemen.

include_module_symbols Optioneel

Type: bool
Standaard: false
Beschrijving: Standaard false: laat graafverbindingen weg waarvan from_name of to_name het synthetische symbool __module__ is. Stel true in om verbindingen op moduleniveau op te nemen.

head_commit Optioneel

Type: str pattern=^[0-9a-fA-F]{7,64}$
Beschrijving: Commit-SHA van de code waarover je een vraag stelt (git rev-parse HEAD, of de basiscommit van de patch). complete:true vereist dat de index op deze commit staat en door de huidige resolver is gebouwd; anders blijft het complete:false met index_stale / index_freshness_unverified / index_built_by_older_resolver, en index_basis.statement geeft aan binnen welke grenzen het antwoord volledig is. Ook de regel 'base-commit:' van een patch (git format-patch --base) levert deze waarde.

Beste toepassing:

Impactanalyse over meerdere stappen wanneer je de antwoordvelden graph en connection_summary nodig hebt

Niet aanbevolen voor:

Algemene impactanalyse: gebruik bij voorkeur dependency_search voor flexibele graafdoorloop en controles vanuit meerdere wortels

get_task_context Stabiel

Ga je werken in een onbekend gebied? Beschrijf de taak (bijv. "SSO-ondersteuning toevoegen", "facturatie-webhook repareren") en ontvang in één aanroep een afgebakende bundel van relevante bestanden, code, symbolen en afhankelijkheden. Bestanden die als seed zijn opgegeven, leveren rechtstreeks geïndexeerde inhoud, zelfs als ze geen symbolen definiëren. Mislukte lagen worden gelabeld; bij volledig mislukte retrieval wordt een toolfout geretourneerd. Ga voor meer resultaten verder met de gespecialiseerde zoektool voor die laag.

Parameters:

task_description Verplicht

Type: str minLength=1
Beschrijving: Beschrijving van de taak waarvoor je context nodig hebt

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 15
Beschrijving: Maximaal aantal resultaten per laag

scope Optioneel

Type: Literal[semantic, symbols, dependencies, all]
Standaard: all
Beschrijving: Welke contextlagen moeten worden opgenomen

language_filter Optioneel

Type: str
Beschrijving: Taalfilter: vereist scope=semantic zonder expliciete startpunten of gerelateerde context; indexen van andere lagen kunnen taal niet afdwingen.

path_filter Optioneel

Type: str
Beschrijving: Bestandspadvoorvoegsel voor semantische en trefwoordgebaseerde ophaalstartpunten. Expliciete seeds mogen buiten dit voorvoegsel liggen; de grafcontext kan mapgrenzen overschrijden.

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

include_related_context Optioneel

Type: bool
Standaard: false
Beschrijving: Neem gerelateerde context van aangrenzende symbolen op

seed_symbol_ids Optioneel

Type: list[str] maxItems=20
Beschrijving: Expliciete taakstartpunten: staan als eerste in de symboollaag en blijven behouden binnen het begrensde dependencies/related_context-venster. De graaflagen rangschikken expliciete startpunten en hun naaste omgeving vóór de terugval op trefwoorden; belang geeft alleen de doorslag bij gelijke relevantie. Graafuitbreiding vereist scope=all|dependencies (scope=symbols|semantic voert de afhankelijkheidstraversal nooit uit). Laat weg voor een rangschikking op alleen trefwoorden met diepte-afnemend belang.

seed_file_paths Optioneel

Type: list[str] maxItems=10
Beschrijving: Expliciete seeds: exacte geïndexeerde bestandspaden die de agent open heeft staan of net heeft bewerkt. Levert begrensd direct bestandsbewijs en tot 5 graafseeds per bestand, waarbij exacte overeenkomsten met de taaknaam uit een begrensde symboolzoekopdracht voorrang krijgen op definities en terloopse symbolen. Bestanden zonder symbolen leveren nog steeds bewijs. Ontbrekende bestanden kunnen gelabelde suggesties opleveren die geen seeds zijn. Graafuitbreiding vereist scope=all|dependencies.

Beste toepassing:

Taakbewuste context die seed-bestanden combineert met semantische, symbool- en afhankelijkheidslagen

Niet aanbevolen voor:

Opzoekingen met één tool, waarbij een specifiekere tool de vraag al beantwoordt

get_file Stabiel

Leest een bestand uit de geïndexeerde repository op pad. Geef de voorkeur aan lokale bestandstools voor bestanden op schijf; gebruik dit voor externe geïndexeerde snapshots. Zet begrensde reacties voort met metadata.next_line_start en next_character_start. Verwijder de afsluitende regeleinde plus de [truncated]-markering alleen wanneer metadata.truncated=true; anders kan het letterlijke brontekst zijn.

Parameters:

file_path Verplicht

Type: str
Beschrijving: Bestandspad relatief aan de hoofdmap van de repository

repository Optioneel

Type: str
Beschrijving: Repository als owner/repo[:branch]. Optioneel — laat weg om de standaardwaarde van de client voor dit verzoek (indien opgegeven) of de enige toegankelijke repository te gebruiken; geef alleen expliciet door om een andere geïndexeerde repository te selecteren. Exact geïndexeerde branches hebben de voorkeur; een niet-beschikbare branch kan terugvallen op main of de enige toegankelijke branch. De responsmetadata tonen de aangevraagde en de daadwerkelijk gebruikte identiteit en waarschuwen wanneer dit terugvallen gebeurt.

line_start Optioneel

Type: int minimum=1
Beschrijving: Beginregel (geteld vanaf 1)

line_end Optioneel

Type: int minimum=1
Beschrijving: Eindregel (1-geïndexeerd, inclusief; moet op of na line_start liggen)

character_start Optioneel

Type: int minimum=0
Standaard: 0
Beschrijving: Offset in UTF-16-code-eenheden, alleen binnen de beginregel (0-geïndexeerd). Gebruik metadata.next_character_start om een gedeeltelijk gelezen regel voort te zetten.

branch Optioneel

Type: str
Beschrijving: Branch overschrijven

max_tokens Optioneel

Type: int minimum=1, maximum=50000
Standaard: 5000
Beschrijving: Geschat inhoudsbudget (4 UTF-16-code-eenheden per token; geen exacte tokenizerlimiet).

include_metadata Optioneel

Type: bool
Standaard: true
Beschrijving: Voeg beschrijvende bestandsmetadata toe. Metadata over afkapping en voortzetting worden altijd teruggegeven.

Beste toepassing:

Externe of geïndexeerde bestandssnapshots (regelbereiken, tokenlimieten)

Niet aanbevolen voor:

Een pad dat al op de lokale schijf staat — gebruik de lokale Read-tool

Systeem- en hulptools

repository_context Stabiel

Geeft een lijst van repositories die je kunt doorzoeken, of haalt identiteitsinformatie op voor één repository (namespace/branch, indexed_commit_sha / actualiteit van de index). Gebruik action:"list" wanneer de repository-slug onbekend is; de zoektools accepteren een bekende slug rechtstreeks of gebruiken standaard de enige repository van je key. list gebruikt pattern en paginering; info vereist repository en ondersteunt branch en optioneel include_statistics=true.

Parameters:

action Verplicht

Type: Literal[list, info]
Beschrijving: Actie: beschikbare repo's weergeven met list of repo-informatie ophalen met info

repository Optioneel

Type: str
Beschrijving: Alleen voor info: repository in de vorm owner/repo of owner/repo:branch (vereist voor info)

branch Optioneel

Type: str
Beschrijving: Alleen voor info: branch overschrijven

pattern Optioneel

Type: str
Beschrijving: Alleen voor list: subtekenreeks van de repositorynaam, niet hoofdlettergevoelig

include_statistics Optioneel

Type: bool
Standaard: false
Beschrijving: Alleen informatief: bevat begrensde geïndexeerde-gegevenstellingen. file/blob-tellingen zijn exact; grotere indextellingen zijn schattingen. Zie count_accuracy en estimate_analyzed_at. Standaard false.

limit Optioneel

Type: int minimum=1, maximum=50
Standaard: 20
Beschrijving: Maximumaantal resultaten per pagina zonder cursor. Bij voortzetting wordt de in cursor opgeslagen paginagrootte gebruikt; laat cursor weg om met een andere limit te beginnen.

offset Optioneel

Type: int minimum=0
Beschrijving: Verouderde compatibiliteits-offset. Gebruik bij voorkeur de cursor uit pagination.next_cursor.

cursor Optioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en laat query en filters ongewijzigd. De positie en paginagrootte hiervan hebben voorrang op offset en limit.

Beste toepassing:

Toegankelijke repositories weergeven
Repository-identiteit, branch en HEAD-versus-index-actualiteit bepalen

Niet aanbevolen voor:

Namespace-brede statistieken standaard — geef expliciet include_statistics=true door, aangezien dit trager kan zijn dan resolutie

ask_maguyva Stabiel

Vraag uitleg over Maguyva-tools of verstuur een bugmelding of functieverzoek dat voor de beheerders van Maguyva wordt opgeslagen. Neem nooit geheimen of gevoelige persoonsgegevens op in feedback. De bewerking evaluate ondersteunt deterministische expressies; gebruik bij voorkeur lokale berekeningen of tools van de hostomgeving voor wiskunde, hashes en tekenreeksen.

Parameters:

operation Verplicht

Type: Literal[guidance, report_bug, request_feature, evaluate]
Beschrijving: Gebruik guidance voor toolhulp, report_bug voor bugs of request_feature voor suggesties. evaluate voert deterministische expressies uit; gebruik bij voorkeur lokale rekenmogelijkheden voor berekeningen.

query Optioneel

Type: str maxLength=500
Beschrijving: Onderwerp van de uitleg (bijvoorbeeld tool_selection, semantic_search) of een expressie als tekenreeks voor evaluate.

description Optioneel

Type: str minLength=1, maxLength=4000
Beschrijving: Vereist voor report_bug en request_feature. Free-form feedback voor de beheerders van Maguyva. Neem nooit geheimen of gevoelige persoonsgegevens op.

related_tool Optioneel

Type: Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]
Beschrijving: Optioneel Maguyva hulpmiddel dat het nauwst verband houdt met de feedback

Beste toepassing:

Toolbegeleiding (operation="guidance")
Duurzame bugrapporten en functieverzoeken voor de beheerders van Maguyva

Niet aanbevolen voor:

Berekeningen met wiskunde, hashes of tekenreeksen: gebruik bij voorkeur lokale rekenmogelijkheden of tools van de hostomgeving

Aanbevolen werkwijzen

Gebruik bewust expliciete overschrijvingen: Laat de repository weg wanneer je MCP-client een standaardwaarde voor het verzoek opgeeft of wanneer de sleutel toegang heeft tot precies één repository; geef deze anders expliciet door.
Kies de juiste zoekmodus: Gebruik in de meeste gevallen intelligent_search met mode="auto". Geef een modus op als je precies weet wat je nodig hebt.
Maak gebruik van taalfilters: Gebruik language_filter om de resultaten te verfijnen en de prestaties te verbeteren.
GraphRAG-boost: GraphRAG-belangverhoging staat standaard uit voor semantisch zoeken (boost_by_importance=false), zodat de ranking agent-veilig blijft. Geef boost_by_importance=true door om centraliteitsbewuste herrangschikking in te schakelen voor architectuurverkenningen.
Repositorymatching is niet hoofdlettergevoelig, maar niet fuzzy: repository_context matcht repository-namen hoofdletterongevoelig — het corrigeert geen typefouten. Wanneer de geleverde identiteit afwijkt van de gevraagde, meldt metadata.resolution_reason "defaulted" (er is geen branch gevraagd) of "fallback" (de gevraagde branch of repository is niet beschikbaar). Bij een exacte match blijft het veld weg.
Combineer tools: Gebruik meerdere API-methoden samen voor uitgebreide analyse.
Verwerk grote resultaten: Gebruik limit en de pagineringsopties van de betreffende tool (bijvoorbeeld line_start/line_end in get_file).
Gebruik ask_maguyva voor toolbegeleiding: Roep ask_maguyva aan met operation="guidance" en query="tool_selection" voor advies over toolkeuze en voorbeelden. Gebruik je lokale tools voor berekeningen en tekenreekstransformaties.
Controleer impact voor en na het bewerken: Roep vóór het wijzigen van een gedeeld symbool dependency_search aan met analysis_type="impact" (of geef changed_paths mee voor PR/diff-impact) om de impactradius te zien. Stel na de wijziging verify_after_edit=true in met targets en/of changed_paths voor een compacte hercontrole van de geïndexeerde graaf. Dit leest geen lokale wijzigingen zonder commit en vervangt geen lokale tests. Controleer indexed_commit_sha en de actualiteit van de index voordat je de resultaten als bewijs voor een nieuwe revisie gebruikt.

Prestatiekenmerken

Bewerking	Prestatienotities
Semantisch zoeken	Omvat het genereren van de vectorrepresentatie van de zoekvraag en het ophalen van vectorresultaten. De wachttijd hangt van beide bewerkingen af.
Tekstzoeken	Bij benaderend zoeken in inhoud halen verder gelegen pagina's meer kandidaten op. Beperk de zoekvraag met path_filter en language_filter.
Structureel zoeken	Doorzoekt geïndexeerde AST-knopen. Gebruik een specifieke voorinstelling of patroon en beperk het aantal resultaten.
Dependency-zoeken	Kosten schalen met de diepte — geef de voorkeur aan depth="shallow" tenzij je multi-hop-context nodig hebt; per_hop_limit begrenst de spreiding
Bestandsophaling	Lees het benodigde bereik met line_start/line_end of max_tokens en gebruik de teruggegeven vervolgmetadata bij afgebroken inhoud.
Repositorycontext	Repositoryresolutie wordt bij elke toolaanroep uitgevoerd. Geef repository expliciet mee als je een specifieke repository nodig hebt.
ask_maguyva (guidance / evaluate)	Draait in de MCP-server zonder de repository-index te doorzoeken.

Foutafhandeling

Toolantwoorden bevatten gedeelde statusvelden en toolspecifieke gegevensvelden op het hoogste niveau. Zoekopdrachten geven results terug; get_file geeft content terug. Gedeelde velden zijn:

status: String — "success" of "error". Signalen over afgezwakte matches en actualiteit hebben eigen velden: metadata.resolution_reason onder metadata, en index_freshness.status op het hoogste niveau van de info-actie van repository_context.
timing_ms: Verstreken uitvoeringstijd van de tool in milliseconden
applied_filters: Effectieve aanvraagparameters die voor de bewerking zijn vastgelegd
error: Foutmelding als tekenreeks wanneer status gelijk is aan "error"; kan hersteladvies bevatten.
metadata: Aanvullende informatie over de bewerking (routering, caching, parameteraanpassingen)
pagination: Aanwezig bij antwoorden met collecties die via een cursor worden gepagineerd; bevat has_more en next_cursor. Gerangschikte zoekvensters zijn begrensde top-K-resultaten, geen volledige gepagineerde collecties.

Controleer het veld status voordat je een tool-payload verwerkt — de waarden zijn "success" of "error". Handel ook MCP/JSON-RPC-transport- en request-validatiefouten af; die kunnen optreden voordat er überhaupt een payload is. Lees voor signalen over afgezwakte matches of actualiteit het daarvoor bedoelde veld: metadata.resolution_reason onder metadata, of index_freshness.status op het hoogste niveau van de info-actie van repository_context (known/partial/unknown/unavailable).

Aan de slag

Configureer de MCP-client: Configureer je MCP-client met het servereindpunt van Maguyva
Controleer de toegang tot repositories: Gebruik repository_context met list of info om te bekijken welke repositories beschikbaar zijn voor de API-sleutel
Begin met zoeken: Begin met intelligent_search en verken indien nodig gespecialiseerde tools
Combineer tools: Gebruik meerdere tools samen voor uitgebreide codeanalyse

Zie de installatiehandleiding voor gedetailleerde integratie-instructies.

MCP API-referentie

API-overzicht

Repository-parameterformaat

Taalfiltering

Kernzoektools

intelligent_search Stabiel

semantic_search Stabiel

text_pattern_search Stabiel

Structurele en graaftools

structural_search Stabiel

dependency_search Stabiel

Code-analysetools

find_symbol Stabiel

analyze_dependencies Stabiel

get_task_context Stabiel

get_file Stabiel

Systeem- en hulptools

repository_context Stabiel

ask_maguyva Stabiel

Aanbevolen werkwijzen

Prestatiekenmerken

Foutafhandeling

Aan de slag

Lees verder