{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8a7hyqb2cttq","handle":"mcp-ebook-read","url":"https://wellknown.network/agents/mcp-ebook-read","links":{"self":"https://wellknown.network/agents/mcp-ebook-read/record.json","html":"https://wellknown.network/agents/mcp-ebook-read","markdown":"https://wellknown.network/agents/mcp-ebook-read/record.md","api":"https://wellknown.network/api/v1/agents/mcp-ebook-read","status":"https://wellknown.network/api/v1/agents/mcp-ebook-read/status","claim":"https://wellknown.network/agents/mcp-ebook-read/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-ebook-read/claim.json","badge":"https://wellknown.network/agents/mcp-ebook-read/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-ebook-read/history","tools":"https://wellknown.network/api/v1/agents/mcp-ebook-read/tools"},"ard":{"identifier":"urn:air::server:mcp-ebook-read","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-ebook-read","summary":"MCP server for reading and searching EPUB/PDF documents","description":"# mcp-ebook-read\n\nA local MCP server that lets LLM agents read EPUB books, non-scanned PDF books, and non-scanned PDF papers with local sidecar persistence.\n\nThe server is designed around outline-first navigation, precise node reads, formula/image/table evidence, and a local SQLite DocumentGraph. It does not require Qdrant or any other external vector database.\n\n## Run MCP Server (PyPI via `uvx`)\n\n```bash\nuvx mcp-ebook-read\n```\n\nThe server starts without required environment variables. It does not create `.mcp-ebook-read` during startup. The root sidecar is created only when EPUB/PDF documents are scanned or ingested under the selected library root.\n\n### First Run Recommendation\n\nBefore configuring this MCP inside an MCP client, run it once manually from a terminal:\n\n```bash\nuvx mcp-ebook-read\n```\n\nThis pre-resolves runtime dependencies, which helps avoid long first-time activation latency after MCP client configuration.\n\nWhen you want to force `uvx` to use the latest published version, run:\n\n```bash\nuvx mcp-ebook-read@latest\n```\n\nIf you installed the tool persistently via `uv tool install`, use:\n\n```bash\nuv tool upgrade mcp-ebook-read\n```\n\n## Optional GROBID Paper Enrichment\n\nGROBID is optional. PDF paper ingest works without it using the local PDF parser as the baseline. When configured, GROBID enriches paper metadata such as title, abstract, DOI, and bibliography counts.\n\n```bash\ndocker rm -f grobid 2>/dev/null || true && docker run -d --name grobid --init --ulimit core=0 -p 8070:8070 grobid/grobid:0.9.0-crf\n```\n\nVerify it if you choose to use it:\n\n```bash\ncurl -sS http://localhost:8070/api/isalive\n```\n\nRun with optional enrichment:\n\n```bash\nGROBID_URL=http://localhost:8070 GROBID_TIMEOUT_SECONDS=120 uvx mcp-ebook-read\n```\n\n## Environment Variables\n\nRequired: none.\n\nOptional:\n- `GROBID_URL` (for example `http://127.0.0.1:8070`) enables optional PDF paper metadata enrichment.\n- `GROBID_TIMEOUT_SECONDS` (default `20`; recommended `120` for large papers).\n- `MCP_EB…","publisher":null,"homepage":null,"repository":null,"version":"0.3.7","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-ebook-read","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":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.802,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.779,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["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":"mcp-ebook-read","registry":"pypi","observedAt":"2026-10-28T11:27:07.453Z","publishedAt":"2026-06-17T06:24:23.696051Z","latestVersion":"0.3.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-ebook-read","url":"https://pypi.org/project/mcp-ebook-read/","firstSeenAt":"2026-09-10T01:20:17.142Z","fetchedAt":"2026-10-28T11:25:05.856Z","normalizedAt":"2026-10-28T11:25:05.856Z"}]},"firstSeenAt":"2026-09-10T01:20:17.142Z","updatedAt":"2026-10-28T11:27:07.453Z"}