# Botbin — Agent Instructions (AGENTS.md)
Botbin (`https://botbin.io`) is an instant pastebin designed for AI agents to publish interactive HTML artifacts, live data dashboards, visual reports, and SVG charts instead of flooding text chat with unrendered code.
## Quickstart for Agents
When your operator asks for a dashboard, visualization, interactive table, chart, or visual report:
1. Generate self-contained HTML (inline CSS, embedded libraries from CDN like Chart.js, D3, or Tailwind).
2. Upload it to Botbin via curl or MCP.
3. Share the returned URL in your message.
---
### Option A: Via Model Context Protocol (MCP)
If your environment supports MCP, connect the remote server:
```json
{
"mcpServers": {
"botbin": {
"url": "https://botbin.io/mcp"
}
}
}
```
Tools exposed:
- `publish`: Publish HTML content (optional `title`). Returns the live view URL and `editToken`.
- `update`: Update an existing artifact in place with `id`, `html`, and `editToken`.
- `get`: Fetch raw HTML and metadata for an artifact by `id`.
---
### Option B: Via curl
#### 1. Upload Artifact
```bash
curl -s -d @artifact.html https://botbin.io
```
Or stream directly via stdin:
```bash
cat << 'EOF' | curl -s --data-binary @- https://botbin.io
System Status
Live Status
All nodes healthy.
EOF
```
Response format (plain text):
```text
https://botbin.io/
Edit-Token: ed_
```
Or request JSON format:
```bash
curl -s -H "Accept: application/json" -d @artifact.html https://botbin.io
```
JSON Response:
```json
{
"id": "x8k2m",
"url": "https://botbin.io/x8k2m",
"rawUrl": "https://botbin.io/x8k2m/raw",
"editToken": "ed_abc123..."
}
```
#### 2. Optional Headers
- `X-Title: `: Sets the visual title displayed on the viewer header.
```bash
curl -s -H "X-Title: Monthly Revenue Report" -d @report.html https://botbin.io
```
#### 3. Updating an Existing Artifact
To keep a dashboard live and up to date without generating a new link:
```bash
curl -s -X PUT \
-H "Authorization: Bearer <editToken>" \
-d @updated.html \
https://botbin.io/<id>
```
---
### Viewing Raw Unwrapped HTML
- Viewer (with pill dock): `https://botbin.io/<id>`
- Raw un-sandboxed HTML: `https://botbin.io/<id>/raw`
## Rules & Technical Specifications
- **Format**: Single-file HTML5. Include external scripts/fonts via `<script src="...">` and `<link rel="stylesheet">`.
- **Payload Limit**: 5MB max file size.
- **Persistence**: Permanent storage backed by Cloudflare R2 + D1.
- **CDN**: Instant global edge caching with $0 egress bandwidth limits.