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

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_deploy MCP tool with the finished HTML
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
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 Dropframe and the Server URL to https://dropframe.run/mcp
Click Connect — Grok will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically

Mistral Chat

Open Mistral Connections
Click Add Connections → Custom MCP Connector
Set the Server URL to https://dropframe.run/mcp
Click Connect — Mistral will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically

Claude Desktop

Edit 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", "@modelcontextprotocol/server-remote", "https://dropframe.run/mcp"],
      "env": { "MCP_TOKEN": "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
Turn on Developer Mode (requires Plus, Pro, Business, or Enterprise)
Go to Connectors → Add custom connector
Set the name to Dropframe and the Server URL to https://dropframe.run/mcp
Click Connect — ChatGPT will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically
MCP tools only run in Developer Mode chats, not standard mode

Cursor

Open Cursor Settings → Tools & Integrations
Click Add Custom MCP — this opens ~/.cursor/mcp.json
Add:

{
  "mcpServers": {
    "dropframe": {
      "url": "https://dropframe.run/mcp"
    }
  }
}

Save the file — Cursor will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically

Windsurf

Open Windsurf Settings → Cascade → MCP Servers
Click Add Server → Add custom server, or click View raw config to edit ~/.codeium/windsurf/mcp_config.json directly
Add:

{
  "mcpServers": {
    "dropframe": {
      "serverUrl": "https://dropframe.run/mcp"
    }
  }
}

Save and click Refresh — Cascade will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically

VS Code (Copilot Chat)

Open the Command Palette → MCP: Open User Configuration (opens mcp.json)
Add:

{
  "servers": {
    "dropframe": {
      "type": "http",
      "url": "https://dropframe.run/mcp"
    }
  }
}

Save — VS Code will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically
MCP tools only appear in Agent mode — select it from the Copilot Chat mode dropdown

Antigravity

Click ··· in the editor's Agent panel → MCP Servers
Click Manage MCP Servers → View raw config — this opens mcp_config.json
Add:

{
  "mcpServers": {
    "dropframe": {
      "serverUrl": "https://dropframe.run/mcp"
    }
  }
}

Save and restart Antigravity — it will prompt you to authorise via OAuth
No key needed; authorisation is handled automatically

Note: Antigravity uses serverUrl (not url, and not mcpServers → command), which differs from Cursor/VS Code — copying a config from those without renaming the key is the usual mistake here too.

MCP Tools Reference

Once connected, your AI has access to four tools:

Tool	What it does
`dropframe_deploy`	Deploy new HTML → returns a live URL
`dropframe_update`	Push new HTML 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   Required. Complete self-contained HTML. Inline all CSS and JS.
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   Required. New complete HTML to replace the app with.

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	Never
Custom domains	✗	✗	✓
Private apps	✗	✗	✓
No branding	✗	✗	✓

Free — deploy instantly, no credit card, apps expire after 14 days
Pro — permanent hosting, priority support
Max — everything in Pro plus custom domains, private-by-default apps and no Dropframe branding

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.run and 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.

Multi-file app support (ZIP bundles, asset uploads)
Custom subdomain selection (e.g. myproject.dropframe.run)
Collaborative editing — share edit access to an app
Version history — roll back to a previous deploy
Analytics — view visit counts per app
CLI deploy tool (npx dropframe deploy)
Team accounts / org workspaces
Webhook notifications (deploy events)

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_list or 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
Email	hello@dropframe.run
GitHub Issues	github.com/hassaanmaqsood/dropframe/issues
Gallery	dropframe.run/gallery
Linkedin	linkedin.com/company/dropframe-run
Instagram	instagram.com/getdropframe

Built with love and a bit of caffeine from Islamabad 🇵🇰