# Maguyva

Recetas breves para flujos de trabajo comunes de Maguyva MCP: instalar un cliente, buscar antes de editar, resolver resultados vacíos y trabajar con múltiples repositorios.

[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/es/docs/quickstart.md) or send `Accept: text/markdown`.

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

## Capacidades por lenguaje

A continuación, los recuentos de capacidades que impulsan la búsqueda estructural, la búsqueda de símbolos, el análisis basado en grafos y la indexación base.

Estos indicadores muestran las capacidades habilitadas en la configuración actual de los lenguajes, no puntuaciones de calidad de extremo a extremo. Para disponer del grafo, deben estar habilitados el analizador, la extracción de símbolos y la extracción del grafo. Los tipos de relaciones admitidos y la profundidad de extracción varían según el lenguaje.

- Cobertura indexada: **284**. Todos los lenguajes listados están indexados para contexto de archivo, texto y repositorio.
- Búsqueda estructural AST: **247**. Lenguajes con estructura respaldada por parser para flujos de trabajo de AST y búsqueda estructural.
- Extracción de símbolos: **282**. Lenguajes con metadatos de símbolos para definiciones y búsquedas.
- Relaciones de grafo: **151**. Lenguajes con extracción operativa de relaciones para búsquedas basadas en grafos. La profundidad varía según el lenguaje y el tipo de relación.

- `ast_structural=false`: Indexación centrada en texto, con menor reconocimiento estructural.
- `symbol_extraction=false`: La extracción de símbolos es limitada, así que la navegación depende más del contexto de archivo y estructura.
- `relationship_extraction=false`: Este lenguaje está indexado para búsqueda, pero actualmente no se persiste en el grafo de código.

[Encuentra tu lenguaje](/llms-full.txt)

## Recetas

Recetas prácticas para el trabajo diario con Maguyva MCP. Cada receta indica las herramientas y su secuencia de uso; no es una referencia completa de parámetros. Para consultar los parámetros de las herramientas, usa [Referencia de API MCP](https://maguyva.ai/es/docs/mcp-api). Para la configuración inicial, usa [Inicio rápido](https://maguyva.ai/es/docs/quickstart).

### Elige la herramienta adecuada

La mayoría de las preguntas comienzan con una llamada. Amplía la búsqueda solo cuando la primera respuesta sea demasiado general o no aporte suficiente información.

- `intelligent_search` — empieza aquí para hacer una pregunta en lenguaje natural sobre la base de código. Por defecto, auto/balanced dirige las preguntas sobre definiciones cuya intención identifica con confianza a la búsqueda estructural, las de referencias o impacto al grafo y las de coincidencia exacta al texto. Las demás preguntas usan el significado semántico y el texto indexado. Usa mode=hybrid o auto con quality=thorough para solicitar las cuatro modalidades de búsqueda. Un mode explícito tiene prioridad sobre quality.
- `find_symbol` — ya conoces el nombre de la función, clase o variable.
- `dependency_search` — radio de impacto: código que llama, código dependiente o impacto antes (y después) de una edición.
- `get_task_context` — zona desconocida; un paquete limitado de archivos, símbolos y dependencias para una descripción de tarea.
- `repository_context`: enumera los repositorios accesibles o inspecciona cómo se resuelve el nombre de un repositorio.
- `ask_maguyva` con `operation="guidance"`: ayuda local sobre la selección de herramientas y el uso de Maguyva (sin mutación de repositorio).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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.

## Próximos pasos

- [Inicio rápido](https://maguyva.ai/es/docs/quickstart)
- [Guía de instalación](https://maguyva.ai/es/docs/installation)
- [Referencia de API MCP](https://maguyva.ai/es/docs/mcp-api)
- [Solución de problemas](https://maguyva.ai/es/docs/troubleshooting)
- [Cómo funciona](https://maguyva.ai/es/docs/how-it-works)
- [Compatibilidad y especificaciones técnicas](https://maguyva.ai/es/docs/compatibility)

## Agent integrations

- [Maguyva para Cursor: contexto de la base de código vía MCP](https://maguyva.ai/es/for-cursor): Cursor edita el archivo abierto; Maguyva indexa todo el monorepo y lo sirve de vuelta vía MCP — búsqueda semántica, de AST, de grafo y de texto con file:line, para que el agente encuentre los archivos que no fijaste.
- [Maguyva para Windsurf: contexto de la base de código vía MCP](https://maguyva.ai/es/for-windsurf): Windsurf y Cascade editan el archivo abierto; Maguyva indexa todo el monorepo y lo sirve vía MCP — semántico, AST, grafo y texto con file:line, para que Cascade encuentre los archivos que no mencionaste.
- [Maguyva para Antigravity: contexto de la base de código vía MCP](https://maguyva.ai/es/for-antigravity): Antigravity ejecuta agentes autónomos en el editor, la terminal y el navegador; Maguyva les da un mapa consultable del monorepo vía MCP — el radio de impacto por adelantado, no después de que el CI se ponga en rojo.
- [Maguyva para Codex: contexto de la base de código vía MCP](https://maguyva.ai/es/for-codex): AGENTS.md es el acuerdo de trabajo. Maguyva es el servidor MCP que le da a Codex CLI un mapa consultable del repositorio, para que la primera edición no sea una suposición.
- [Maguyva para cualquier cliente MCP: contexto de la base de código vía MCP](https://maguyva.ai/es/for-anything): MCP es un protocolo abierto. Maguyva es un servidor MCP estándar, así que los clientes compatibles con MCP como Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity obtienen el mismo contexto de código fundamentado.
- [Maguyva para Gemini CLI: contexto de la base de código vía MCP](https://maguyva.ai/es/for-gemini): GEMINI.md establece el contexto de trabajo; MCP es el canal. Maguyva es el servidor MCP que le da a Gemini CLI un mapa consultable de tu repo — búsqueda semántica, de AST y de grafo, para que la primera edición no sea una adivinanza.
- [Maguyva para Claude Code: contexto de la base de código vía MCP](https://maguyva.ai/es/for-claude-code): CLAUDE.md le indica a Claude cómo comportarse. Maguyva indexa el repositorio y lo sirve por MCP para que Claude Code edite a partir de un mapa consultable.
- [Maguyva para GitHub Copilot CLI: contexto de código a través de MCP](https://maguyva.ai/es/for-copilot): Las instrucciones personalizadas le dicen a Copilot cómo comportarse. Maguyva indexa el repositorio y lo sirve por MCP para que GitHub Copilot CLI edite a partir de un mapa.

## Company

- [Acerca de Maguyva: inteligencia de código vía MCP](https://maguyva.ai/es/about): Inteligencia de código para agentes de programación: búsqueda semántica, AST, de grafo y de texto completo, búsqueda de símbolos, análisis de dependencias y contexto de tarea en una sola llamada en más de 284 lenguajes.
- [Conoce al equipo: 2 humanos + un enjambre de agentes de IA](https://maguyva.ai/es/team)
- [Cómo trabajamos: sin capital de riesgo, sin cobro por usuario, sin funciones bloqueadas](https://maguyva.ai/es/how): Sin capital externo. Sin precios por asiento. Tus datos no son el producto. Cómo está construido Maguyva y por qué tiene el precio que tiene.
- [Stack tecnológico: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/es/stack): El stack técnico detrás de Maguyva. PostgreSQL, embeddings de Voyage AI, búsqueda vectorial cuantizada, AST de tree-sitter y el protocolo MCP.
- [Changelog](https://maguyva.ai/es/changelog): Novedades de Maguyva: cambios de producto, actualizaciones del índice y de herramientas MCP, y notas de la construcción. Lo más reciente primero.
- [En vivo: Maguyva construyéndose a sí misma, en tiempo real](https://maguyva.ai/es/live): Nada de demo prefabricada. Este es el log real de despachos: cada llamada a herramienta, falla y commit del equipo de agentes de IA que construye Maguyva, en vivo.

## Guides

- [No es una búsqueda de texto completo escondida bajo una gabardina. Cinco modos de recuperación fusionados.](https://maguyva.ai/es/beyond-rag): El código necesita más que fragmentos semánticos. Maguyva fusiona cinco modos de recuperación en una sola respuesta clasificada, fundamentada en el repo real sobre MCP en 284 lenguajes. Nivel Free, sin tarjeta.
- [Los archivos de instrucciones no son un mapa de tu código. Maguyva sí.](https://maguyva.ai/es/beyond-rules-files): CLAUDE.md y AGENTS.md le dicen a un agente cómo comportarse. No le dicen qué hay en el código. Maguyva es la capa de contexto del código sobre MCP en 284 lenguajes. Nivel Free, sin tarjeta.
- [Editar es fácil. Saber qué se rompe es difícil. Maguyva lo mapea.](https://maguyva.ai/es/know-what-breaks): Antes de un refactor, tu agente debería conocer todo el código que llama, importa o depende de lo que vas a cambiar. Maguyva responde eso desde el grafo de llamadas real sobre MCP, no con un grep. Nivel Free, sin tarjeta.
- [Empieza gratis: la capa de contexto del código para agentes de codificación con IA](https://maguyva.ai/es/map-then-change): Primero mapea. Después cambia. Maguyva le da a tu agente de codificación con IA un mapa consultable del código sobre MCP, antes de la primera edición. 11 herramientas en 284 lenguajes. Nivel Free, sin tarjeta.
- [Tu agente empieza a ciegas en tu repo. Maguyva le da un mapa.](https://maguyva.ai/es/stop-flying-blind): Los agentes de codificación escanean los archivos equivocados y editan antes de entender el código. Maguyva le da a tu agente un mapa consultable del código sobre MCP en 284 lenguajes. Nivel Free, sin tarjeta.