Dropframe Documentation & Setup Guide
Your AI builds it. Dropframe hosts it.
Ask Claude (or any AI) to build something — it goes live in under a second via MCP.
dropframe.run · Gallery · Pricing · Issues
Table of Contents
- What is Dropframe?
- How it Works
- Quickstart — Try it Now
- Connecting Your AI
- MCP Tools Reference
- Plans & Pricing
- Referral Rewards
- Troubleshooting
- Roadmap
- Reporting Issues & Contributing
- Policies & Legal
- Contact & Community
What is Dropframe?
Dropframe is an LLM-native web hosting platform.
It gives your AI assistant a direct "deploy" superpower — instead of generating HTML you have to save, upload, and configure, your AI calls a single MCP tool and your app is live at a public URL in under a second.
No DevOps. No config files. No domain registration. Just a live link.
It works with any AI that supports the Model Context Protocol (MCP): Claude, Mistral, ChatGPT, Cursor, Windsurf, and more.
How it Works
You ask your AI to build something
↓
Your AI writes HTML + calls dropframe_deploy(html)
↓
Dropframe stores it on Cloudflare's edge
↓
Your app is live at dropframe.run/preview/{id} instantly
- Ask your AI — "Build me a budget tracker" or "Make a countdown to my birthday"
- It deploys automatically — the AI calls the
dropframe_deployMCP tool with the finished HTML (or backend Worker code) - Share the link — a public URL is returned immediately; share it, embed it, iterate on it
Quickstart — Try it Now
- Click Sign in → create an account (using Google)
- Go to your Dashboard
- Paste any HTML in the deploy box and click Deploy now OR Copy your Connection Key from the AI Connections panel, and Connect your AI
- Or deploy directly from your terminal using the CLI:
npx dropframe deploy - Your app is live instantly at a
dropframe.run/preview/{id}URL
Connecting Your AI
All methods use the MCP server at https://dropframe.run/mcp.
You will need your Connection Key from the dashboard. Refer to your editor's MCP documentation for where to configure the server URL.
Claude.ai
- Open Claude Settings → Connectors
- Click Add custom connector
- Set the Server URL to
https://dropframe.run/mcp - Click Connect — Claude will prompt you to authorise via OAuth
- No key needed; authorisation is handled automatically
Grok.com
- Open Grok Connectors
- Click Add connector (in the top-right) → Custom
- Set the name to
Dropframeand the Server URL tohttps://dropframe.run/mcp - Click Connect — Grok will prompt you to authorise via OAuth
- No key needed; authorisation is handled automatically
Mistral Chat
- Open Mistral Settings → Connectors
- Add a new MCP server with URL
https://dropframe.run/mcp - Click Connect — Mistral will prompt you to authorise via OAuth
- Authorisation is handled automatically
Claude Desktop
Add this to your claude_desktop_config.json:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"dropframe": {
"command": "npx",
"args": [
"-y",
"dropframe-mcp",
"--key",
"YOUR_CONNECTION_KEY_HERE"
]
}
}
}
Replace YOUR_CONNECTION_KEY_HERE with the key from your dashboard. Restart Claude Desktop.
ChatGPT
- Open ChatGPT Settings → Apps & Connectors → Advanced Settings
- Enable Developer Mode
- Go to Settings → Connected Apps
- Click Add Connection (or +)
- Fill in the connection details:
- Name:
Dropframe - Server URL:
https://dropframe.run/mcp - Authentication: select OAuth
- Name:
- Click Connect — ChatGPT will prompt you to authorise via OAuth
- Click Authorize to link your Dropframe account
Cursor
Add to your .cursor/mcp.json (or Cursor Settings → MCP):
{
"mcpServers": {
"dropframe": {
"serverUrl": "https://dropframe.run/mcp"
}
}
}
Cursor would automatically ask to authenciate it for you via OAuth, and save your connection key in its config.
Windsurf
Add to your ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"dropframe": {
"serverUrl": "https://dropframe.run/mcp"
}
}
}
Save and restart Windsurf. It will also prompt you to authenticate via OAuth, and save your connection key.
VS Code (Copilot Chat)
Add to your VS Code user settings.json:
{
"github.copilot.chat.mcp.servers": {
"dropframe": {
"serverUrl": "https://dropframe.run/mcp"
}
}
}
Save and refresh VS Code MCP servers list. It will also prompt you to authenticate via OAuth, and save your connection key.
Antigravity
Antigravity natively supports Dropframe via MCP.
To connect Dropframe to Antigravity:
- Open Settings (gear icon) → MCP Servers
- Click Open MCP Config
- Add this line to the JSON configuration:
"servers": {
"dropframe": {
"serverUrl": "https://dropframe.run/mcp"
}
}
- Save file, and refresh Antigravity MCP servers list. It will also prompt you to authenticate via OAuth, and save your connection key.
MCP Tools Reference
Once connected, your AI has access to four tools:
| Tool | What it does |
|---|---|
dropframe_deploy |
Deploy new HTML or backend Worker → returns a live URL |
dropframe_update |
Push new HTML or Worker script to an existing app (same URL) |
dropframe_delete |
Permanently delete an app |
dropframe_list |
List all your deployed apps with URLs and status |
dropframe_deploy
html string Optional. Complete self-contained HTML. Inline all CSS and JS.
script string Optional. [Pro/Max only] Complete backend Worker JavaScript code.
name string Optional. Human-readable name (shown in dashboard).
customDomain string Optional. Max only. Custom domain (e.g. myapp.example.com).
Returns: live URL, app ID, tier note.
dropframe_update
id string Required. App ID from the original deploy.
html string Optional. New complete HTML to replace the app with.
script string Optional. [Pro/Max only] New complete backend Worker JavaScript code.
Returns: same URL, confirms update. The URL never changes on update.
dropframe_delete
id string Required. App ID to permanently delete.
dropframe_list
No parameters. Returns all your apps with names, URLs, tiers, and expiry status.
Plans & Pricing
| Free | Pro | Max (Coming Soon!) | |
|---|---|---|---|
| Price | $0 | $5/mo | $12/mo |
| App slots | 5 | 8 | 20 |
| Expiry | 14 days | Never (Permanent) | Never (Permanent) |
| App types | Static HTML | HTML + Backend Workers & DB | HTML, Workers, Containers |
| Visibility | Public by default (private toggle in dashboard) | Public by default (private toggle in dashboard) | Public by default (private toggle in dashboard) |
| Custom domains | ✗ | ✗ | ✓ |
| Branding | Dropframe badge | None | None (White-label) |
- Free — deploy instantly, no credit card, apps expire after 14 days, public by default with private toggle in dashboard
- Pro — permanent hosting, backend Workers & isolated SQLite database gateway, priority support, zero branding
- Max — everything in Pro plus custom domains, white labeling, container runtimes and advanced compute caps
Upgrade at any time from your dashboard or the pricing page.
Referral Rewards
Share your referral link from the Invite & Earn panel in your dashboard.
| Your tier | Reward per referral |
|---|---|
| Free | +7 free hosting days per app |
| Pro | +1 extra app slot |
| Max | 1 free month of Max |
Rewards are applied the moment a referred user signs up. A second reward is applied if they upgrade to a paid plan.
Your unique referral link: https://dropframe.run?ref=YOUR_CODE
Find your code on the dashboard → Invite & Earn.
Troubleshooting
My AI says it can't find the Dropframe tools
- Confirm the MCP server URL is exactly
https://dropframe.run/mcp - Check your connection key is correctly set (no extra spaces)
- For Claude Desktop: restart the app after editing the config file
- For Claude.ai: disconnect and reconnect the custom connector
- Test the connection by asking your AI: "Use dropframe_list to show my apps"
Deploy succeeded but the URL isn't loading
- Wait 2–3 seconds — Cloudflare propagates globally very fast but not instantly
- Hard-refresh the page (
Ctrl+Shift+R/Cmd+Shift+R) - Check that your HTML is self-contained (all CSS and JS inlined — no external
<link>or<script src>pointing to local files)
My app disappeared
Free-tier apps expire after 14 days. The app and its URL are permanently deleted at expiry. Upgrade to Pro or Max for permanent hosting, or redeploy before expiry.
I hit my app slot limit
The dropframe_deploy tool will return an error: "Capacity reached."
Either delete an existing app via dropframe_delete (or the dashboard) or upgrade your plan.
The connection key stopped working
Keys can be rotated from the AI Connections panel in your dashboard. Rotating invalidates the old key immediately — update it in all your AI configs.
I can't sign in / OAuth isn't working
- Clear cookies for
dropframe.runand try again - Try a different browser or incognito mode
- If the issue persists, open an issue with your browser and OS
Something else is broken
Open an issue on GitHub with as much detail as possible (see below).
Roadmap
These are things being actively considered or worked on. Not all will ship.
- ✅ Backend Workers & Managed DB Gateway (Pro & Max)
- ✅ Dynamic Policy Engine & Anti-Escalation Gate
- ⏳ Multi-file app support (ZIP bundles, asset uploads)
- ⏳ Container execution runtime (Max)
- ⏳ Automated QA browser testing
- ⏳ Analytics — view visit counts per app
- ⏳ Team accounts & shared workspaces
- ⏳ Collaborative editing — share edit access to an app
- ⏳ Version history — roll back to a previous deploy
- ⏳ Webhook notifications (deploy events)
- ⏳ CI/CD integration
Have a feature request? Open an issue with the enhancement label.
Reporting Issues & Contributing
GitHub Issues is the primary support channel for bugs and feature requests.
→ github.com/hassaanmaqsood/dropframe/issues
Before opening an issue
- Search existing issues to avoid duplicates
- Check the Troubleshooting section above
Bug reports
Please include:
- What happened — describe the problem clearly
- What you expected — what should have happened instead
- Steps to reproduce — exact steps so the issue can be replicated
- Your setup — which AI client, OS, browser (if relevant)
- Error messages — paste any error text verbatim
- App ID — if the issue is with a specific deployed app, include its ID (from
dropframe_listor the dashboard)
Feature requests
Open an issue with the enhancement label. Describe what you want and why it would be useful.
Security vulnerabilities
Do not open a public issue for security vulnerabilities.
Email hello@dropframe.run or see the Security Policy.
Policies & Legal
| Document | URL |
|---|---|
| Terms of Service | dropframe.run/terms |
| Privacy Policy | dropframe.run/privacy |
| Acceptable Use Policy | dropframe.run/acceptable-use |
| Cookie Policy | dropframe.run/cookies |
| Security Policy | dropframe.run/security |
| DMCA Policy | dropframe.run/dmca |
| Refund Policy | dropframe.run/refunds |
| Data Processing Agreement | dropframe.run/dpa |
Contact & Community
| Channel | Link |
|---|---|
| Website | dropframe.run |
| hello@dropframe.run | |
| GitHub Issues | github.com/hassaanmaqsood/dropframe/issues |
| Gallery | dropframe.run/gallery |
| linkedin.com/company/dropframe-run | |
| instagram.com/getdropframe | |
| Product Hunt | producthunt.com/products/dropframe |
| Indie Hackers | indiehackers.com/product/dropframe |
Built with love and a bit of caffeine from Islamabad 🇵🇰