Skip to main content
Glama
Lolaplex

agents-docs

by Lolaplex

agents-docs

Ultra-fast, zero-bloat local markdown documentation RAG for AI coding agents via MCP.
Instant BM25 search over official framework documentation and live AI model registries. Shared across Cursor, Claude Code, Antigravity, and Zed.


Why .agents/docs?

Coding agents frequently hallucinate deprecated APIs (Svelte 4 vs 5 Runes, Tailwind v3 vs v4, React 19 Actions) or reference outdated LLM models and token pricing.

Traditional vector-embedding RAG solutions are bloated: they require Docker containers, hundreds of megabytes of Python dependencies (Chroma, LangChain), and slow API embedding calls that split code blocks in half.

agents-docs applies the Lolaplex philosophy:

  • Zero Vector DBs: Header-aware markdown chunking + pure Python lexical BM25 ranking with header match boost (+6.0) and full phrase boost (+10.0).

  • Sub-10ms Search: Instant retrieval directly from plain markdown files on disk (~/.agents/docs/).

  • Live AI Models Registry: Real-time tracked context windows, benchmarks, and token pricing ($/1M) for Frontier and Open-Weights models (Claude 5/4, GPT-5/o3/o4, Gemini 3.x, DeepSeek V4/R1, Qwen 2.5 Coder).

  • Curated 21+ Framework Catalog: 1-click sync for official llms.txt (TypeScript Handbook, Svelte 5, FastAPI, Tailwind v3/v4, Tauri 2, Next.js, Supabase, Hono, WXT, Netlify, Coolify, Cloudflare, Resend, React, Vite, Zod, Pydantic, shadcn/ui).

  • Deterministic Noise Pruning: Automatically strips HTML wrappers, link noise, and cookie banners without altering code blocks or tables.

  • Universal MCP Server: FastMCP stdio interface with auto-sync and dependency manifest inspection.


Related MCP server: Speakeasy Docs MCP

Architecture & Flow

 ┌─────────────────────────────────────────────────────────────┐
 │                  DOCS & MODEL REGISTRIES                    │
 │    Official llms.txt · TypeScript Handbook · OpenRouter     │
 └──────────────────────────────┬──────────────────────────────┘
                                │  agents-docs sync <name>
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                 DETERMINISTIC NOISE PRUNER                  │
 │    Strips HTML boilerplate while preserving 100% of code    │
 └──────────────────────────────┬──────────────────────────────┘
                                │  Header-aware chunking
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   LOCAL DOCUMENTATION STORE                 │
 │   ~/.agents/docs/ai-models/       ~/.agents/docs/svelte-5/  │
 │   ~/.agents/docs/typescript/      ~/.agents/docs/fastapi/   │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │        LEXICAL BM25         │ │     MCP SERVER & CLERK      │
 │  Header Match Boost (+6.0)  │ │  search_docs · list_docsets │
 │  Sub-10ms Exact Retrieval   │ │  sync_project_docs          │
 └─────────────────────────────┘ └─────────────────────────────┘

Quickstart

1-Step Setup

pip install agents-docs && agents-docs init

Scaffolds ~/.agents/docs/, seeds the live ai-models registry, autowires MCP configurations into your installed IDEs, and registers assistant skills.

TIP

🤖 Agent-Driven Setup (Zero Friction):
Simply tell your coding agent: "Install and set up agents-docs for me."
The agent installs the package, runs agents-docs init, and automatically retrieves fresh documentation whenever you ask technical stack or model pricing questions.


CLI Reference

Command

Purpose

agents-docs init

Plug & Play setup: auto-configures MCP across all IDEs and seeds model docs

agents-docs catalog

Lists all 21+ pre-configured frameworks and model catalogs

agents-docs sync <name>

1-click download/update of official framework documentation

agents-docs sync <name> --url <URL>

Ingests any custom llms.txt, llms-full.txt, or markdown URL

agents-docs search "<query>"

Fast BM25 search across all installed docsets

agents-docs search "<query>" --docset <name>

Scoped search within a specific documentation set

agents-docs prune

In-place noise & boilerplate cleaner across all installed docs

agents-docs list

Lists all installed docsets on disk with file and byte counts

agents-docs serve

Runs the FastMCP stdio server (default)


MCP Tools Reference

Tool

Parameters

Description

list_docsets

None

Lists all installed docsets in ~/.agents/docs/ with file counts and byte sizes.

search_docs

query, docset (default: "all"), top_k (default: 4)

Returns top matching markdown sections with headers and code blocks in milliseconds. Auto-syncs missing catalog docsets on demand.

get_doc_page

docset, rel_path

Returns the raw markdown content of a specific file.

list_catalog

None

Lists all 21+ pre-configured frameworks and model catalogs available for 1-click sync.

sync_docset

name, url (optional)

Downloads/updates official documentation from the catalog or custom llms.txt / markdown URL.

sync_project_docs

project_path

Inspects package.json, requirements.txt, pyproject.toml, Cargo.toml and auto-syncs detected docsets.

sync_memory_docs

None

Scans ~/.agents/memory/PROJECTS.md and syncs all active stacks.


Supported Ecosystem

  • Claude Code: Bound via MCP server and .agents/skills/docs-search.

  • Google Antigravity: Integrated via .gemini/config rules and agents-docs MCP.

  • Cursor: Automatically configures .cursor/mcp.json and agent rules.

  • Zed: Configures context_servers and mirrors assistant skills.

  • VS Code / Windsurf: Autowires Cline / Roo-Code MCP configuration.


Open ABI Specification

Detailed architectural specifications live in abi/:


Testing & Verification

Run the test suite across all engines:

python tests/run_all_tests.py

License

MIT License. See LICENSE for details.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    MCP server that gives AI coding agents on-demand access to private project docs via BM25 ranked search. One setup for Claude Code, Cursor, Codex, Gemini CLI, and more. Docs stay private, never in public repos.
    15
    15
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    A lightweight, domain-agnostic hybrid search engine for markdown corpora, exposed via the Model Context Protocol (MCP), optimized for serving SDK documentation to AI coding agents.
    7
    AGPL 3.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Local-first context retrieval engine that serves precise documentation chunks to coding agents via MCP, ensuring high-confidence context for code generation.
    MIT

View all related MCP servers

Related MCP Connectors

  • Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.

  • Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.

  • Token-efficient search for coding agents over public and private documentation.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lolaplex/agents-docs'

If you have feedback or need assistance with the MCP directory API, please join our Discord server