Skip to main content

Strands Agents MCP Server

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

GitHub commit activity GitHub open issues GitHub open pull requests License PyPI version Python versions Strands Discord

Documentation ◆ Samples ◆ CLI ◆ MCP Server
Harness (Python, TypeScript) ◆ SDK (Python, TypeScript) ◆ Box ◆ Shell ◆ Evals ◆ Labs

This MCP server provides curated documentation access to your GenAI tools via llms.txt files, enabling AI coding assistants to find pages by title and retrieve their contents.

Features

  • Document Search: Field-weighted BM25 ranking over page titles, URL paths, and llms.txt descriptions, extended to page content once a page is hydrated (fetched), so body terms become searchable
  • 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: Hydrates the top-ranked pages to provide contextual previews
  • Real URL Support: Works with actual HTTPS URLs while maintaining backward compatibility

Tool behavior

  • search_docs(query, k, alternate_queries) ranks by page title, URL path, and llms.txt description, and by page content once a page has been hydrated. Both title-like keywords and body terms work; call fetch_doc to inspect a result's contents. The changelog index, which concatenates every release note, is ranked by title and description only.
  • alternate_queries takes up to 4 other phrasings of the same question. Each phrasing is searched and the rankings are combined with reciprocal rank fusion, so pages matched by several phrasings rank first. Phrasings that tokenize the same as an earlier one are searched once.
  • Search scores are unbounded field-weighted BM25 values, or fused rank scores when alternate_queries are given. They are useful only for ordering results from the same query; they are not probabilities and should not be compared across queries.
  • search_docs returns an empty list when no document matches. If a matched page cannot be fetched for its snippet, the result still includes the URL and title.
  • fetch_doc returns {"error": "...", "url": "...", "hint": "..."} for unsupported URLs, URLs that are not in the docs catalog (with the closest catalog URLs as suggestions), and unknown section IDs (with the valid sections); section is ignored when the full document is returned automatically. A catalog page that cannot be fetched is reported as a tool error (isError: true).
  • find_integrations(query, type, language, maintained_by, sdk, limit) filters the integrations catalog feed at https://strandsagents.com/integrations.json, fetched on first use and cached for 10 minutes. It returns the total match count and up to limit results carrying the maintainer, install commands, and a docs URL; on-site docs URLs can be passed to fetch_doc. A failed refresh keeps serving the cached copy; a feed that has never loaded is reported as a tool error.
  • All tools are annotated read-only and idempotent, and the server sends instructions telling clients when to use it and in which order to call the tools.

Configuration

  • STRANDS_MCP_PREFETCH_ALL: when set to a truthy value (1, true, yes), the server prefetches and indexes all pages in the background at startup, so body-term search works immediately instead of only after a page has been hydrated by a prior query. Defaults to off. Prefetch is best-effort and eventually consistent: results may be title-only until background hydration completes.

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:

Install in Kiro Install in Cursor Install in VS Code

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/harness-sdk/tree/main/strands-mcp
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:

  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
    • find_integrations - Filter the integrations catalog by type, language, and maintainer
    • The server automatically indexes curated content from llms.txt files

Server Development

git clone https://github.com/strands-agents/harness-sdk.git
cd harness-sdk/strands-mcp
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.

Metadata

Release files for strands-agents-mcp-server 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strands-agents-mcp-server 0.4.0
File Size Uploaded Provenance Actions
strands_agents_mcp_server-0.4.0.tar.gz 50.2 kB With provenance Details for strands_agents_mcp_server-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for strands-agents-mcp-server 0.4.0
File Interpreter ABI Platform Actions
strands_agents_mcp_server-0.4.0-py3-none-any.whl Python 3 none any Details for strands_agents_mcp_server-0.4.0-py3-none-any.whl

Total release size: 82.2 kB

Release files / strands_agents_mcp_server-0.4.0.tar.gz

Download URL strands_agents_mcp_server-0.4.0.tar.gz
Size 50.2 kB
Tags Source
SHA-256 checksum
How to use checksums
0a54600e1ab2098e5dd5dcc605bd8e37711b96b96d37747b23dabef06ba069ab
BLAKE2b-256 checksum
How to use checksums
1dc232b94a4a23ef191cf7be23083a26a46642232bf5620e091087095af4d2cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / strands_agents_mcp_server-0.4.0-py3-none-any.whl

Download URL strands_agents_mcp_server-0.4.0-py3-none-any.whl
Size 32.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
51880c686fba3153df33c355447720bcd85496c15db4b116fdec8d9371fd2ef9
BLAKE2b-256 checksum
How to use checksums
6703571938728f2099661e1c1fdbedb754c227cbefbd0d901ab113ed600ae267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for strands-agents-mcp-server 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for strands_agents_mcp_server-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page