BotDojo Chat SDK
Beta

Build AI Agents That See and Act In Your App

Give agents visibility into what users see and let them act on their behalf. Rich UI experiences, API calls, and open standardsโ€”all in one SDK.

โšก Quick Start
$npm install -g @botdojo/cli && botdojo playground

Installs CLI, clones repo, installs dependencies, and sets up your project

How AI is changing the way people work

The best AI products aren't chat boxes bolted onto the sideโ€”they're agents deeply integrated into the workflow. Look at what's working:

Cursor AI
Edit code by describing what you wantโ€”the agent sees your codebase and makes changes directly
Replit Agent
Builds entire apps from a prompt, deploying and debugging as it goes
Notion AI
Restructures your docs and databases without leaving the page
Shopify Sidekick
Updates inventory and creates discounts through conversation

What do these have in common? The AI isn't a separate experienceโ€”it's woven into the product. Users stay in their flow while the agent works alongside them.

โœจBotDojo Chat SDK Features

๐ŸŽฏ
Agentic UI
Agent sees & acts in your app
๐ŸŒŠ
Real-time Streaming
See responses as they generate
๐ŸŽจ
MCP Apps
Open standard for rich UI cards
๐Ÿ’พ
Persistence
Sessions, messages, app state

Two Ways to Deploy

Use our ready-made chat widget or build a completely custom UI with hooks.

๐Ÿ’ฌ
READY TO USE

BotDojo Chat

Drop-in chat widget with streaming, tools, and MCP Apps. No server required.

Data Flow

๐ŸŒ
Your Website
๐ŸŽจFrontend MCP
๐Ÿ’ฌ
Chat Widget
โ˜๏ธ
BotDojo Cloud
๐Ÿ”ŒYour API
โšกIntegrations
๐Ÿ”—MCP Servers
Click Animate to see the flow
WHAT YOU GET
โœ“ Zero server setupโœ“ Full streaming UXโœ“ MCP Apps includedโœ“ Multiple layouts
๐Ÿ“„BotDojo Chattsx
1import { BotDojoChat } from '@botdojo/chat-sdk';
2
3function App() {
4 return (
5 <BotDojoChat
6 apiKey="your-api-key"
7 mode="popup" // or "inline", "side-panel"
8 modelContext={{
9 tools: [/* your frontend tools */],
10 resources: [/* dynamic context */],
11 }}
12 />
13 );
14}
Try BotDojo Chat โ†’
๐ŸŽจ
FULL CONTROL

Custom Chat UI

Build your own chat interface. BotDojo handles the backendโ€”you control every pixel.

Data Flow

๐ŸŽจ
Your Website
Custom Chat UI
๐ŸŽจFrontend MCP
๐Ÿ“ก
SDK Hooks
โ˜๏ธ
BotDojo Cloud
๐Ÿ”ŒYour API
โšกIntegrations
๐Ÿ”—MCP Servers
Click Animate to see the flow
WHAT YOU GET
โœ“ Custom componentsโœ“ Event streaming hooksโœ“ Headless controlโœ“ Full design freedom
๐Ÿ“„Custom Chat UItsx
1import {
2 BotDojoChatProvider,
3 useChatMessages,
4 useChatActions,
5 McpAppHost,
6} from '@botdojo/chat-sdk';
7
8function CustomChatUI() {
9 const { messages } = useChatMessages();
10 const { sendMessage } = useChatActions();
11
12 return (
13 <div className="my-chat">
14 {messages.map(msg => (
15 <div key={msg.id}>
16 <MyMessage message={msg} />
17 {msg.mcpApp && <McpAppHost mcpAppData={msg.mcpApp} />}
18 </div>
19 ))}
20 <MyInput onSend={sendMessage} />
21 </div>
22 );
23}
Try Custom Chat UI โ†’

BotDojo Handles the Hard Parts

๐Ÿ”ŒCommunicationStreaming, reconnection, tool calls
๐Ÿ”’SecurityCORS, sandboxing, CSP
๐Ÿ’พPersistenceSessions, messages, MCP App state
๐Ÿ“Open StandardsMCP + MCP Apps spec compliant