What is this?
The AWS Docs MCP Server is a purpose-built Model Context Protocol (MCP) server that bridges AI agents with the rich universe of AWS documentation, billing data, and service metadata. Packaged as @modelcontextprotocol/server-aws-docs and maintained by AWS Labs and Anthropic, it exposes structured APIs that turn static documentation pages, cost metrics, and service metadata into dynamic, queryable endpoints for automated DevOps, cloud architecture, cost-optimization agents, and self-documenting infrastructure pipelines.
This server implements the MCP v1.0 protocol over HTTPS using AWS Lambda and API Gateway for auto-scaling and high availability. It natively understands AWS service hierarchies, pricing models, and metadata schemas, giving AI agents both context and actionable data. By embedding AWS domain knowledge into reasoning loops, it enables precise, compliant, and cost-effective cloud recommendations—from instance selection and cost anomaly detection to multi-account infrastructure deployments.
Quick Start
Install the server using npm:
npm install @modelcontextprotocol/server-aws-docs
Then add it to your MCP client configuration:
{
"mcpServers": {
"aws-docs": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-aws-docs"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}
Key Features
Centralized Access: Unify AWS documentation, billing, and metadata under a single MCP endpoint.
Cost Visibility: Retrieve granular billing records to power real-time cost analysis or anomaly detection.
Service Metadata Awareness: Obtain service quotas, region availability, and feature flags programmatically.
Example Usage
For example, you can query S3 pricing documentation directly through the MCP client in a few lines of code.
// Example code
const result = await client.callTool({
name: "DocQuery",
arguments: {
query: "S3 pricing",
limit: 5,
version: "latest"
}
});
This code searches the AWS documentation for “S3 pricing” and returns the top five matching topics, including titles and URLs.
Configuration
The server accepts the following environment variables:
API_KEY – Your MCP API key from the API Gateway usage plan.
DEPLOYMENT_REGION (optional) – AWS region to deploy the server (default is us-east-1).
Available Tools/Resources
DocQuery: Search or fetch AWS documentation topics, examples, and diagrams.
BillingReport: Access aggregated and granular cost and usage data.
ServiceCatalog: Discover services, quotas, and endpoints by region.
SchemaFetch: Download JSON or YAML schemas for AWS resources and API models.
Who Should Use This?
This server is perfect for:
Use case 1: AI developers building cloud-native assistants that need AWS context.
Use case 2: DevOps engineers automating cost optimization and compliance checks.
Use case 3: Chatbot and virtual assistant builders requiring dynamic AWS documentation retrieval.
Conclusion
With the AWS Docs MCP Server, you can seamlessly integrate AWS documentation, billing insights, and service metadata into your AI workflows—accelerating development, improving cost visibility, and enabling smarter cloud operations. Give it a try and see how it can streamline your infrastructure-aware automation.
Check out the GitHub repository for more information and to contribute.