{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jkth6r3y6c52","handle":"mcp-file-contents-reader","url":"https://wellknown.network/agents/mcp-file-contents-reader","links":{"self":"https://wellknown.network/agents/mcp-file-contents-reader/record.json","html":"https://wellknown.network/agents/mcp-file-contents-reader","markdown":"https://wellknown.network/agents/mcp-file-contents-reader/record.md","api":"https://wellknown.network/api/v1/agents/mcp-file-contents-reader","status":"https://wellknown.network/api/v1/agents/mcp-file-contents-reader/status","claim":"https://wellknown.network/agents/mcp-file-contents-reader/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-file-contents-reader/claim.json","badge":"https://wellknown.network/agents/mcp-file-contents-reader/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-file-contents-reader/history","tools":"https://wellknown.network/api/v1/agents/mcp-file-contents-reader/tools"},"ard":{"identifier":"urn:air::server:mcp-file-contents-reader","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-file-contents-reader","summary":"MCP (Model Context Protocol) server for reading and analyzing various file formats including PDF, Excel, Word, and PowerPoint","description":"# MCP File Contents Reader\n\nA Model Context Protocol (MCP) server for reading and analyzing various file formats including PDF, Excel, Word, and PowerPoint documents.\n\n## Features\n\n- **Multi-format Support**: Read PDF, Excel (.xlsx, .xls), Word (.docx, .doc), and PowerPoint (.pptx, .ppt) files\n- **Content Analysis**: Extract and analyze file contents with structured information extraction\n- **Document Search**: Search for specific content across multiple documents\n- **File Upload**: Support for temporary file upload and processing\n- **MCP Integration**: Full Model Context Protocol compliance\n\n## Installation\n\n### Using uvx (Recommended)\n\n```bash\nuvx mcp-file-contents-reader\n```\n\n### Using pip\n\n```bash\npip install mcp-file-contents-reader\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/yourusername/mcp-file-contents-reader.git\ncd mcp-file-contents-reader\npip install -e .\n```\n\n## Usage\n\n### MCP Configuration\n\nAdd the following to your `mcp.json` configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"file-reader\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-file-contents-reader\"]\n    }\n  }\n}\n```\n\nOr if installed via pip:\n\n```json\n{\n  \"mcpServers\": {\n    \"file-reader\": {\n      \"command\": \"mcp-file-contents-reader\"\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### 1. `read_file`\n\nRead Excel, PDF, PPT, Word files and return content as text.\n\n**Parameters:**\n\n- `file_path` (required): Path to the file to read\n- `sheet_name` (optional): Sheet name for Excel files\n- `page_range` (optional): Page range for PDF files (e.g., '1-5' or '1,3,5')\n\n#### 2. `search_documents`\n\nSearch for specific content in Documents directory and analyze files.\n\n**Parameters:**\n\n- `keywords` (required): Keywords to search for in file content\n- `search_path` (optional): Directory path to search (default: ~/Documents)\n- `file_types` (optional): File types to search (default: [\"pdf\", \"docx\", \"xlsx\", \"pptx\", \"doc\", \"xls\", \"ppt\"])\n\n#### 3. `analyze_file_content`\n\nAnalyze specific file content in de…","publisher":null,"homepage":"https://github.com/choipureum/mcp-file-contents-reader","repository":"https://github.com/choipureum/mcp-file-contents-reader","version":"1.0.20","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-file-contents-reader","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"documents.presentations","name":"Presentations","confidence":0.802,"provenance":"derived"},{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.745,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["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":"mcp-file-contents-reader","registry":"pypi","observedAt":"2026-10-22T09:23:17.200Z","publishedAt":"2025-09-02T02:18:25.285618Z","latestVersion":"1.0.20"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-file-contents-reader","url":"https://pypi.org/project/mcp-file-contents-reader/","firstSeenAt":"2026-09-10T01:20:47.323Z","fetchedAt":"2026-10-22T09:21:19.283Z","normalizedAt":"2026-10-22T09:21:19.283Z"}]},"firstSeenAt":"2026-09-10T01:20:47.323Z","updatedAt":"2026-10-22T09:23:17.200Z"}