AWS Lambda Powertools Documentation Search

AWS Lambda Powertools Documentation Search

aws-powertools

Search and retrieve AWS Lambda Powertools documentation across multiple runtimes locally. Helps AI agents quickly find toolkit information and examples.

Enables AI to search and retrieve AWS Lambda Powertools documentation across multiple runtimes through a TypeScript server with efficient local search capabilities and content caching.

41338 views14Local (stdio)

What it does

  • Search Powertools documentation by keywords
  • Fetch complete documentation pages as markdown
  • Browse examples across multiple AWS Lambda runtimes
  • Cache documentation content locally

Best for

Serverless developers using AWS LambdaLearning Powertools best practicesBuilding AI agents that need AWS documentation context
Local search with cachingMulti-runtime supportNo API key needed

About AWS Lambda Powertools Documentation Search

AWS Lambda Powertools Documentation Search is a community-built MCP server published by aws-powertools that provides AI assistants with tools and capabilities via the Model Context Protocol. AWS Lambda Powertools Documentation Search lets AI quickly find and cache docs for multiple runtimes via a fast TypeScri It is categorized under developer tools. This server exposes 2 tools that AI clients can invoke during conversations and coding sessions.

How to install

You can install AWS Lambda Powertools Documentation Search in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

AWS Lambda Powertools Documentation Search is released under the NOASSERTION license.

Tools (2)

search_docs

Search Powertools for AWS Lambda documentation to learn about Serverless best practices. Try searching for features like 'Logger', 'Tracer', 'Metrics', 'Idempotency', 'batchProcessor', event handler, etc. Powertools is available for the following runtimes: python, typescript, java, dotnet. When searching, always specify the version of Powertools you are interested in, if unsure, try to read it from the workspace configuration, otherwise use "latest".

fetch_doc_page

Fetches the content of a Powertools documentation page and returns it as markdown.Use this after finding relevant pages with search_docs to get detailed information.

Powertools for AWS MCP

NodeSupport GitHub Release OpenSSF Scorecard Status Stability Discord

The Powertools for AWS Model Context Protocol (MCP) is an MCP implementation that provides search functionality for the Powertools for AWS Lambda documentation across multiple runtimes. It allows your LLM agents to search for documentation and examples related to the toolkit, helping you to quickly find the information you need to use Powertools for AWS Lambda effectively.

[!WARNING] This project is experimental and under active development. APIs and features may change frequently without notice.

đź’ˇ Get Involved

We're actively seeking community feedback and feature suggestions join our Discord or open an issue to share your thoughts.

Use Cases

  • Bring documentation and examples directly into your LLM agents' context.
  • Search for specific topics or keywords within the Powertools for AWS documentation.
  • Help your agents understand how to use the Powertools for AWS Lambda toolkit effectively.

Getting Started

CursorVS Code
Install MCP ServerInstall on VS Code

Most clients that support MCP can use this server out of the box using a configuration similar to the following:

[!NOTE] If you are using an older version of the MCP, make sure to update your configuration to use the new package name powertools-for-aws-mcp.

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

This setup uses the Node.js package manager to run the MCP server locally and communicate with it using the STDIO interface.

Client-Specific Setup Instructions

For detailed setup instructions for specific clients, see the configurations below:

Getting Started with Amazon Q Developer CLI

Use in Amazon Q Developer CLI

See Amazon Q Developer CLI documentation for details.

Add MCP Server using CLI commands:

qchat mcp add --name powertools --command "npx -y powertools-for-aws-mcp"

Manual Configuration: If you select global scope, the MCP server configuration is stored in ~/.aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp.json within your current project.

~/.aws/amazonq/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

Getting Started with Kiro

Use in Kiro

See Kiro Model Context Protocol Documentation for details.

  1. Navigate to Kiro > MCP Servers
  2. Add a new MCP server by selecting the + Add button.
  3. Paste the configuration given below:

kiro_mcp_settings.json

For macOS/Linux:

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

For Windows:

{
  "mcpServers": {
    "powertools": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

Getting Started with Cursor

Getting Started with Cursor
  1. You can place MCP configuration in two locations, depending on your use case:

A. Project Configuration - For tools specific to a project, create a .cursor/mcp.json file in your project directory. - This allows you to define MCP servers that are only available within that specific project.

B. Global Configuration - For tools that you want to use across all projects, create a ~/.cursor/mcp.json file in your home directory. - This makes MCP servers available in all your Cursor workspaces.

.cursor/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}
  1. Using MCP in Chat: The Composer Agent will automatically use any MCP tools that are listed under Available Tools on the MCP settings page if it determines them to be relevant. To prompt tool usage intentionally, please prompt Cursor to use the desired MCP Server you wish to use. For example, Using the Powertools MCP Server, do...

  2. Tool Approval: By default, when the Agent wants to use an MCP tool, it will display a message asking for your approval. You can use the arrow next to the tool name to expand the message and see what arguments the Agent is calling the tool with.

Getting Started with Windsurf

Getting Started with Windsurf
  1. Access MCP Settings

    • Navigate to Windsurf - Settings > Advanced Settings or use the Command Palette > Open Windsurf Settings Page
    • Look for the "Model Context Protocol (MCP) Servers" section
  2. Add MCP Servers

    • Select "Add Server" to add a new MCP server
    • You can choose from available templates like GitHub, Puppeteer, PostgreSQL, etc.
    • Alternatively, select "Add custom server" to configure your own server
  3. Manual Configuration

    • You can also manually edit the MCP configuration file located at ~/.codeium/windsurf/mcp_config.json

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

Getting Started with VS Code

Install in VS Code

Configure MCP servers in VS Code settings or in .vscode/mcp.json (see VS Code MCP docs for more info.):

.vscode/mcp.json

{
  "mcpServers": {
    "powertools": {
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

Getting Started with Claude Code

Use in Claude Code

Add MCP Server using CLI commands:

claude mcp add powertools

Manual Configuration (Recommended): You can directly edit the configuration file located at ~/.claude.json. This approach is more flexible and allows you to see all configurations at once.

~/.claude.json

{
  "mcpServers": {
    "powertools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "powertools-for-aws-mcp"]
    }
  }
}

Restart Claude Code: After editing the config file, restart Claude Code for the changes to take effect.

Development

After cloning the repository, you can set up your development environment by running:

npm ci
npm run setup:hooks

After that you can run tests using npm t or npm run test:unit:coverage for coverage reports.

You can also run the server locally using: npm run dev, this will start an inspector server that lets you interact with the MCP server using a browser UI.

If you want, you can also configure the server to run with Amazon Q, Claude Desktop, or other LLM clients that support the Model Context Protocol (MCP) by using node as command and passing the --experimental-transform-types flag and the path to the src/index.ts file of this project.

For example, with Claude Code, you can add the server by running:

claude mcp add pt-dev node -- --experimental-transform-types /path/to/project/powertools-mcp/src/index.ts

Credits

Michael Walmsley at [ServerlessDNA.com](https:/


README truncated. View full README on GitHub.

Alternatives

Related Skills

Browse all skills
aws-advisor

Expert AWS Cloud Advisor for architecture design, security review, and implementation guidance. Leverages AWS MCP tools for accurate, documentation-backed answers. Use when user asks about AWS architecture, security, service selection, migrations, troubleshooting, or learning AWS. Triggers on AWS, Lambda, S3, EC2, ECS, EKS, DynamoDB, RDS, CloudFormation, CDK, Terraform, Serverless, SAM, IAM, VPC, API Gateway, or any AWS service.

4
ui-design-system

UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.

18
doc-reader

Efficiently consume and navigate external documentation sites. Use when researching APIs, libraries, or tools; when the user mentions docs, documentation, or references a docs URL; or when you need to understand how something works before implementing it.

4
api-documenter

Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.

4
openai-knowledge

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.

4
ydc-ai-sdk-integration

Integrate Vercel AI SDK applications with You.com tools (web search, AI agent, content extraction). Use when developer mentions AI SDK, Vercel AI SDK, generateText, streamText, or You.com integration with AI SDK.

2