Open-source MCP-Native Agent framework and standalone MCP Host that transforms MCP Servers into rich AI Agents, with multi-model support, embeddable deployment, and a built-in interactive chat client.
Nanobot is an open-source Agent framework built specifically for the MCP (Model Context Protocol) ecosystem, positioned as a standalone, customizable MCP Host. Maintained by the nanobot-ai organization (Obot.ai team) under the Apache 2.0 license.
Core Features#
MCP-Native Design#
- Built from the ground up for the MCP ecosystem
- Full support for MCP features: tools, prompts, sampling, elicitation, and more
- All functionality delivered through MCP servers, framework itself is not tied to specific implementations
Every Agent is an MCP Server#
Each Nanobot agent is also an MCP server, accessible by any MCP client, enabling Agent ↔ MCP Server bidirectional mapping.
MCP-UI Support#
- First-class MCP-UI specification support
- Render interactive React components within chat clients
- Build playable games (e.g., Blackjack), shopping carts, dashboards, and rich interactive experiences
Multi-Model Support#
- OpenAI (gpt-4 series)
- Anthropic (claude-3 series)
Flexible Configuration#
Single-file Configuration (nanobot.yaml):
agents:
dealer:
name: Blackjack Dealer
model: gpt-4.1
mcpServers: blackjackmcp
mcpServers:
blackjackmcp:
url: https://blackjack.nanobot.ai/mcp
Directory-based Configuration:
my-config/
├── agents/ # Agent definitions
│ ├── main.md # Main agent (auto-set as entry point)
│ └── helper.md # Additional agent
└── mcp-servers.yaml # MCP server definitions
Embeddable Deployment#
- Complete MCP Host with interactive chat client
- Deployable in any environment
- Embeddable into any application or website
Installation & Quick Start#
# Install via Homebrew
brew install nanobot-ai/tap/nanobot
# Set API Keys
export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
# Run
nanobot run ./nanobot.yaml
# Access Web UI
# http://localhost:8080
Official Examples#
| Example | Description |
|---|---|
| Blackjack Game | 21 card game agent |
| Hugging Face MCP | HuggingFace integration agent |
| Shopping/Shopify | E-commerce shopping assistant |
Use Cases#
- Custom AI chatbots
- Gamified interactive experiences
- E-commerce shopping assistants
- Enterprise AI Agent integration
- Multi-channel deployment (Slack, SMS, email, embedded web agents)
Project Status#
- Current Version: v0.0.55
- Stage: Alpha, under active development
- Contributors: 12