Samples
Agent samples built using the Strands Agents SDK.
What is Samples?
Samples is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent samples built using the strands agents sdk.
Agent samples built using the Strands Agents SDK.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Agent samples built using the Strands Agents SDK.
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx samplesConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Samples
The Strands Agents Samples repository provides a collection of reference implementations and demo agents built with the Strands Agents SDK, an AWS-developed framework for building AI agents in Python and TypeScript with a model-driven approach. The samples demonstrate patterns for multi-agent orchestration, RAG architectures, streaming responses, AWS Bedrock integration, and edge computing scenarios using just a few lines of code. Developers new to the Strands SDK use these samples as a starting point for understanding agent design patterns before building their own production agents.
Prerequisites
- Python 3.10+ and pip installed (for Python samples), or Node.js 18+ and npm (for TypeScript samples)
- AWS account with Bedrock model access enabled, or an alternative LLM provider API key
- strands-agents and strands-agents-tools packages installed
- An MCP client if integrating agent tools via MCP
Clone the samples repository
Clone the Strands Agents samples repository to explore the available agent examples.
git clone https://github.com/strands-agents/samples.git
cd samplesCreate a virtual environment and install dependencies
Set up an isolated Python environment and install the Strands Agents SDK and its tools package.
python -m venv venv
source venv/bin/activate # macOS/Linux
pip install strands-agents strands-agents-toolsConfigure model provider credentials
Set up credentials for your chosen LLM provider. For AWS Bedrock, configure your AWS credentials. For other providers, set the relevant API key environment variable.
# For AWS Bedrock:
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_DEFAULT_REGION=us-east-1Run a sample agent
Try the basic agent sample to confirm everything is working. The framework uses a model-driven approach where you describe what you want and the agent determines how to achieve it.
from strands import Agent
agent = Agent()
response = agent("Hello! Tell me a joke.")
print(response)Configure as an MCP server
To expose a Strands agent as an MCP tool, add it to your MCP client configuration.
{
"mcpServers": {
"samples": {
"command": "npx",
"args": ["samples"]
}
}
}Samples Examples
Client configuration
Basic MCP client configuration for a Strands Agents sample server.
{
"mcpServers": {
"strands-samples": {
"command": "python",
"args": ["-m", "strands_agent_server"],
"env": {
"AWS_DEFAULT_REGION": "us-east-1",
"AWS_ACCESS_KEY_ID": "your_access_key",
"AWS_SECRET_ACCESS_KEY": "your_secret_key"
}
}
}
}Prompts to try
Example prompts to explore Strands Agents capabilities.
- "Use the agent to summarize the latest AWS Bedrock announcements from the web"
- "Build a multi-agent pipeline where one agent retrieves data and another analyzes it"
- "Demonstrate a RAG agent that can answer questions about a local document collection"
- "Show me how to create a streaming agent that reports progress step by step"Troubleshooting Samples
ImportError when importing from strands or strands_agents
Make sure you have installed both packages: 'pip install strands-agents strands-agents-tools'. If running inside a virtual environment, confirm the environment is activated before running the sample.
AWS Bedrock access denied or model not found
Ensure you have enabled the specific Bedrock model in your AWS account's Bedrock console under 'Model access'. Also verify your IAM user or role has the 'bedrock:InvokeModel' permission.
Samples produce unexpected output or don't run as described
The samples are for demonstration and educational purposes and may require modification for production use. Check the individual sample README files in each subdirectory for specific setup requirements and known limitations.
Frequently Asked Questions about Samples
What is Samples?
Samples is a Model Context Protocol (MCP) server that agent samples built using the strands agents sdk. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Samples?
Follow the installation instructions on the Samples GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Samples?
Samples works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Samples free to use?
Yes, Samples is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Samples Alternatives — Similar Coding Agents Servers
Looking for alternatives to Samples? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Samples in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Samples?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.