Interactive UI applications for AI chatbots using MCP Apps SDK.
MCP Apps is an extension to the Model Context Protocol that allows MCP servers to return rich, interactive user interfaces alongside tool results. Instead of just text responses, your AI assistant can display:
- Interactive dashboards
- Data visualizations
- Forms and wizards
- Real-time monitors
- And more...
| App | Description | Status |
|---|---|---|
forms-app |
Forms management dashboard, survey builder, analytics | Planned |
content-app |
Content management, post editor, series organizer | Planned |
files-app |
File browser, upload manager, access control dashboard | Planned |
jarvis-app |
AI agent management, conversation viewer | Planned |
- Node.js >= 18.0.0
- pnpm >= 8.0.0
- 23blocks API credentials
# Clone the repo
git clone https://github.com/23blocks-OS/ai-agents-apps.git
cd ai-agents-apps
# Install dependencies
pnpm install
# Set environment variables
export BLOCKS_API_URL="https://api.23blocks.com"
export BLOCKS_API_KEY="your-app-id"
export BLOCKS_AUTH_TOKEN="your-bearer-token"
# Run development server
pnpm dev| Variable | Description |
|---|---|
BLOCKS_API_URL |
23blocks API base URL |
BLOCKS_API_KEY |
Your application ID (AppId header) |
BLOCKS_AUTH_TOKEN |
Bearer token for authentication |
ai-agents-apps/
├── apps/ # MCP App applications
│ ├── forms-app/ # Forms Block dashboard
│ ├── content-app/ # Content Block dashboard
│ ├── files-app/ # Files Block dashboard
│ └── jarvis-app/ # Jarvis Block dashboard
├── packages/ # Shared packages
│ ├── shared-ui/ # Common UI components
│ ├── api-client/ # 23blocks API client
│ └── mcp-utils/ # MCP Apps utilities
├── examples/ # Example apps
│ └── minimal-app/ # Minimal MCP App example
└── docs/ # Documentation
Each app consists of:
- MCP Server - Registers tools and serves UI resources
- UI Application - React app with interactive components
See docs/creating-apps.md for detailed guide.
- Fork the repo
- Create feature branch (
feat/my-feature) - Make changes
- Submit PR
MIT - See LICENSE for details.