Código y GitHubRef MCP — Documentación para tu Código
Un buscador de documentación para tu IA, muy eficiente con los "tokens": encuentra exactamente la doc y los ejemplos que necesita, leyendo lo mínimo. Alternativa a Context7 con su propio enfoque de búsqueda "agéntica".
Revisada el 2026-09-21
- Popularidad
- 1.2k
- Licencia
- MIT
- Autor
- Ref Tools
- Categoría
- Código y GitHub
Seguridad: revisada
El contenido es seguro; el instalador o el servicio externo no se auditan aquí.
¿Qué es?
Es un conector que le da a tu IA documentación actualizada de APIs, servicios y librerías, igual que Context7, pero con un objetivo muy claro: usar los mínimos tokens posibles. Hace búsquedas y lee solo los trozos relevantes, para no llenar el contexto de ruido.
Piénsalo como un bibliotecario eficiente: en vez de traerte el libro entero, busca la página exacta que necesitas.
Qué puede hacer:
search— buscar documentación.read— leer una URL concreta en profundidad.- Optimizar para gastar pocos tokens (contexto limpio).
¿Cuándo me sirve?
Cuando programas con librerías y APIs y quieres la doc correcta sin gastar contexto:
- "Necesito la API actual de Figma" → búsqueda precisa.
- "¿Cómo se usa el endpoint X?" → ejemplos actuales.
- "Lee esta documentación concreta" → lectura dirigida.
- "No me llenes el contexto de ruido" → búsqueda eficiente.
¿Esto me sirve a mí?
Sí, si programas. Es una alternativa interesante a Context7 (puedes tener las dos).
| Si un día piensas... | Te da... |
|---|---|
| "La IA inventa APIs" | Documentación real |
| "El contexto se llena de basura" | Búsqueda eficiente en tokens |
| "Quiero la doc de una API concreta" | Búsqueda + lectura |
| "Ejemplos desactualizados me fallan" | Ejemplos actuales |
No te sirve si no programas. Requiere clave gratuita de ref.tools.
¿Es segura?
Veredicto: ✅ Limpia* (el MCP es seguro; usa un servicio externo que no se audita aquí).
- Qué hace: busca y lee documentación pública. No accede a tus archivos ni a tu código.
- Tu clave: en variable de entorno (
REF_API_KEY), no se comparte. - **El matiz (limpia*): es un servicio externo** (Ref Tools); tus búsquedas pasan por sus servidores.
- Licencia: MIT.
Cómo se instala
Remoto:
{
"mcpServers": {
"ref": {
"url": "https://api.ref.tools/mcp?apiKey=TU_CLAVE"
}
}
}Local (alternativa): npx -y ref-tools-mcp con REF_API_KEY.
Clave gratuita: https://ref.tools
¿En qué asistentes funciona?
| Asistente | ¿Funciona? | Notas |
|---|---|---|
| OpenCode | ✅ Sí | Configuración MCP |
| Claude Code | ✅ Sí | Configuración MCP |
| Cursor / VS Code / Windsurf | ✅ Sí | Compatible con MCP |
| Smithery | ✅ Sí | Instalación gestionada |
Enlaces
- Repositorio: https://github.com/ref-tools/ref-tools-mcp
- Web: https://ref.tools