Strands Agents MCP Server

A model-driven approach to building AI agents in just a few lines of code.

Documentation ◆ Samples ◆ Python SDK ◆ Tools ◆ Agent Builder ◆ MCP Server

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.

Features

• Smart Document Search: TF-IDF based search with Markdown-aware scoring that prioritizes titles, headers, and code blocks
• Section-Based Browsing: Browse document structure via table of contents, then fetch only the section you need - more token-efficient than retrieving full pages
• Curated Content: Indexes documentation from llms.txt files with clean, human-readable titles
• On-Demand Fetching: Lazy-loads full document content only when needed for optimal performance
• Snippet Generation: Provides contextual snippets with relevance scoring for quick overview
• Real URL Support: Works with actual HTTPS URLs while maintaining backward compatibility

Prerequisites

The usage methods below require uv to be installed on your system. You can install it by following the official installation instructions.

Installation

You can use the Strands Agents MCP server with
40+ applications that support MCP servers,
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
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
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
for instructions on managing MCP servers.

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

Cline example

See the Cline documentation
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
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
for instructions on managing MCP configuration.

In your mcp.json file:

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

Quick Testing

You can quickly test the MCP server using the MCP Inspector:

# For published package
npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server

# For local development
npx @modelcontextprotocol/inspector python -m strands_mcp_server

Note: This requires npx to be installed on your system. It comes bundled with Node.js.

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.

Getting Started

1. Install prerequisites:

   • Install uv following the official installation instructions
   • Make sure you have Node.js installed for npx commands

2. Configure your MCP client:

   • Choose your preferred MCP client from the installation examples above
   • Add the Strands Agents MCP server configuration to your client

3. Test the connection:

   # For published package
   npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
   
   # For local development
   npx @modelcontextprotocol/inspector python -m strands_mcp_server
   

4. Start using the documentation tools:

   • search_docs - Find relevant documentation with intelligent ranking
   • fetch_doc - Browse a page's structure and preamble, then read individual sections
   • The server automatically indexes curated content from llms.txt files

Server Development

git clone https://github.com/strands-agents/mcp-server.git
cd mcp-server
python3 -m venv venv
source venv/bin/activate
pip3 install -e ".[dev]"

npx @modelcontextprotocol/inspector python -m strands_mcp_server

Running Tests

# Unit tests (fast, no network access required)
pytest tests/

# Integration tests (requires network access to strandsagents.com)
pytest tests_integ/ -v

# All tests
pytest tests/ tests_integ/ -v

To skip integration tests (e.g., in CI environments without network access):

SKIP_INTEG_TESTS=1 pytest tests_integ/

Contributing ❤️

We welcome contributions! See our Contributing Guide for details on:

• Reporting bugs & features
• Development setup
• Contributing via Pull Requests
• Code of Conduct
• Reporting of security issues

Stay in touch with the team

Come meet the Strands team and other users on Discord

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Security

See CONTRIBUTING for more information.