View a markdown version of this page

Understanding the MCP Server tools - Agent Toolkit for AWS

Understanding the MCP Server tools

AWS MCP Server provides the following tools to help you complete AWS tasks through natural language interactions.

AWS Knowledge Tools

  • aws___retrieve_skill - Retrieve domain-specific expertise for a particular AWS domain. Skills provide workflows, context, best practices, decision frameworks, and step-by-step procedures. When called with a skill name, returns the full skill content including reference materials. Use aws___search_documentation to discover available skills.

  • aws___search_documentation - Search across all AWS documentation, including API references, best practices, service guides, and skills (formerly Agent SOPs). Use the topic filter to search skills exclusively, or see skills alongside general knowledge search results. Find relevant information from multiple AWS knowledge sources.

  • aws___read_documentation - Retrieve and convert AWS documentation pages to markdown format for easy consumption by AI assistants.

  • aws___recommend - Get content recommendations for AWS documentation pages based on related topics and commonly viewed content.

  • aws___list_regions - Retrieve a list of all AWS regions, including their identifiers and names.

  • aws___get_regional_availability - Check AWS regional availability information for services, features, SDK APIs, and CloudFormation resources.

AWS API Tools

  • aws___call_aws - Execute authenticated AWS API calls with proper syntax validation and error handling. Supports most of the 15,000+ AWS APIs with automatic credential management.

  • aws___suggest_aws_commands - Get descriptions and syntax help for relevant AWS APIs, including newly released APIs that may not be in the AI model's training data.

  • aws___run_script - Execute Python code in a sandboxed environment with AWS API access. Use for tasks that involve listing resources and checking their properties, parallel API calls, multi-step workflows, cross-service checks, and retry logic.

  • aws___get_presigned_url - Generate pre-signed Amazon S3 URLs for uploading or downloading files. Use this tool for direct Amazon S3 uploads and downloads, or when an AWS CLI command requires a local file path.

  • aws___get_tasks - Poll the status of long-running tasks started by aws___call_aws or aws___run_script. Use when a previous tool call returns a task ID with a working status.

These tools work together to provide comprehensive AWS task completion: skills guide the workflow, knowledge tools provide current information and best practices, and API tools execute the actual AWS operations with proper authentication and authorization.