{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_z2ghy6gy9ceu","handle":"papermoon-mkdocs-mcp","url":"https://wellknown.network/agents/papermoon-mkdocs-mcp","links":{"self":"https://wellknown.network/agents/papermoon-mkdocs-mcp/record.json","html":"https://wellknown.network/agents/papermoon-mkdocs-mcp","markdown":"https://wellknown.network/agents/papermoon-mkdocs-mcp/record.md","api":"https://wellknown.network/api/v1/agents/papermoon-mkdocs-mcp","status":"https://wellknown.network/api/v1/agents/papermoon-mkdocs-mcp/status","claim":"https://wellknown.network/agents/papermoon-mkdocs-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/papermoon-mkdocs-mcp/claim.json","badge":"https://wellknown.network/agents/papermoon-mkdocs-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:papermoon-mkdocs-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"papermoon-mkdocs-mcp","summary":"A lightweight MCP server for MkDocs documentation sites","description":"# papermoon-mkdocs-mcp\n\nA lightweight MCP server for MkDocs documentation sites. Reads markdown files\ndirectly from disk, provides full-text and optional semantic search, and exposes\nproject structure through the Model Context Protocol.\n\n## Features\n\n- **5 MCP tools** -- search, read_document, list_documents, get_project_info, get_document_outline\n- **SQLite FTS5 keyword search** with BM25 ranking (zero external dependencies)\n- **Optional semantic vector search** via sentence-transformers\n- **Hybrid search** combining keyword + vector results with Reciprocal Rank Fusion\n- **Incremental indexing** -- fast updates when files change\n- **Persistent SQLite index** that survives server restarts\n- **Navigation-aware** -- parses `mkdocs.yml` and `.nav.yml`\n- **Excludable documents** -- keep drafts and internal pages off the MCP surface\n- **Security-first** -- path traversal prevention, read-only search connections\n- **Minimal dependencies** -- 3 required, 2 optional\n\n## Installation\n\n```bash\npip install papermoon-mkdocs-mcp\n```\n\nTo enable vector search:\n\n```bash\npip install papermoon-mkdocs-mcp[vector]\n```\n\n## Quick Start\n\nRun from the root of any MkDocs project (where `mkdocs.yml` lives):\n\n```bash\ncd /path/to/your/mkdocs-project\npapermoon-mkdocs-mcp\n```\n\nOr point to a specific config file:\n\n```bash\npapermoon-mkdocs-mcp --config /path/to/mkdocs.yml\n```\n\nThe server auto-detects `mkdocs.yml` in the current directory when `--config`\nis omitted.\n\n### Transport Options\n\nBy default the server uses **stdio** transport. You can switch to a network\ntransport for remote or multi-client setups:\n\n```bash\n# Streamable HTTP (recommended for network access)\npapermoon-mkdocs-mcp --transport streamable-http --host 0.0.0.0 --port 9000\n\n# SSE (legacy client compatibility)\npapermoon-mkdocs-mcp --transport sse --port 8080\n```\n\n| Flag            | Default       | Description                                      |\n|-----------------|---------------|-----------------------------------------------…","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["documentation","mcp","mkdocs","model-context-protocol","search"],"pricing":null,"endpoints":[{"url":"pypi:papermoon-mkdocs-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"code.documentation","name":"Code Documentation","confidence":1,"provenance":"declared"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.848,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["code","data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"papermoon-mkdocs-mcp","registry":"pypi","observedAt":"2026-09-10T09:26:51.683Z","publishedAt":"2026-08-25T15:30:52.151898Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"papermoon-mkdocs-mcp","url":"https://pypi.org/project/papermoon-mkdocs-mcp/","firstSeenAt":"2026-09-10T09:25:30.224Z","fetchedAt":"2026-09-10T09:25:30.224Z","normalizedAt":"2026-09-10T09:25:30.224Z"}]},"firstSeenAt":"2026-09-10T09:25:30.224Z","updatedAt":"2026-09-10T09:26:51.683Z"}