MCP API-referentie

Volledige referentie voor alle 11 klantgerichte MCP-tools van Maguyva. Elke tool bevat parameters, gebruiksrichtlijnen en aanbevelingen voor de beste toepassing.

API-overzicht#

De Maguyva MCP API biedt momenteel 11 klantgerichte tools in 4 hoofdcategorieë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, deterministische berekeningen en begeleiding

Alle tools gebruiken een consistent repository-identifierformaat: "owner/repo:branch". De branch valt terug op main als deze niet is opgegeven.

Laat repository weg wanneer uw 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#

Alle MCP-tools gebruiken dit repository-identifierformaat:

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 verificatiepatronen"

Taalfiltering#

Alle zoektools ondersteunen het filteren van resultaten op programmeertaal:

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 279+ 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 22 juli 2026.

Kernzoektools#

intelligent_searchStabiel

Begin hier voor elke vraag over de codebase. Geef een zoekopdracht in natuurlijke taal (bijv. "hoe werkt auth", "waar wordt facturering afgehandeld") en de tool routeert deze automatisch naar semantisch, symbool-, structureel en afhankelijkheidsonderzoek in de geïndexeerde repository. Geef hier voor verkenning en planning de voorkeur aan boven de Explore-agent en Grep/Glob: de hele geïndexeerde repository wordt in één keer doorzocht in plaats van bestand voor bestand gescand.

Parameters:

queryVerplicht

Type: str
Beschrijving: Zoekopdracht

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

modeOptioneel

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

limitOptioneel

Type: int
Standaard: 10
Beschrijving: Maximumaantal resultaten in dit gerangschikte top-K-venster

language_filterOptioneel

Type: str
Beschrijving: Taalfilter

path_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

boost_by_importanceOptioneel

Type: bool
Standaard
Beschrijving: Opt-in: herrangschikken op centraliteit met symbool-specifieke grafiekmetrieken (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.

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

qualityOptioneel

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

include_contentOptioneel

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

explain_routingOptioneel

Type: bool
Standaard
Beschrijving: Inclusief uitleg van routeringsbeslissingen

importance_weightOptioneel

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

orphansOptioneel

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

include_community_contextOptioneel

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

community_depthOptioneel

Type: int
Standaard: 1
Beschrijving: Diepte van de uitbreiding van de gemeenschapscontext

graph_viewOptioneel

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

seed_symbol_idsOptioneel

Type: list[str]
Beschrijving: Tier-1 taakzaden: symbool-ID's die centraal staan in de huidige taak. Indien ingesteld, worden gefuseerde treffers opnieuw gerangschikt op basis van Approach A diepte-verval-nabijheid (exacte zaadmatch + grafiekrand-hops). Additief — weglaten voor mondiale ranking.

seed_file_pathsOptioneel

Type: list[str]
Beschrijving: Tier-1 taakzaden: geïndexeerde bestandspaden die de agent heeft geopend of zojuist heeft bewerkt. Indien ingesteld, worden gefuseerde treffers opnieuw gerangschikt op padnabijheid met 1/(1+d) diepteverval (hetzelfde bestand → dezelfde map → pakketten in de buurt). Additief — weglaten voor mondiale ranking.

Parameter	Type	Verplicht	Standaard	Beschrijving
`query`	`str`	Ja	-	Zoekopdracht
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`mode`	`Literal[auto, hybrid, semantic, text, structural, ast, graph]`	Nee	`auto`	Zoekmodus
`limit`	`int`	Nee	`10`	Maximumaantal resultaten in dit gerangschikte top-K-venster
`language_filter`	`str`	Nee	-	Taalfilter
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`boost_by_importance`	`bool`	Nee		Opt-in: herrangschikken op centraliteit met symbool-specifieke grafiekmetrieken (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`	`str`	Nee	-	Tak overschrijven
`quality`	`Literal[quick, balanced, thorough]`	Nee	`balanced`	Voorinstelling voor zoekkwaliteit
`include_content`	`bool`	Nee	`true`	Neem inhoud op in de resultaten
`explain_routing`	`bool`	Nee		Inclusief uitleg van routeringsbeslissingen
`importance_weight`	`float`	Nee	`0.3`	Gewicht voor belangrijkheidsverhoging (0=geen, 1=vol)
`orphans`	`bool`	Nee		Weessymbolen opnemen (geen inkomende referenties)
`include_community_context`	`bool`	Nee		Voeg gerelateerde symbolen uit dezelfde codegemeenschap toe
`community_depth`	`int`	Nee	`1`	Diepte van de uitbreiding van de gemeenschapscontext
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nee	`dependency`	Grafiekweergave voor statistieken
`seed_symbol_ids`	`list[str]`	Nee	-	Tier-1 taakzaden: symbool-ID's die centraal staan in de huidige taak. Indien ingesteld, worden gefuseerde treffers opnieuw gerangschikt op basis van Approach A diepte-verval-nabijheid (exacte zaadmatch + grafiekrand-hops). Additief — weglaten voor mondiale ranking.
`seed_file_paths`	`list[str]`	Nee	-	Tier-1 taakzaden: geïndexeerde bestandspaden die de agent heeft geopend of zojuist heeft bewerkt. Indien ingesteld, worden gefuseerde treffers opnieuw gerangschikt op padnabijheid met 1/(1+d) diepteverval (hetzelfde bestand → dezelfde map → pakketten in de buurt). Additief — weglaten voor mondiale ranking.

Beste toepassing:

Index-brede verkenning of een koude start wanneer niet duidelijk is welke tool de juiste is
Multimodale samengevoegde rangschikking over semantisch, tekstueel, structureel en grafiek

Niet aanbevolen voor:

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

semantic_searchStabiel

Vind code op betekenis, niet op exacte tekst. Gebruik dit voor conceptuele zoekopdrachten zoals "retry-logica" of "onboardingflow voor gebruikers" wanneer u het trefwoord of de symboolnaam niet kent. Retourneert de relevantste codefragmenten, gerangschikt op belangrijkheid. Geef voor conceptuele zoekopdrachten hier de voorkeur aan boven Grep.

Parameters:

queryVerplicht

Type: str
Beschrijving: Zoekopdracht (conceptueel, betekenisgebaseerd)

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

limitOptioneel

Type: int
Standaard: 5
Beschrijving: Maximumaantal resultaten in dit gerangschikte top-K-venster

similarity_thresholdOptioneel

Type: float
Standaard: 0.6
Beschrijving: Minimale gelijkenisscore

language_filterOptioneel

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

path_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

boost_by_importanceOptioneel

Type: bool
Standaard
Beschrijving: Opt-in: herrangschikken op PageRank-centraliteit (standaard uit voor agent-veilige rangschikking; inschakelen voor architectuurrondleidingen)

branchOptioneel

Type: str
Beschrijving: Vertakking overschrijven (standaard: vanuit repositoryparameter of hoofd)

include_contentOptioneel

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

graph_viewOptioneel

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

Parameter	Type	Verplicht	Standaard	Beschrijving
`query`	`str`	Ja	-	Zoekopdracht (conceptueel, betekenisgebaseerd)
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`limit`	`int`	Nee	`5`	Maximumaantal resultaten in dit gerangschikte top-K-venster
`similarity_threshold`	`float`	Nee	`0.6`	Minimale gelijkenisscore
`language_filter`	`str`	Nee	-	Taalfilter (python, typescript, enz.)
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`boost_by_importance`	`bool`	Nee		Opt-in: herrangschikken op PageRank-centraliteit (standaard uit voor agent-veilige rangschikking; inschakelen voor architectuurrondleidingen)
`branch`	`str`	Nee	-	Vertakking overschrijven (standaard: vanuit repositoryparameter of hoofd)
`include_content`	`bool`	Nee	`true`	Voeg chunk-inhoud toe aan de resultaten
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nee	`dependency`	Grafiekweergave 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_searchStabiel

Doorzoek geïndexeerde inhoud. De modi exact en regex doorzoeken met grep het volledige bestands-/blobcorpus; de modus fuzzy content doorzoekt het begrensde corpus met semantische fragmenten. De scopes file en symbol ondersteunen alleen fuzzy zoeken. Gebruik lokale Grep voor een beperkte map die al op schijf staat.

Parameters:

queryVerplicht

Type: str
Beschrijving: Tekstpatroon waarnaar moet worden gezocht

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

modeOptioneel

Type: Literal[fuzzy, exact, regex]
Standaard: exact
Beschrijving: Zoekmodus

search_scopeOptioneel

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

limitOptioneel

Type: int
Standaard: 5
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

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

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.

language_filterOptioneel

Type: str
Beschrijving: Taalfilter

path_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

case_sensitiveOptioneel

Type: bool
Standaard
Beschrijving: Hoofdlettergevoelige matching

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

fuzzy_algorithmOptioneel

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

thresholdOptioneel

Type: float
Standaard: 0.05
Beschrijving: Minimale gelijkenisdrempel voor fuzzy

semantic_fallbackOptioneel

Type: bool
Standaard
Beschrijving: Val terug op semantisch zoeken als er geen resultaten zijn

Parameter	Type	Verplicht	Standaard	Beschrijving
`query`	`str`	Ja	-	Tekstpatroon waarnaar moet worden gezocht
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`mode`	`Literal[fuzzy, exact, regex]`	Nee	`exact`	Zoekmodus
`search_scope`	`Literal[content, symbols, files]`	Nee	`content`	Wat te zoeken
`limit`	`int`	Nee	`5`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.
`language_filter`	`str`	Nee	-	Taalfilter
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`case_sensitive`	`bool`	Nee		Hoofdlettergevoelige matching
`branch`	`str`	Nee	-	Tak overschrijven
`fuzzy_algorithm`	`Literal[hybrid, trigram, levenshtein]`	Nee	`hybrid`	Fuzzy matching-algoritme
`threshold`	`float`	Nee	`0.05`	Minimale gelijkenisdrempel voor fuzzy
`semantic_fallback`	`bool`	Nee		Val terug op semantisch zoeken als er geen resultaten zijn

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_searchStabiel

Geef de voorkeur aan preset=functions|classes|methods|imports|variables (of vrij pattern=). Vindt code op basis van AST-vorm (niet tekst). Filters van middenniveau: name_pattern, node_type, decorator, parent_child. Path-/ltree-/call-filters zijn geavanceerd — stel advanced=true in wanneer u ze bewust gebruikt; platte advanced-sleutels blijven om compatibiliteitsredenen ondersteund. Geef ten minste één structurele selector op.

Parameters:

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

presetOptioneel

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-/impl-definities); 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.

patternOptioneel

Type: str
Beschrijving: Free-form patroon wanneer presets te grof zijn (automatisch gedetecteerd: 'def foo(' → node_type + name_pattern). Geef de voorkeur aan preset= voor browse-query's.

name_patternOptioneel

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

node_typeOptioneel

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

decoratorOptioneel

Type: str
Beschrijving: Decoratornaam-filter

base_classOptioneel

Type: str
Beschrijving: Basisklassefilter

language_filterOptioneel

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

limitOptioneel

Type: int
Standaard: 20
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

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

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.

path_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

query_typeOptioneel

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

parent_typeOptioneel

Type: str
Beschrijving: Bovenliggend AST-knooppunttypefilter

relationshipOptioneel

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_modifierOptioneel

Type: str
Beschrijving: Filter op modifier (exporteren, async, statisch, etc.)

advancedOptioneel

Type: bool
Standaard
Beschrijving: Stel true in als u opzettelijk geavanceerde pad-, ltree- of oproepfilters gebruikt (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Standaard houdt false de agentinterface gericht op voorinstellingen. Geavanceerde sleutels in het platte formaat werken nog steeds voor achterwaartse compatibiliteit, met een metadatawaarschuwing.

callee_textOptioneel

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 u bewust path-/ltree-/call-filters gebruikt.

callee_nameOptioneel

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 u bewust path-/ltree-/call-filters gebruikt.

field_roleOptioneel

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

ltree_ancestorOptioneel

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

ltree_descendantOptioneel

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

definition_nameOptioneel

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

min_depthOptioneel

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

max_depthOptioneel

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

Parameter	Type	Verplicht	Standaard	Beschrijving
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`preset`	`Literal[functions, classes, methods, imports, variables]`	Nee	-	Voorkeurs-structurele selector. Wordt uitgebreid naar taaloverschrijdende AST-knooptypen — functions (functie-/arrow-/methodedefinities in alle talen); classes (class-/struct-/impl-definities); 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`	`str`	Nee	-	Free-form patroon wanneer presets te grof zijn (automatisch gedetecteerd: 'def foo(' → node_type + name_pattern). Geef de voorkeur aan preset= voor browse-query's.
`name_pattern`	`str`	Nee	-	Symboolnaampatroon (shell-wildcard, begrensde POSIX-regex of fuzzy tekst; max. 256 tekens)
`node_type`	`str`	Nee	-	AST-knooptype (function_definition, class_definition enz.) — geef de voorkeur aan preset= voor veelvoorkomende vormen
`decorator`	`str`	Nee	-	Decoratornaam-filter
`base_class`	`str`	Nee	-	Basisklassefilter
`language_filter`	`str`	Nee	-	Taalfilter (python, typescript, enz.)
`limit`	`int`	Nee	`20`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`branch`	`str`	Nee	-	Tak overschrijven
`query_type`	`Literal[node_type, name_pattern, parent_child]`	Nee	-	Expliciet zoektype
`parent_type`	`str`	Nee	-	Bovenliggend AST-knooppunttypefilter
`relationship`	`Literal[parent, ancestor]`	Nee	`parent`	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`	`str`	Nee	-	Filter op modifier (exporteren, async, statisch, etc.)
`advanced`	`bool`	Nee		Stel true in als u opzettelijk geavanceerde pad-, ltree- of oproepfilters gebruikt (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Standaard houdt false de agentinterface gericht op voorinstellingen. Geavanceerde sleutels in het platte formaat werken nog steeds voor achterwaartse compatibiliteit, met een metadatawaarschuwing.
`callee_text`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op callee-tekst van een aanroepexpressie. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`callee_name`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op callee-naam van een aanroepexpressie. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`field_role`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op AST-veldrol. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`ltree_ancestor`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op AST-ltree-voorouderpad. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`ltree_descendant`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op AST-ltree-nakomelingenpad. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`definition_name`	`str`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Filter op definitienaam. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`min_depth`	`int`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Minimale AST-diepte. Stel advanced=true in wanneer u bewust path-/ltree-/call-filters gebruikt.
`max_depth`	`int`	Nee	-	Geavanceerd — geef de voorkeur aan preset=functions\|classes\|methods\|imports\|variables. Maximale AST-diepte. Stel advanced=true in wanneer u 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_searchStabiel

Primair hulpmiddel voor impactradius/grafiek. Beantwoordt "wat roept dit aan?" / "wat gebruikt dit?" via de echte aanroep-/importgrafiek. Voor impact vóór het bewerken: analysis_type="dependents" of analysis_type="impact" (inkomend, standaard shallow voor impact), include_metrics=false standaard (optioneel in te schakelen voor centrality + refactor_risk). PR-/diff-impact (P1-8): geef changed_paths en/of patch (unified diff) door — lost symbolen per pad op en retourneert een compacte, ondiep-inkomende dependents-payload zonder dat een symboolnaam nodig is. Stel na een bewerking verify_after_edit=true in met targets en/of changed_paths voor een compacte multi-root herbevraging van getroffen symbolen. Ondersteunt ook dependencies, centrality en orphans. analyze_dependencies is een dunne alias voor het impact-pad — geef voor nieuwe agents de voorkeur aan deze tool.

Parameters:

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

queryOptioneel

Type: str
Beschrijving: Symboolnaam of zoekterm

targetOptioneel

Type: str
Beschrijving: Symboolnaam (alias voor query)

changed_pathsOptioneel

Type: list[str]
Beschrijving: Repo-relatieve paden voor PR/diff-impact (standaard) of, met verify_after_edit=true, verificatie van wortels na bewerking. PR/diff: lost symbolen per pad op en loopt door ondiepe inkomende afhankelijke personen; kan gecombineerd worden met patch=. Verifiëren: lost maximaal 5 symbolen per pad op als verificatiewortels (lager afgedekt in de verificatiemodus). Vereist geen query/target voor PR/diff-impact.

patchOptioneel

Type: str
Beschrijving: PR/diff-impact: uniforme diff / git-patchtekst. Paden worden ontleed vanuit diff --git / --- / +++ headers; hetzelfde compacte impactpad als changed_paths.

analysis_typeOptioneel

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.

depthOptioneel

Type: Literal[shallow, balanced, deep]
Standaard: balanced
Beschrijving: Traversaldiepte. Voor analysis_type=impact en PR-/diff-impact is de effectieve standaardwaarde shallow, tenzij u depth expliciet instelt.

limitOptioneel

Type: int
Standaard: 20
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

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

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.

path_filterOptioneel

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

language_filterOptioneel

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

directionOptioneel

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

relationship_typesOptioneel

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

exclude_test_pathsOptioneel

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 past altijd zijn eigen strengere ruisuitsluitingen toe.

exclude_generated_pathsOptioneel

Type: bool
Standaard
Beschrijving: Sluit gegenereerde declaraties plus build, dekking, cache, bronkaart en verkleinde artefactpaden uit van traversal-resultaten

include_module_symbolsOptioneel

Type: bool
Standaard
Beschrijving: Standaard sluit false grafiekranden uit wanneer from_name of to_name het synthetische __module__ symbool is (ruis op moduleniveau). Stel true in om randen op moduleniveau op te nemen in resultaten voor afhankelijke en afhankelijkheidsrelaties.

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

per_hop_limitOptioneel

Type: int
Beschrijving: Maximumaantal relaties per hop (1-300)

include_metricsOptioneel

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

metrics_detailOptioneel

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_metadataOptioneel

Type: bool
Standaard
Beschrijving: Voeg onbewerkte metagegevens en gewichten toe (groot). Compacte impactladingen laten dit uit.

symbol_typesOptioneel

Type: list[str]
Beschrijving: Filtert geretourneerde symbolen op type (function, class, method enz.)

exact_matchOptioneel

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

find_similar_patternsOptioneel

Type: bool
Standaard
Beschrijving: Zoek vergelijkbare gebruikspatronen

min_centralityOptioneel

Type: float
Standaard: 0
Beschrijving: Minimale PageRank-score. Metrieken worden intern opgehaald voor filtering; graph_metrics worden alleen geretourneerd wanneer include_metrics=true.

graph_viewOptioneel

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

verify_after_editOptioneel

Type: bool
Standaard
Beschrijving: P2-7 verificatiemodus na bewerking: bevraag de geïndexeerde impactgrafiek opnieuw voor recent bewerkte symbolen in één compact antwoord met meerdere wortels. Vereist targets en/of changed_paths (of target/query). Standaard ingesteld op oppervlakkige inkomende afhankelijke personen; de resultaten weerspiegelen de geïndexeerde grafiek (kan bij live bewerkingen achterblijven). Indien waar, heeft dit voorrang op de PR/diff-impact op dezelfde changed_paths.

targetsOptioneel

Type: list[str]
Beschrijving: Wanneer verify_after_edit=true: symboolnamen die opnieuw moeten worden geverifieerd (bellers/afhankelijke personen). Samengevoegd met target/query als beide worden geleverd.

Parameter	Type	Verplicht	Standaard	Beschrijving
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`query`	`str`	Nee	-	Symboolnaam of zoekterm
`target`	`str`	Nee	-	Symboolnaam (alias voor query)
`changed_paths`	`list[str]`	Nee	-	Repo-relatieve paden voor PR/diff-impact (standaard) of, met verify_after_edit=true, verificatie van wortels na bewerking. PR/diff: lost symbolen per pad op en loopt door ondiepe inkomende afhankelijke personen; kan gecombineerd worden met patch=. Verifiëren: lost maximaal 5 symbolen per pad op als verificatiewortels (lager afgedekt in de verificatiemodus). Vereist geen query/target voor PR/diff-impact.
`patch`	`str`	Nee	-	PR/diff-impact: uniforme diff / git-patchtekst. Paden worden ontleed vanuit diff --git / --- / +++ headers; hetzelfde compacte impactpad als changed_paths.
`analysis_type`	`Literal[centrality, dependencies, dependents, impact, orphans]`	Nee	`dependencies`	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.
`depth`	`Literal[shallow, balanced, deep]`	Nee	`balanced`	Traversaldiepte. Voor analysis_type=impact en PR-/diff-impact is de effectieve standaardwaarde shallow, tenzij u depth expliciet instelt.
`limit`	`int`	Nee	`20`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.
`path_filter`	`str`	Nee	-	Beperkt de resolutie van het doelsymbool tot een bestandspadprefix; geretourneerde grafiekrelaties kunnen buiten dat pad reiken
`language_filter`	`str`	Nee	-	Filtert doelresolutie en browse-resultaten op taal
`direction`	`Literal[outgoing, incoming, both]`	Nee	-	Traversale richting (overschrijft de analysis_type-inferentie)
`relationship_types`	`list[str]`	Nee	-	Filtert randtypen (CALL, IMPORT, INHERITS_FROM enz.). Een niet-lege lijst overschrijft de graph_view-standaardwaarden.
`exclude_test_paths`	`bool`	Nee	`true`	Standaard true: sluit test-, fixture-, vendor- en voorbeeldpaden uit van traversal- en centraliteitsresultaten. Stel false in om ze op te nemen. Orphan-analyse past altijd zijn eigen strengere ruisuitsluitingen toe.
`exclude_generated_paths`	`bool`	Nee		Sluit gegenereerde declaraties plus build, dekking, cache, bronkaart en verkleinde artefactpaden uit van traversal-resultaten
`include_module_symbols`	`bool`	Nee		Standaard sluit false grafiekranden uit wanneer from_name of to_name het synthetische __module__ symbool is (ruis op moduleniveau). Stel true in om randen op moduleniveau op te nemen in resultaten voor afhankelijke en afhankelijkheidsrelaties.
`branch`	`str`	Nee	-	Tak overschrijven
`per_hop_limit`	`int`	Nee	-	Maximumaantal relaties per hop (1-300)
`include_metrics`	`bool`	Nee		Optionele grafiekmetrieken op resultaatregels (gecomprimeerd met refactor_risk). Metrieken worden ook intern opgehaald wanneer min_centrality>0, maar alleen geretourneerd wanneer dit true is.
`metrics_detail`	`Literal[summary, full]`	Nee	`summary`	Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set
`include_edge_metadata`	`bool`	Nee		Voeg onbewerkte metagegevens en gewichten toe (groot). Compacte impactladingen laten dit uit.
`symbol_types`	`list[str]`	Nee	-	Filtert geretourneerde symbolen op type (function, class, method enz.)
`exact_match`	`bool`	Nee		Vereisen dat de exacte symboolnaam overeenkomt
`find_similar_patterns`	`bool`	Nee		Zoek vergelijkbare gebruikspatronen
`min_centrality`	`float`	Nee	`0`	Minimale PageRank-score. Metrieken worden intern opgehaald voor filtering; graph_metrics worden alleen geretourneerd wanneer include_metrics=true.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nee	`dependency`	Grafiekweergave die wordt gebruikt voor traversal-relatiestandaarden, metrieken en centraliteitsrangschikking; orphan-analyse wordt berekend over alle weergaven
`verify_after_edit`	`bool`	Nee		P2-7 verificatiemodus na bewerking: bevraag de geïndexeerde impactgrafiek opnieuw voor recent bewerkte symbolen in één compact antwoord met meerdere wortels. Vereist targets en/of changed_paths (of target/query). Standaard ingesteld op oppervlakkige inkomende afhankelijke personen; de resultaten weerspiegelen de geïndexeerde grafiek (kan bij live bewerkingen achterblijven). Indien waar, heeft dit voorrang op de PR/diff-impact op dezelfde changed_paths.
`targets`	`list[str]`	Nee	-	Wanneer verify_after_edit=true: symboolnamen die opnieuw moeten worden geverifieerd (bellers/afhankelijke personen). Samengevoegd met target/query als beide worden geleverd.

Beste toepassing:

Blast-radius-/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_symbolStabiel

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

Parameters:

symbol_nameOptioneel

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

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

scopeOptioneel

Type: Literal[definitions, references, both]
Standaard: both
Beschrijving: Zoekbereik

limitOptioneel

Type: int
Standaard: 15
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

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

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.

find_similarOptioneel

Type: bool
Standaard
Beschrijving: Voeg vergelijkbare symboolnamen toe

include_metricsOptioneel

Type: bool
Standaard
Beschrijving: Neem centraliteitsstatistieken op

metrics_detailOptioneel

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_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

symbol_typeOptioneel

Type: Literal[function, class, variable, method, constant, module, interface, type]
Beschrijving: Filter op symbooltype

high_impactOptioneel

Type: bool
Standaard
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_modeOptioneel

Type: Literal[popularity, risk]
Standaard: popularity
Beschrijving: Wanneer high_impact=true: populariteit = top PageRank deciel minus mega-hubs/modules voor nutsvoorzieningen; risico = articulatiepunten gerangschikt op basis van SMV bridge_count en vervolgens k_core (structureel refactorrisico, niet populariteit van de hub)

in_cycleOptioneel

Type: bool
Standaard
Beschrijving: Filter op symbolen in afhankelijkheidscycli

exclude_test_pathsOptioneel

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

Parameter	Type	Verplicht	Standaard	Beschrijving
`symbol_name`	`str`	Nee	-	Symboolnaam waarnaar moet worden gezocht (optioneel – laat weg om op statistieken te bladeren)
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`scope`	`Literal[definitions, references, both]`	Nee	`both`	Zoekbereik
`limit`	`int`	Nee	`15`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.
`find_similar`	`bool`	Nee		Voeg vergelijkbare symboolnamen toe
`include_metrics`	`bool`	Nee		Neem centraliteitsstatistieken op
`metrics_detail`	`Literal[summary, full]`	Nee	`summary`	Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`branch`	`str`	Nee	-	Tak overschrijven
`symbol_type`	`Literal[function, class, variable, method, constant, module, interface, type]`	Nee	-	Filter op symbooltype
`high_impact`	`bool`	Nee		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`	`Literal[popularity, risk]`	Nee	`popularity`	Wanneer high_impact=true: populariteit = top PageRank deciel minus mega-hubs/modules voor nutsvoorzieningen; risico = articulatiepunten gerangschikt op basis van SMV bridge_count en vervolgens k_core (structureel refactorrisico, niet populariteit van de hub)
`in_cycle`	`bool`	Nee		Filter op symbolen in afhankelijkheidscycli
`exclude_test_paths`	`bool`	Nee	`true`	Wanneer u bladert op grafiekstatistieken, sluit u tests, fixtures, code van derden en voorbeelden uit voordat u rangschikt. Het opzoeken via een benoemd symbool blijft ongewijzigd.

Beste toepassing:

De definitie, referenties en grafiekmetrieken 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_dependenciesStabiel

Alias voor impactradius via dependency_search (dependents/incoming). Geef voor nieuwe agents de voorkeur aan dependency_search met analysis_type="dependents" of "impact". Behoudt de oude multi-hop impact-responsvorm (graph, connection_summary, optionele metrieken met refactor_risk). Gebruik graph_view om de relatiefamilie af te bakenen: dependency (standaard), type, data_flow, control_flow.

Parameters:

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

targetVerplicht

Type: str
Beschrijving: Symboolnaam om te analyseren

depthOptioneel

Type: Literal[shallow, balanced, deep]
Standaard: balanced
Beschrijving: Analyse diepte

limitOptioneel

Type: int
Standaard: 10
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

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

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.

directionOptioneel

Type: Literal[incoming, outgoing, both]
Standaard: incoming
Beschrijving: Traversale richting

relationship_typesOptioneel

Type: list[str]
Beschrijving: Filterrandtypen (CALL, IMPORT, INHERITS_FROM, enz.). Overschrijft altijd de van graph_view afgeleide standaard hieronder, indien aanwezig.

graph_viewOptioneel

Type: Literal[dependency, type, data_flow, control_flow]
Standaard: dependency
Beschrijving: Grafiekview: bepaalt zowel de standaardtypen traversal-edges als de metrieken van de view 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]. Dit geldt alleen als standaard voor relationship_types wanneer relationship_types niet expliciet is opgegeven. De parameternaam graph_view komt overeen met die van dependency_search, voor consistentie tussen tools.

path_filterOptioneel

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

language_filterOptioneel

Type: str
Beschrijving: Taalfilter

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

per_hop_limitOptioneel

Type: int
Beschrijving: Maximumaantal relaties per hop (1-300)

include_metricsOptioneel

Type: bool
Standaard
Beschrijving: Neem grafiekmetrieken 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_detailOptioneel

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_metadataOptioneel

Type: bool
Standaard
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_pathsOptioneel

Type: bool
Standaard: true
Beschrijving: Standaard true: sluit test-, armatuur-, leveranciers- en voorbeeldpaden uit van geretourneerde grafiekranden. Stel false in om ze op te nemen.

include_module_symbolsOptioneel

Type: bool
Standaard
Beschrijving: Standaard sluit false grafiekranden uit wanneer from_name of to_name het synthetische __module__ symbool is. Stel true in om randen op moduleniveau op te nemen.

Parameter	Type	Verplicht	Standaard	Beschrijving
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`target`	`str`	Ja	-	Symboolnaam om te analyseren
`depth`	`Literal[shallow, balanced, deep]`	Nee	`balanced`	Analyse diepte
`limit`	`int`	Nee	`10`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteits-offset. Geef de voorkeur aan cursor uit pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtige cursor uit pagination.next_cursor. Geef deze ongewijzigd door en houd query en filters ongewijzigd.
`direction`	`Literal[incoming, outgoing, both]`	Nee	`incoming`	Traversale richting
`relationship_types`	`list[str]`	Nee	-	Filterrandtypen (CALL, IMPORT, INHERITS_FROM, enz.). Overschrijft altijd de van graph_view afgeleide standaard hieronder, indien aanwezig.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nee	`dependency`	Grafiekview: bepaalt zowel de standaardtypen traversal-edges als de metrieken van de view 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]. Dit geldt alleen als standaard voor relationship_types wanneer relationship_types niet expliciet is opgegeven. De parameternaam graph_view komt overeen met die van dependency_search, voor consistentie tussen tools.
`path_filter`	`str`	Nee	-	Beperkt de resolutie van het doelsymbool tot een bestandspadprefix; geretourneerde grafiekrelaties kunnen buiten dat pad reiken
`language_filter`	`str`	Nee	-	Taalfilter
`branch`	`str`	Nee	-	Tak overschrijven
`per_hop_limit`	`int`	Nee	-	Maximumaantal relaties per hop (1-300)
`include_metrics`	`bool`	Nee		Neem grafiekmetrieken 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`	`Literal[summary, full]`	Nee	`summary`	Wanneer include_metrics=true: summary (standaard) retourneert beslissingssignalen + refactor_risk; full retourneert de grotere samengestelde metrische set
`include_edge_metadata`	`bool`	Nee		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`	`bool`	Nee	`true`	Standaard true: sluit test-, armatuur-, leveranciers- en voorbeeldpaden uit van geretourneerde grafiekranden. Stel false in om ze op te nemen.
`include_module_symbols`	`bool`	Nee		Standaard sluit false grafiekranden uit wanneer from_name of to_name het synthetische __module__ symbool is. Stel true in om randen op moduleniveau op te nemen.

Beste toepassing:

Legacy-aanroepers die al zijn afgestemd op de responsvorm ervan (graph, connection_summary)

Niet aanbevolen voor:

Nieuwe agent-loops — geef de voorkeur aan dependency_search, dat dezelfde traversal-kern deelt

get_task_contextStabiel

Begint u aan werk in een onbekend gebied? Beschrijf de taak (bijv. "voeg SSO-ondersteuning toe", "repareer de factureringswebhook") en ontvang in één begrensde aanroep een bundel relevante bestanden, code, symbolen en afhankelijkheden. Seed-bestanden leveren directe geïndexeerde inhoud, zelfs als ze geen symbolen definiëren. Ga voor meer resultaten verder met het gespecialiseerde zoekhulpmiddel voor die laag.

Parameters:

task_descriptionVerplicht

Type: str
Beschrijving: Beschrijving van de taak waarvoor u context nodig heeft

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

limitOptioneel

Type: int
Standaard: 15
Beschrijving: Maximaal aantal resultaten per laag

scopeOptioneel

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

language_filterOptioneel

Type: str
Beschrijving: Taalfilter

path_filterOptioneel

Type: str
Beschrijving: Filter op bestandspadvoorvoegsel

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

include_related_contextOptioneel

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

seed_symbol_idsOptioneel

Type: list[str]
Beschrijving: Expliciete zaden van niveau 1: symbool-ID's waarvan de agent al weet dat ze centraal staan in de taak (bijvoorbeeld symbolen in bestanden die hij heeft geopend). Gerangschikt vóór trefwoord-afgeleide zaden in de afhankelijkheden/related_context-lagen. Additief — weglaten voor het huidige gedrag met alleen zoekwoorden.

seed_file_pathsOptioneel

Type: list[str]
Beschrijving: Tier-1 expliciete seeds: geïndexeerde bestandspaden die de agent open heeft staan of net heeft bewerkt. Levert begrensd direct bestandsbewijs en lost tot 5 symbolen per bestand op voor grafiekcontext, inclusief symboolvrije documentatie en configuratie. Additief — weglaten voor alleen-trefwoordgedrag.

Parameter	Type	Verplicht	Standaard	Beschrijving
`task_description`	`str`	Ja	-	Beschrijving van de taak waarvoor u context nodig heeft
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`limit`	`int`	Nee	`15`	Maximaal aantal resultaten per laag
`scope`	`Literal[semantic, symbols, dependencies, all]`	Nee	`all`	Welke contextlagen moeten worden opgenomen
`language_filter`	`str`	Nee	-	Taalfilter
`path_filter`	`str`	Nee	-	Filter op bestandspadvoorvoegsel
`branch`	`str`	Nee	-	Tak overschrijven
`include_related_context`	`bool`	Nee		Neem gerelateerde context van aangrenzende symbolen op
`seed_symbol_ids`	`list[str]`	Nee	-	Expliciete zaden van niveau 1: symbool-ID's waarvan de agent al weet dat ze centraal staan in de taak (bijvoorbeeld symbolen in bestanden die hij heeft geopend). Gerangschikt vóór trefwoord-afgeleide zaden in de afhankelijkheden/related_context-lagen. Additief — weglaten voor het huidige gedrag met alleen zoekwoorden.
`seed_file_paths`	`list[str]`	Nee	-	Tier-1 expliciete seeds: geïndexeerde bestandspaden die de agent open heeft staan of net heeft bewerkt. Levert begrensd direct bestandsbewijs en lost tot 5 symbolen per bestand op voor grafiekcontext, inclusief symboolvrije documentatie en configuratie. Additief — weglaten voor alleen-trefwoordgedrag.

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_fileStabiel

Leest een bestand uit de geïndexeerde repository op pad. Geef voor bestanden op schijf de voorkeur aan de lokale Read-tool — gebruik dit voor repository-overschrijdende of externe opzoekingen wanneer het bestand niet in uw werkboom staat. Ondersteunt een optioneel regelbereik; zet een door tokens afgekapte respons voort vanaf metadata.next_line_start.

Parameters:

file_pathVerplicht

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

repositoryOptioneel

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. Het antwoord toont welke repository is gebruikt.

line_startOptioneel

Type: int
Beschrijving: Startlijn (1-geïndexeerd)

line_endOptioneel

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

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

max_tokensOptioneel

Type: int
Standaard: 5000
Beschrijving: Maximaal tokens om terug te geven

include_metadataOptioneel

Type: bool
Standaard: true
Beschrijving: Voeg als reactie bestandsmetagegevens toe

Parameter	Type	Verplicht	Standaard	Beschrijving
`file_path`	`str`	Ja	-	Bestandspad relatief aan de hoofdmap van de repository
`repository`	`str`	Nee	-	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. Het antwoord toont welke repository is gebruikt.
`line_start`	`int`	Nee	-	Startlijn (1-geïndexeerd)
`line_end`	`int`	Nee	-	Eindregel (1-geïndexeerd, inclusief; moet op of na line_start liggen)
`branch`	`str`	Nee	-	Tak overschrijven
`max_tokens`	`int`	Nee	`5000`	Maximaal tokens om terug te geven
`include_metadata`	`bool`	Nee	`true`	Voeg als reactie bestandsmetagegevens toe

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_contextStabiel

Toont de repositories waarin u kunt zoeken, of haalt identiteitsinformatie over één repository op (namespace/branch, indexed_commit_sha / index-actualiteit). Roep eenmaal action:"list" aan om de exacte repo-slug te achterhalen die de zoekhulpmiddelen accepteren. (Als uw sleutel toegang heeft tot slechts één repository, gebruiken de zoekhulpmiddelen die standaard — dan kunt u dit overslaan.) Namespace-brede bestands-/blob-/edge-aantallen zijn optioneel via include_statistics=true.

Parameters:

actionVerplicht

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

repositoryOptioneel

Type: str
Beschrijving: Repository in de notatie owner/repo of owner/repo:branch (vereist voor info)

branchOptioneel

Type: str
Beschrijving: Tak overschrijven

patternOptioneel

Type: str
Beschrijving: Filter de lijst met opslagplaatsen op patroon

include_statisticsOptioneel

Type: bool
Standaard
Beschrijving: Opt-in: neemt namespace-brede aantallen geïndexeerde gegevens op (bestand/blob/edge). Standaard false — repository-identiteit vereist dit langzamere aggregaat niet.

limitOptioneel

Type: int
Standaard: 20
Beschrijving: Maximumaantal resultaten dat op deze pagina wordt geretourneerd

offsetOptioneel

Type: int
Beschrijving: Verouderde compatibiliteitscompensatie. Geef de voorkeur aan cursor boven pagination.next_cursor.

cursorOptioneel

Type: str
Beschrijving: Ondoorzichtig cursor vanaf pagination.next_cursor. Geef het ongewijzigd door en laat de query en filters ongewijzigd.

Parameter	Type	Verplicht	Standaard	Beschrijving
`action`	`Literal[list, info]`	Ja	-	Actie: beschikbare repo's weergeven met list of repo-informatie ophalen met info
`repository`	`str`	Nee	-	Repository in de notatie owner/repo of owner/repo:branch (vereist voor info)
`branch`	`str`	Nee	-	Tak overschrijven
`pattern`	`str`	Nee	-	Filter de lijst met opslagplaatsen op patroon
`include_statistics`	`bool`	Nee		Opt-in: neemt namespace-brede aantallen geïndexeerde gegevens op (bestand/blob/edge). Standaard false — repository-identiteit vereist dit langzamere aggregaat niet.
`limit`	`int`	Nee	`20`	Maximumaantal resultaten dat op deze pagina wordt geretourneerd
`offset`	`int`	Nee	-	Verouderde compatibiliteitscompensatie. Geef de voorkeur aan cursor boven pagination.next_cursor.
`cursor`	`str`	Nee	-	Ondoorzichtig cursor vanaf pagination.next_cursor. Geef het ongewijzigd door en laat de query en filters ongewijzigd.

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_maguyvaStabiel

Hulp en feedback voor Maguyva. Primair: werkhulpmiddelbegeleiding krijgen, of een bugrapport / functieverzoek indienen dat wordt opgeslagen voor de beheerders van Maguyva. Neem nooit geheimen of gevoelige persoonsgegevens op in feedback. De evaluate-bewerking blijft alleen voor achterwaartse compatibiliteit — geef de voorkeur aan lokale berekening of hosthulpmiddelen voor reken-/hash-/tekstwerk.

Parameters:

operationVerplicht

Type: Literal[guidance, report_bug, request_feature, evaluate]
Beschrijving: Primair: guidance, report_bug, request_feature. Alleen legacy/compatibiliteit: evaluate (deterministische expressie-engine; geen onderdeel van de primaire agentworkflow).

queryOptioneel

Type: str
Beschrijving: Begeleidingsonderwerp (bijv. tool_selection, semantic_search). Alleen voor legacy evaluate: expressiestring.

descriptionOptioneel

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

related_toolOptioneel

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

Parameter	Type	Verplicht	Standaard	Beschrijving
`operation`	`Literal[guidance, report_bug, request_feature, evaluate]`	Ja	-	Primair: guidance, report_bug, request_feature. Alleen legacy/compatibiliteit: evaluate (deterministische expressie-engine; geen onderdeel van de primaire agentworkflow).
`query`	`str`	Nee	-	Begeleidingsonderwerp (bijv. tool_selection, semantic_search). Alleen voor legacy evaluate: expressiestring.
`description`	`str`	Nee	-	Vereist voor report_bug en request_feature. Free-form feedback voor de beheerders van Maguyva. Neem nooit geheimen of gevoelige persoonsgegevens op.
`related_tool`	`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]`	Nee	-	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:

Reken-/hash-/tekstbewerkingen — de evaluate-bewerking is alleen legacy/back-compat; geef de voorkeur aan lokale hostberekening

Aanbevolen werkwijzen#

Gebruik bewust expliciete overschrijvingen: Laat de repository weg wanneer uw 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 u precies weet wat u nodig heeft.
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 repositorynamen ongeacht hoofdlettergebruik — het corrigeert geen typefouten. Controleer metadata.resolution_reason bij de info-actie ("exact" versus "corrected") om te zien hoe een naam is herleid.
Combineer hulpmiddelen: Gebruik meerdere API-methoden samen voor uitgebreide analyse.
Verwerk grote resultaten: Gebruik limit en toolspecifieke pagingbesturingselementen (bijvoorbeeld line_start/line_end in get_file).
Gebruik ask_maguyva voor toolbegeleiding: De evaluate-operatie van ask_maguyva (hash, base64, JSON, wiskunde) is uitsluitend legacy / voor achterwaartse compatibiliteit. Roep in plaats daarvan ask_maguyva aan met operation="guidance" en query="tool_selection" voor de local-tool-wins-matrix en een volledig tool-per-tool spiekbriefje.
Controleer impact voor en na het bewerken: Roep vóór het bewerken van een gedeeld symbool dependency_search aan met analysis_type="impact" (of geef changed_paths door voor PR-/diff-impact) om de impactradius te zien. Stel na het bewerken verify_after_edit=true in met targets en/of changed_paths voor een compacte hercontrole van dezelfde symbolen.

Prestatiekenmerken#

Bewerking	Prestatienotities
Semantisch zoeken	Subseconde, maar bevat elke keer een live embedding-API-aanroep (niet gecachet) — reken op extra latency bovenop de vectorquery
Tekstzoeken	Subseconde voor exact/regex; fuzzy-volltekstzoeken pagineert clientzijdig, dus diepe offsets kosten meer — verfijn met path_filter/language_filter
Structureel zoeken	AST-geïndexeerd — kosten schalen met de resultaatomvang, niet met de repositorygrootte
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	Bijna direct voor één bestand — pagineer grote bestanden met line_start/line_end of max_tokens in plaats van één grote pull
Repositorycontext	Namespace-resolutie wordt alleen per verzoek gecachet, niet tussen aanroepen — elke tool-aanroep lost opnieuw op
ask_maguyva (guidance / evaluate)	Bijna direct — draait in-Worker zonder databaseaanroep

Foutafhandeling#

Alle API-methoden geven een gestructureerde envelope terug:

status: String — "success" of "error". Signalen voor verminderde matches of actualiteit staan in geneste velden zoals metadata.resolution_reason bij repository_context of metadata.index_freshness.status.
tool: Naam van de tool die de respons genereerde
data: Resultaatpayload bij succes (structuur varieert per tool)
error: Gestructureerd foutobject wanneer status gelijk is aan "error" — bevat type, message, suggestions en recovery_actions
metadata: Aanvullende informatie over de bewerking (routering, caching, parameteraanpassingen)
pagination: Aanwezig bij lijstresponses — bevat has_more en next_cursor

Controleer altijd het status-veld voordat je resultaten verwerkt — het is uitsluitend "success" of "error". Lees voor signalen over verminderde matches of actualiteit in plaats daarvan het geneste veld: metadata.resolution_reason bij repository_context, of metadata.index_freshness.status (known/partial/unknown/unavailable).

Aan de slag#

Configureer de MCP-client: Wijs uw MCP-client naar het Maguyva-servereindpunt
Bevestig toegang tot de opslagplaats: Gebruik repository_context met lijst of info om opslagplaatsen te inspecteren die beschikbaar zijn voor de API-sleutel
Begin met zoeken: Begin met intelligent_search en verken indien nodig gespecialiseerde tools
Combineer hulpmiddelen: Gebruik meerdere tools samen voor uitgebreide codeanalyse

Zie de installatiehandleiding voor gedetailleerde integratie-instructies.