{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zy69dkj7dmts","handle":"your-docs-mcp","url":"https://wellknown.network/agents/your-docs-mcp","links":{"self":"https://wellknown.network/agents/your-docs-mcp/record.json","html":"https://wellknown.network/agents/your-docs-mcp","markdown":"https://wellknown.network/agents/your-docs-mcp/record.md","api":"https://wellknown.network/api/v1/agents/your-docs-mcp","status":"https://wellknown.network/api/v1/agents/your-docs-mcp/status","claim":"https://wellknown.network/agents/your-docs-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/your-docs-mcp/claim.json","badge":"https://wellknown.network/agents/your-docs-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:your-docs-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"your-docs-mcp","summary":"Model Context Protocol server for hierarchical documentation navigation with markdown and OpenAPI support","description":"# your-docs-mcp\n\nAn MCP server that gives AI assistants structured access to your documentation. Supports markdown with YAML frontmatter, OpenAPI specs, full-text search, a web interface, and PDF generation.\n\n## Installation\n\nInstall from [PyPI](https://pypi.org/project/your-docs-mcp/):\n\n```bash\npip install your-docs-mcp\n```\n\nWith semantic search (recommended):\n\n```bash\npip install \"your-docs-mcp[vector]\" --extra-index-url https://download.pytorch.org/whl/cpu\n```\n\nWith PDF generation:\n\n```bash\npip install \"your-docs-mcp[pdf]\"\n```\n\nAll features:\n\n```bash\npip install \"your-docs-mcp[vector,pdf]\" --extra-index-url https://download.pytorch.org/whl/cpu\n```\n\nPDF generation requires system packages:\n\n- macOS: `brew install pandoc basictex`\n- Ubuntu/Debian: `sudo apt install pandoc texlive-xetex texlive-latex-extra`\n\n## Quick Start\n\n```bash\nexport DOCS_ROOT=/path/to/your/docs\nyour-docs-server\n```\n\nOpen http://localhost:8123 to browse your docs. The MCP server is also running for AI clients.\n\n## AI Client Setup\n\n**Claude Desktop** - edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"docs\": {\n      \"command\": \"your-docs-mcp\",\n      \"env\": {\n        \"DOCS_ROOT\": \"/absolute/path/to/your/docs\"\n      }\n    }\n  }\n}\n```\n\n**VS Code** - create `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"docs\": {\n      \"command\": \"your-docs-mcp\",\n      \"env\": {\n        \"DOCS_ROOT\": \"${workspaceFolder}/docs\"\n      }\n    }\n  }\n}\n```\n\n## Available MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_documentation` | Full-text search with relevance scoring |\n| `navigate_to` | Navigate to a doc by URI (e.g. `docs://guides/quickstart`) |\n| `get_table_of_contents` | Get the full documentation hierarchy |\n| `get_document` | Retrieve a document and its metadata |\n| `search_by_tags` | Filter docs by tags |\n| `get_all_tags` | List all tags across documentation |\n| `generate_pdf_release` | Generate a PDF of all documentation |\n\n## Support…","publisher":{"name":"MCP Contributors","url":null},"homepage":"https://github.com/esola-thomas/your-docs-mcp/tree/main/docs","repository":"https://github.com/esola-thomas/your-docs-mcp/tree/main/docs","version":"1.1.2","license":"MIT","protocols":["mcp"],"tags":["mcp","documentation","ai","openapi","markdown"],"pricing":null,"endpoints":[{"url":"pypi:your-docs-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.documentation","name":"Code Documentation","confidence":1,"provenance":"declared"},{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"declared"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":1,"provenance":"derived"},{"slug":"documents.conversion","name":"Document Conversion","confidence":0.848,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.848,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["code","data","dev","documents"],"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":"your-docs-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:28.181Z","publishedAt":"2026-05-08T06:03:05.557215Z","latestVersion":"1.1.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"your-docs-mcp","url":"https://pypi.org/project/your-docs-mcp/","firstSeenAt":"2026-09-10T16:23:26.272Z","fetchedAt":"2026-09-10T16:23:26.272Z","normalizedAt":"2026-09-10T16:23:26.272Z"}]},"firstSeenAt":"2026-09-10T16:23:26.272Z","updatedAt":"2026-09-10T16:24:28.181Z"}