Skip to content
Back to search

mcp-server

This MCP server provides documentation about Strands Agents to your GenAI tools, so you can use your favorite AI coding assistant to vibe-code Strands Agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/strands-agents--mcp-server/badge.svg)](/listings/strands-agents--mcp-server)

HTML

<a href="/listings/strands-agents--mcp-server"><img src="/api/listings/strands-agents--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You can use the Strands Agents MCP server with [40+ applications that support MCP servers](https://modelcontextprotocol.io/clients), including Amazon Q Developer CLI, Anthropic Claude Code, Cline, and Cursor.

Get started quickly with one-click installation buttons for popular MCP clients. Click the buttons below to install servers directly in your IDE:

Kiro example

See the [Kiro documentation](https://kiro.dev/docs/mcp/configuration/) for instructions on managing MCP configuration.

In `~/.kiro/settings/mcp.json`:

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Q Developer CLI example

See the [Q Developer CLI documentation](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) for instructions on managing MCP configuration.

In `~/.aws/amazonq/mcp.json`:

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Claude Code example

See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#configure-mcp-servers) for instructions on managing MCP servers.

claude mcp add strands uvx strands-agents-mcp-server

Cline example

See the [Cline documentation](https://docs.cline.bot/mcp-servers/configuring-mcp-servers#editing-mcp-settings-files) for instructions on managing MCP configuration.

Provide Cline with the following information:

I want to add the MCP server for Strands Agents.
Here's the GitHub link: @https://github.com/strands-agents/mcp-server
Can you add it?"

Cursor example

See the [Cursor documentation](https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers) for instructions on managing MCP configuration.

In `~/.cursor/mcp.json`:

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

VS Code example

See the [VS Code documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for instructions on managing MCP configuration.

In your `mcp.json` file:

{
  "servers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 277 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. ### :warning: This repository has been archived
  3. **The Strands Agents MCP server has moved to the [strands-agents/harness-sdk](https://github.com/strands-agents/harness-sdk) monorepo.**
  4. The source code is now under [`strands-mcp/`](https://github.com/strands-agents/harness-sdk/tree/main/strands-mcp). All new development, issues, and pull requests should go there.
  5. </div>
  6. ---
  7. <div align="center">
  8. <div>
  9. <a href="https://strandsagents.com">
  10. <img src="https://strandsagents.com/latest/assets/logo-github.svg" alt="Strands Agents" width="55px" height="105px">
  11. </a>
  12. </div>
  13. <h1>
  14. Strands Agents MCP Server
  15. </h1>
  16. <h2>
  17. A model-driven approach to building AI agents in just a few lines of code.
  18. </h2>
  19. <div align="center">
  20. <a href="https://github.com/strands-agents/mcp-server/graphs/commit-activity"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/strands-agents/mcp-server"/></a>
  21. <a href="https://github.com/strands-agents/mcp-server/issues"><img alt="GitHub open issues" src="https://img.shields.io/github/issues/strands-agents/mcp-server"/></a>
  22. <a href="https://github.com/strands-agents/mcp-server/pulls"><img alt="GitHub open pull requests" src="https://img.shields.io/github/issues-pr/strands-agents/mcp-server"/></a>
  23. <a href="https://github.com/strands-agents/mcp-server/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/strands-agents/mcp-server"/></a>
  24. <a href="https://pypi.org/project/strands-agents-mcp-server/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/strands-agents-mcp-server"/></a>
  25. <a href="https://python.org"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/strands-agents-mcp-server"/></a>
  26. <a href="https://discord.gg/strands"><img alt="Strands Discord" src="https://img.shields.io/badge/Discord-Strands-5865F2?logo=discord&logoColor=white"/></a>
  27. </div>
  28. <p>
  29. <a href="https://strandsagents.com/">Documentation</a>
  30. ◆ <a href="https://github.com/strands-agents/samples">Samples</a>
  31. ◆ <a href="https://github.com/strands-agents/sdk-python">Python SDK</a>
  32. ◆ <a href="https://github.com/strands-agents/tools">Tools</a>
  33. ◆ <a href="https://github.com/strands-agents/agent-builder">Agent Builder</a>
  34. ◆ <a href="https://github.com/strands-agents/mcp-server">MCP Server</a>
  35. </p>
  36. </div>
  37. This MCP server provides curated documentation access to your GenAI tools via llms.txt files, enabling AI coding assistants to search and retrieve relevant documentation with intelligent ranking.
  38. ## Features
  39. - **Smart Document Search**: TF-IDF based search with Markdown-aware scoring that prioritizes titles, headers, and code blocks
  40. - **Section-Based Browsing**: Browse document structure via table of contents, then fetch only the section you need - more token-efficient than retrieving full pages
  41. - **Curated Content**: Indexes documentation from llms.txt files with clean, human-readable titles
  42. - **On-Demand Fetching**: Lazy-loads full document content only when needed for optimal performance
  43. - **Snippet Generation**: Provides contextual snippets with relevance scoring for quick overview
  44. - **Real URL Support**: Works with actual HTTPS URLs while maintaining backward compatibility
  45. ## Prerequisites
  46. The usage methods below require [uv](https://github.com/astral-sh/uv) to be installed on your system. You can install it by following the [official installation instructions](https://github.com/astral-sh/uv#installation).
  47. ## Installation
  48. You can use the Strands Agents MCP server with
  49. [40+ applications that support MCP servers](https://modelcontextprotocol.io/clients),
  50. including Amazon Q Developer CLI, Anthropic Claude Code, Cline, and Cursor.
  51. Get started quickly with one-click installation buttons for popular MCP clients. Click the buttons below to install servers directly in your IDE:
  52. [![Install in Kiro](https://img.shields.io/badge/Install-Kiro-9046FF?style=for-the-badge&logo=kiro)](https://kiro.dev/launch/mcp/add?name=strands-agents&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22strands-agents-mcp-server%22%5D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%22search_docs%22%2C%22fetch_doc%22%5D%7D)
  53. [![Install in Cursor](https://img.shields.io/badge/Install-Cursor-blue?style=for-the-badge&logo=cursor)](https://cursor.com/en-US/install-mcp?name=strands-agents&config=eyJjb21tYW5kIjoidXZ4IHN0cmFuZHMtYWdlbnRzLW1jcC1zZXJ2ZXIifQ%3D%3D)
  54. [![Install in VS Code](https://img.shields.io/badge/Install-VS_Code-FF9900?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22strands-agents%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22strands-agents-mcp-server%22%5D%7D)
  55. ### Kiro example
  56. See the [Kiro documentation](https://kiro.dev/docs/mcp/configuration/)
  57. for instructions on managing MCP configuration.
  58. In `~/.kiro/settings/mcp.json`:
  59. ```json
  60. {
  61. "mcpServers": {
  62. "strands-agents": {
  63. "command": "uvx",
  64. "args": ["strands-agents-mcp-server"],
  65. "env": {
  66. "FASTMCP_LOG_LEVEL": "INFO"
  67. },
  68. "disabled": false,
  69. "autoApprove": ["search_docs", "fetch_doc"]
  70. }
  71. }
  72. }
  73. ```
  74. ### Q Developer CLI example
  75. See the [Q Developer CLI documentation](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html)
  76. for instructions on managing MCP configuration.
  77. In `~/.aws/amazonq/mcp.json`:
  78. ```json
  79. {
  80. "mcpServers": {
  81. "strands-agents": {
  82. "command": "uvx",
  83. "args": ["strands-agents-mcp-server"],
  84. "env": {
  85. "FASTMCP_LOG_LEVEL": "INFO"
  86. },
  87. "disabled": false,
  88. "autoApprove": ["search_docs", "fetch_doc"]
  89. }
  90. }
  91. }
  92. ```
  93. ### Claude Code example
  94. See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#configure-mcp-servers)
  95. for instructions on managing MCP servers.
  96. ```bash
  97. claude mcp add strands uvx strands-agents-mcp-server
  98. ```
  99. ### Cline example
  100. See the [Cline documentation](https://docs.cline.bot/mcp-servers/configuring-mcp-servers#editing-mcp-settings-files)
  101. for instructions on managing MCP configuration.
  102. Provide Cline with the following information:
  103. ```
  104. I want to add the MCP server for Strands Agents.
  105. Here's the GitHub link: @https://github.com/strands-agents/mcp-server
  106. Can you add it?"
  107. ```
  108. ### Cursor example
  109. See the [Cursor documentation](https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers)
  110. for instructions on managing MCP configuration.
  111. In `~/.cursor/mcp.json`:
  112. ```json
  113. {
  114. "mcpServers": {
  115. "strands-agents": {
  116. "command": "uvx",
  117. "args": ["strands-agents-mcp-server"],
  118. "env": {
  119. "FASTMCP_LOG_LEVEL": "INFO"
  120. },
  121. "disabled": false,
  122. "autoApprove": ["search_docs", "fetch_doc"]
  123. }
  124. }
  125. }
  126. ```
  127. ### VS Code example
  128. See the [VS Code documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
  129. for instructions on managing MCP configuration.
  130. In your `mcp.json` file:
  131. ```json
  132. {
  133. "servers": {
  134. "strands-agents": {
  135. "command": "uvx",
  136. "args": ["strands-agents-mcp-server"]
  137. }
  138. }
  139. }
  140. ```
  141. ## Quick Testing
  142. You can quickly test the MCP server using the MCP Inspector:
  143. ```bash
  144. # For published package
  145. npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
  146. # For local development
  147. npx @modelcontextprotocol/inspector python -m strands_mcp_server
  148. ```
  149. Note: This requires [npx](https://docs.npmjs.com/cli/v11/commands/npx) to be installed on your system. It comes bundled with [Node.js](https://nodejs.org/).
  150. The Inspector is also useful for troubleshooting MCP server issues as it provides detailed connection and protocol information. For an in-depth guide, have a look at the [MCP Inspector documentation](https://modelcontextprotocol.io/docs/tools/inspector).
  151. ## Getting Started
  152. 1. **Install prerequisites**:
  153. - Install [uv](https://github.com/astral-sh/uv) following the [official installation instructions](https://github.com/astral-sh/uv#installation)
  154. - Make sure you have [Node.js](https://nodejs.org/) installed for npx commands
  155. 2. **Configure your MCP client**:
  156. - Choose your preferred MCP client from the installation examples above
  157. - Add the Strands Agents MCP server configuration to your client
  158. 3. **Test the connection**:
  159. ```bash
  160. # For published package
  161. npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
  162. # For local development
  163. npx @modelcontextprotocol/inspector python -m strands_mcp_server
  164. ```
  165. 4. **Start using the documentation tools**:
  166. - `search_docs` - Find relevant documentation with intelligent ranking
  167. - `fetch_doc` - Browse a page's structure and preamble, then read individual sections
  168. - The server automatically indexes curated content from llms.txt files
  169. ## Server Development
  170. ```bash
  171. git clone https://github.com/strands-agents/mcp-server.git
  172. cd mcp-server
  173. python3 -m venv venv
  174. source venv/bin/activate
  175. pip3 install -e ".[dev]"
  176. npx @modelcontextprotocol/inspector python -m strands_mcp_server
  177. ```
  178. ### Running Tests
  179. ```bash
  180. # Unit tests (fast, no network access required)
  181. pytest tests/
  182. # Integration tests (requires network access to strandsagents.com)
  183. pytest tests_integ/ -v
  184. # All tests
  185. pytest tests/ tests_integ/ -v
  186. ```
  187. To skip integration tests (e.g., in CI environments without network access):
  188. ```bash
  189. SKIP_INTEG_TESTS=1 pytest tests_integ/
  190. ```
  191. ## Contributing ❤️
  192. We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details on:
  193. - Reporting bugs & features
  194. - Development setup
  195. - Contributing via Pull Requests
  196. - Code of Conduct
  197. - Reporting of security issues
  198. ## Stay in touch with the team
  199. Come meet the Strands team and other users on [**Discord**](https://discord.com/invite/strands)
  200. ## License
  201. This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
  202. ## Security
  203. See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.