# Maguyva

Mga maiikling recipe para sa karaniwang mga workflow ng Maguyva MCP: mag-install ng client, maghanap bago ka mag-edit, walang laman na mga resulta, at multi-repo na trabaho.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/fil/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/fil/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/fil/changelog.json).

## Mga Kakayahan sa Language

Nasa ibaba ang mga bilang ng kakayahan na nagpapatakbo sa structural search, symbol lookup, graph-aware analysis, at baseline indexing.

Ipinapakita ng mga palatandaang ito ang mga kakayahang naka-enable sa kasalukuyang configuration ng wika, hindi ang mga marka ng kalidad ng buong proseso. Para maging available ang graph, kailangang naka-enable ang parser, symbol extraction, at graph extraction. Nag-iiba ayon sa wika ang mga suportadong uri ng relasyon at lalim ng extraction.

- Saklaw ng pag-index: **284**. Naka-index ang bawat nakalistang wika para sa file, text, at repository context.
- Structural search gamit ang AST: **247**. Mga wikang may parser-backed structure para sa AST at structural-search workflows.
- Extraction ng symbol: **282**. Mga wikang may metadata ng simbolo para sa mga depinisyon at paghahanap.
- Mga ugnayan sa graph: **151**. Mga wikang may gumaganang pagkuha ng mga ugnayan para sa graph-aware na paghahanap. Nag-iiba ang lalim ayon sa wika at uri ng ugnayan.

- `ast_structural=false`: Text-first na indexing na mas magaan ang structural awareness.
- `symbol_extraction=false`: Limitado ang symbol extraction, kaya mas umaasa ang navigation sa file at structure context.
- `relationship_extraction=false`: Naka-index ang wikang ito para sa paghahanap, pero hindi ito kasalukuyang iniimbak sa code graph.

[Hanapin ang wika mo](/llms-full.txt)

## Mga Resipe

Mga praktikal na recipe para sa pang-araw-araw na gawaing Maguyva MCP. Inililista ng bawat recipe ang mga tool at ang pagkakasunud-sunod ng paggamit — hindi ito kumpletong parameter reference. Para sa mga parameter ng tool, gamitin ang [Sanggunian sa MCP API](https://maguyva.ai/fil/docs/mcp-api). Para sa unang setup, gamitin ang [Quickstart](https://maguyva.ai/fil/docs/quickstart).

### Piliin ang tamang tool

Karamihan sa mga tanong ay nagsisimula sa isang call. Gumamit lang ng mas masusing paraan kapag masyadong malawak o kulang sa detalye ang unang sagot.

- `intelligent_search` — magsimula rito para sa tanong tungkol sa codebase na nakasulat sa natural na wika. Sa default na auto/balanced, ang mga query na may mataas na kumpiyansang natukoy bilang paghahanap ng definition ay dinadala sa structural search, ang mga tanong tungkol sa reference o epekto sa graph, at ang mga tanong tungkol sa eksaktong tugma sa text search. Gumagamit ang ibang tanong ng semantic na kahulugan at naka-index na text. Gamitin ang mode=hybrid o auto na may quality=thorough para hilingin ang lahat ng apat na paraan ng paghahanap. Mas nasusunod ang tahasang piniling mode kaysa sa quality.
- `find_symbol` — alam mo na ang function, klase, o variable na pangalan.
- `dependency_search` — blast radius: mga tumatawag, dependent, o epekto bago (at pagkatapos) ng isang pag-edit.
- `get_task_context` — hindi pamilyar na lugar; isang bounded na bundle ng mga file, symbols, at dependencies para sa isang paglalarawan ng gawain.
- `repository_context` — maglista ng mga naa-access na repositoryo o siyasatin kung paano niresolba ang pangalan ng repositoryo.
- `ask_maguyva` na may `operation="guidance"` — lokal na tulong sa pagpili ng tool at paggamit ng Maguyva (walang repo mutation).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/fil/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/fil/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/fil/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/fil/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/fil/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/fil/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/fil/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/fil/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/fil/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/fil/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/fil/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Mga susunod na hakbang

- [Quickstart](https://maguyva.ai/fil/docs/quickstart)
- [Gabay sa Pag-install](https://maguyva.ai/fil/docs/installation)
- [Sanggunian sa MCP API](https://maguyva.ai/fil/docs/mcp-api)
- [Pag-troubleshoot](https://maguyva.ai/fil/docs/troubleshooting)
- [Paano Ito Gumagana](https://maguyva.ai/fil/docs/how-it-works)
- [Compatibility at Technical Specifications](https://maguyva.ai/fil/docs/compatibility)

## Agent integrations

- [Maguyva para sa Cursor: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-cursor): Ini-edit ng Cursor ang bukas na file; ini-index ng Maguyva ang buong monorepo at ibinabalik ito sa pamamagitan ng MCP — semantic, AST, graph, at text search na may file:line, para mahanap ng agent ang mga file na hindi mo pinin.
- [Maguyva para sa Windsurf: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-windsurf): Ini-edit ng Windsurf at Cascade ang bukas na file; ini-index ng Maguyva ang buong monorepo at inihahatid ito sa pamamagitan ng MCP — semantic, AST, graph, at text na may file:line, para mahanap ni Cascade ang mga file na hindi mo nabanggit.
- [Maguyva para sa Antigravity: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-antigravity): Nagpapatakbo ang Antigravity ng mga autonomous agent sa editor, terminal, at browser; binibigyan sila ng Maguyva ng queryable na mapa ng monorepo sa pamamagitan ng MCP — ang saklaw ng epekto agad, hindi pagkatapos mag-red ang CI.
- [Maguyva para sa Codex: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-codex): Ang AGENTS.md ang working agreement. Ang Maguyva ang MCP server na nagbibigay sa Codex CLI ng queryable na mapa ng repo, para hindi hula ang unang edit.
- [Maguyva para sa anumang MCP client: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-anything): Ang MCP ay isang open protocol. Ang Maguyva ay isang standard na MCP server, kaya ang mga MCP-enabled client tulad ng Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity ay nakukuha ang parehong naka-ground na codebase context.
- [Maguyva para sa Gemini CLI: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-gemini): Itinatakda ng GEMINI.md ang working context; ang MCP ang channel. Ang Maguyva ang MCP server na nagbibigay sa Gemini CLI ng queryable na mapa ng repo mo — semantic, AST, at graph search para ang unang edit ay hindi isang hula.
- [Maguyva para sa Claude Code: codebase context sa pamamagitan ng MCP](https://maguyva.ai/fil/for-claude-code): Sinasabi ng CLAUDE.md kay Claude kung paano kikilos. Ini-index ng Maguyva ang repo at ini-serve ito sa MCP para mag-edit ang Claude Code batay sa queryable na mapa.
- [Maguyva para sa GitHub Copilot CLI: code context sa MCP](https://maguyva.ai/fil/for-copilot): Sinasabi ng custom instructions kay Copilot kung paano kikilos. Ini-index ng Maguyva ang repo at ini-serve ito sa MCP para mag-edit ang GitHub Copilot CLI batay sa mapa.

## Company

- [Tungkol sa Maguyva: Code Intelligence sa pamamagitan ng MCP](https://maguyva.ai/fil/about): Code intelligence para sa mga coding agent: semantic, AST, graph, at full-text na paghahanap, symbol lookup, dependency analysis, at task context sa isang tawag lang, sa 284+ na wika.
- [Kilalanin ang Team: 2 Tao + AI Agent Swarm](https://maguyva.ai/fil/team)
- [Paano Kami Gumagawa: Walang VC, Walang Seat Pricing, Walang Feature Gates](https://maguyva.ai/fil/how): Walang panlabas na kapital. Walang seat pricing. Hindi produkto ang data mo. Paano ginawa ang Maguyva at bakit ganito ang presyo nito.
- [Stack ng teknolohiya: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/fil/stack): Ang technical stack na nagpapatakbo sa Maguyva. PostgreSQL, Voyage AI embeddings, quantized na paghahanap sa vector, tree-sitter AST, at MCP protocol.
- [Changelog](https://maguyva.ai/fil/changelog): Ang na-ship sa Maguyva: mga pagbabago sa produkto, update sa index at MCP tools, at mga tala mula sa build. Pinakabago muna.
- [Live: Ginagawa ni Maguyva ang Sarili Niya, Real-Time](https://maguyva.ai/fil/live): Hindi ito canned demo. Ito ang aktwal na dispatch log — bawat tool call, fault, at commit mula sa AI agent team na gumagawa ng Maguyva, live.

## Guides

- [Hindi full-text search na naka-trenchcoat. Limang pinagsamang retrieval mode.](https://maguyva.ai/fil/beyond-rag): Kailangan ng code ng higit pa sa semantic chunks. Pinagsasama ng Maguyva ang limang retrieval mode sa isang ranked na sagot, naka-ground sa tunay na repo sa pamamagitan ng MCP sa 284 na wika. Free tier, walang card.
- [Ang mga instruction file ay hindi mapa ng code mo. Ang Maguyva, oo.](https://maguyva.ai/fil/beyond-rules-files): Sinasabi ng CLAUDE.md at AGENTS.md sa agent kung paano kumilos. Hindi nila sinasabi kung ano ang laman ng codebase. Ang Maguyva ang codebase context layer sa pamamagitan ng MCP sa 284 na wika. Free tier, walang card.
- [Madali ang pag-edit. Mahirap malaman kung ano ang masisira. Ini-mapa ito ng Maguyva.](https://maguyva.ai/fil/know-what-breaks): Bago mag-refactor, dapat alam ng agent mo ang bawat caller, importer, at dependent. Sinasagot iyon ng Maguyva mula sa tunay na call graph sa pamamagitan ng MCP, hindi isang grep. Free tier, walang card.
- [Magsimula nang libre: ang codebase context layer para sa mga AI coding agent](https://maguyva.ai/fil/map-then-change): Mapa muna. Pagbabago pagkatapos. Binibigyan ng Maguyva ang AI coding agent mo ng queryable na mapa ng codebase sa pamamagitan ng MCP, bago pa ang unang edit. 11 tool sa 284 na wika. Free tier, walang card.
- [Bulag na nagsisimula ang agent mo sa repo mo. Binibigyan ito ng mapa ng Maguyva.](https://maguyva.ai/fil/stop-flying-blind): Sinasaliksik ng mga coding agent ang maling file at nag-e-edit bago pa nila maintindihan ang code. Binibigyan ng Maguyva ang agent mo ng queryable na mapa ng codebase sa pamamagitan ng MCP sa 284 na wika. Free tier, walang card.