{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nafw575dzfwd","handle":"aws-s3-explorer-mcp","url":"https://wellknown.network/agents/aws-s3-explorer-mcp","links":{"self":"https://wellknown.network/agents/aws-s3-explorer-mcp/record.json","html":"https://wellknown.network/agents/aws-s3-explorer-mcp","markdown":"https://wellknown.network/agents/aws-s3-explorer-mcp/record.md","api":"https://wellknown.network/api/v1/agents/aws-s3-explorer-mcp","status":"https://wellknown.network/api/v1/agents/aws-s3-explorer-mcp/status","claim":"https://wellknown.network/agents/aws-s3-explorer-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/aws-s3-explorer-mcp/claim.json","badge":"https://wellknown.network/agents/aws-s3-explorer-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:aws-s3-explorer-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"aws-s3-explorer-mcp","summary":"An open-source Model Context Protocol (MCP) server for Amazon S3.","description":"# AWS S3 Explorer - MCP Server\n\nAn open-source Model Context Protocol (MCP) server built in Python that securely connects AI assistants to Amazon S3. \n\nThis server provides Large Language Models (LLMs) with the ability to list buckets, inspect dataset structures, and read file schemas directly without requiring massive data downloads. It is engineered for ML infrastructure pipelines, featuring fully asynchronous I/O and defensive error handling.\n\n## Features\n\n* **Asynchronous I/O:** Utilizes `aiobotocore` for non-blocking concurrent requests, ensuring the server doesn't fall over under heavy LLM workloads.\n* **Defensive Error Handling:** Catch-and-return patterns for AWS exceptions (including missing credentials) that allow AI agents to cleanly self-correct.\n* **Strict Typing:** Heavily typed Python interfaces using the `FastMCP` wrapper to automatically generate robust JSON schemas for the client.\n* **Mocked CI/CD:** Fully automated test suites using `pytest` and `pytest-asyncio`, integrated into a GitHub Action pipeline.\n\n## Tools Exposed to the LLM\n\nThis server exposes three specific primitives:\n\n1. `list_s3_buckets()`: Lists all S3 buckets accessible by the current AWS credentials.\n2. `list_s3_objects(bucket_name, prefix, max_keys)`: Lists objects inside a specific bucket. Limits results by default to prevent LLM context window overflow.\n3. `read_s3_file_head(bucket_name, object_key, byte_limit)`: Reads the first few kilobytes of an S3 object to inspect its contents (e.g., CSV headers, JSON structures) without downloading the entire file.\n\n## Installation and Setup\n\n### Prerequisites\n* Python 3.11+\n* AWS credentials configured locally (e.g., `aws configure` or `~/.aws/credentials`)\n\n### Option 1: Quick Setup\nIf you have `uv` installed, you can quickly run the server without manual installation:\n```bash\nuvx aws-s3-explorer-mcp\n```\n\n### Option 2: User Setup\nInstall the package from PyPI:\n```bash\npip install aws-s3-explorer-mcp\n```\nYou can start the MCP server by …","publisher":null,"homepage":"https://github.com/kbates97/AWS_S3_Explorer_MCP.git","repository":"https://github.com/kbates97/AWS_S3_Explorer_MCP.git","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:aws-s3-explorer-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"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","infra"],"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":"aws-s3-explorer-mcp","registry":"pypi","observedAt":"2026-09-09T10:28:49.899Z","publishedAt":"2026-05-28T23:28:13.628811Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"aws-s3-explorer-mcp","url":"https://pypi.org/project/aws-s3-explorer-mcp/","firstSeenAt":"2026-09-09T10:26:14.026Z","fetchedAt":"2026-09-09T10:26:14.026Z","normalizedAt":"2026-09-09T10:26:14.026Z"}]},"firstSeenAt":"2026-09-09T10:26:14.026Z","updatedAt":"2026-09-09T10:28:49.905Z"}