For AI assistants · MCP connector docs
RunCabin is the easiest way to connect and manage your website with AI. RunCabin lets an AI assistant deploy real websites for you - an instant free HTTPS subdomain in one tool call, and a real custom domain when you're ready. Sign-in happens in your browser, so chat apps need no key to paste, and a domain you buy through RunCabin gets registration, DNS and TLS set up for you; a domain you already own needs two records at your provider.
Green data center100% hydropower
New to this? The plain-language walkthrough shows it in four steps. Overview, limits and prices: website hosting for AI agents.
server https://runcabin.com/mcp
transport Streamable HTTP
auth OAuth 2.1 in the browser, or an API key
registry com.runcabin/cabin
paid steps human-approved checkout, always
Setup · Claude
In Claude, open Customize → Connectors (claude.ai/customize/connectors) and choose Add custom connector.
Enter the server URL: https://runcabin.com/mcp
Claude opens RunCabin's sign-in page - sign in with Google or email, then click Authorize. New here? Signing in creates your free RunCabin account on the spot.
Done. Try: "Make me a one-page website and put it online." - you never need to name RunCabin or a tool; just say what you want live.
Looking for RunCabin in Claude's built-in connector directory? Our listing is coming soon - until then, adding the server URL above does exactly the same thing and works today.
Setup · Muse
In a chat with Muse, ask it to create a custom connector for RunCabin, and give it the server URL: https://runcabin.com/mcp. For example: "Create a custom connector for RunCabin at https://runcabin.com/mcp."
When the sign-in step comes up, sign in to RunCabin on runcabin.com with Google or email, then click Authorize. New here? Signing in creates your free RunCabin account.
In Muse's Settings, choose whether Muse asks for your approval before each action it takes with RunCabin.
Done. Try: "Make me a one-page website for my business and put it online."
In a browser, Muse would have to sign up for hosting, upload files and edit DNS step by step. Through RunCabin, publishing is one call that returns a live address.
Setup · Coding tools
RunCabin is published on the official MCP Registry as com.runcabin/cabin. Every tool below signs you in to RunCabin in your browser on first connect - there is no API key to paste.
claude mcp add --transport http runcabin https://runcabin.com/mcpThen run /mcp, pick runcabin, and sign in via the browser window that opens. Add --scope user to the command to enable it across all your projects.
Or add it by hand under mcpServers in ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
"runcabin": { "url": "https://runcabin.com/mcp" }Or run MCP: Add Server from the command palette and add this under servers in .vscode/mcp.json:
"runcabin": { "type": "http", "url": "https://runcabin.com/mcp" }Add this under mcpServers in ~/.codeium/windsurf/mcp_config.json:
"runcabin": { "serverUrl": "https://runcabin.com/mcp" }The sign-in opens automatically after you add the server.
Setup · Everything else
RunCabin speaks standard MCP over Streamable HTTP with OAuth 2.1 (authorization code + PKCE, dynamic client registration). Any spec-conforming client can connect to https://runcabin.com/mcp - discovery starts from the standard /.well-known/oauth-protected-resource metadata.
Clients that prefer static credentials can send a RunCabin API key as a Bearer token instead: mint one at runcabin.com/keys, or let the tool get its own through the device sign-in below.
Setup · Terminal
A script, CLI or coding agent that calls the REST API at https://runcabin.com/v1 can get its own API key without anyone typing a password into it or pasting a key. The tool asks for a sign-in code, you approve it in your browser, and the tool picks up the key.
1. Start. The tool asks for a code:
curl -s -X POST https://runcabin.com/v1/login/start \
-H "Content-Type: application/json" \
-d '{"clientName": "My deploy script"}'The answer carries a deviceCode (the tool keeps it to itself), a userCode such as BCDF-GHJK and a verificationUrlComplete link. The tool shows you the link and the code. Open the link, sign in, check that the code matches, and press Approve.
2. Poll. Every 5 seconds the tool asks for its key:
curl -s -X POST https://runcabin.com/v1/login/token \
-H "Content-Type: application/json" \
-d '{"deviceCode": "cabin_dc_..."}'Until you approve, the answer is authorization_pending (or slow_down if the tool polls too fast). Once you approve, it returns the key, one time only: {"ok": true, "key": "cabin_live_...", ...}. The tool sends it as Authorization: Bearer cabin_live_.... A denied request answers access_denied, and a request expires after 10 minutes (expired_token).
You can see and revoke every key at runcabin.com/keys, and we email you each time a tool gets one. RunCabin never emails or texts you a code to approve: only approve a request you started yourself.
Reference · The toolbox
Everything the server exposes. write tools change your sites; read-only tools just look.
| Tool | What it does | Access |
|---|---|---|
cabin_build_guide | RunCabin's build guide for assistants: hosting limits, forms, page basics, and the design and honest-content rules RunCabin's own builder follows. Every publish reply lists anything the files miss, so the assistant fixes it and publishes again. | read-only |
cabin_get_pricing | Current prices (free subdomain; $4.99/mo or $47.99/yr on your own domain) and where sites are hosted. | read-only |
cabin_publish | Puts a page or site online in one call - creates the site (or updates an existing one) and deploys the files, returning a live free HTTPS URL immediately. | write |
cabin_create_site | Reserves a site and its instant free public HTTPS URL (yourname.sites.runcabin.com) without deploying content yet. | write |
cabin_deploy | Deploys HTML (single page or a multi-file map) to a site. Live the moment it returns; re-deploying updates the same site. | write |
cabin_deploy_preview / cabin_promote | Stages a new version at a preview URL without changing the live site, then promotes it when it looks right. The preview URL opens for anyone who has the link and is kept out of search engines. | write |
cabin_rollback | Instantly re-serves an earlier deployment at the same URL - a safe undo for a bad deploy. | write |
cabin_deploy_status / cabin_site_health | Status and live URL of a deployment; quick "is my site up and serving" check. | read-only |
cabin_list_sites / cabin_list_deployments | Lists the sites you own with their URLs, and each site's deployment history. | read-only |
cabin_get_site / cabin_get_file | Reads back a site's current live content (manifest + files) so the assistant can edit instead of regenerate. | read-only |
cabin_upload_asset | Hosts an image, font, or data file on the site by fetching it from a public HTTPS URL. Assets persist across re-deploys. | write |
cabin_create_form | Adds a working contact / lead-capture form endpoint to a site - submissions are stored and emailed to you. No backend or third-party form service needed. | write |
cabin_list_submissions | Reads the messages and leads your site's forms have received (owner only). | read-only |
cabin_delete_site | Permanently deletes a site and its deployments. Irreversible. | write |
cabin_check_domain | Checks whether a custom domain is available to register and what it costs. Free lookup, no charge. | read-only |
cabin_attach_domain | Starts attaching a custom domain - either buying one through RunCabin or connecting one you already own. Returns a checkout or subscription link for you to complete. | write |
cabin_domain_status | Progress of a domain attach; for connected domains it returns the exact DNS records to set once you're subscribed, including the required _cabin-verify TXT record that proves you own the domain. | read-only |
cabin_setup_email_forwarding | Sets up a real address at a domain bought through RunCabin (e.g. hello@yourdomain.com) forwarding to your personal inbox. Mail DNS is handled automatically. | write |
cabin_add_txt_record | Publishes an ownership-verification TXT record (Google Search Console, Bing, Stripe, DMARC and similar) on a domain bought through RunCabin. Additive and TXT-only. | write |
cabin_send_user_feedback | Sends your feedback to the RunCabin team, in your own words, when you ask your assistant to. We get it by email right away and can answer you by email. | sends a note |
cabin_send_agent_feedback | Lets your assistant tell us when one of these tools gave it trouble (an error, a confusing reply, a missing option) so we can fix it. Changes nothing on your sites. | sends a note |
The assistant can never spend your money. Free subdomain hosting costs nothing. Anything paid - a custom domain (price shown up front) and hosting at $4.99/mo or $47.99/yr - happens only when you personally review the order and pay on RunCabin's own checkout page. Tools only ever hand you a link.
The rate card
Free
*.sites.runcabin.com subdomainfreeWith HTTPS, indefinitely.
Paid
cabin_check_domain shows the price before you commit. TLS certificates for your domain are issued automatically. The domain is registered for you and it is yours - cancel later and we release it to you with the transfer code.
Field repairs
Your access token expired or was revoked. In Claude, open Customize → Connectors (claude.ai/customize/connectors) and reconnect RunCabin (the sign-in takes a few seconds). API-key users: confirm the key is sent as Authorization: Bearer cabin_live_....
cabin_check_domain says it can't check a domainRapid repeat lookups of the same domain are rate-limited by the registrar. Wait a few seconds and try again.
cabin_domain_status says "awaiting subscription"Connected (bring-your-own) domains only serve while hosting is subscribed. Open the subscription link the assistant gave you; after subscribing, the same tool returns the DNS records to set at your provider.
Certificates are issued automatically once your domain's DNS points at RunCabin - usually within a couple of minutes of DNS propagating. For a domain you connected (bought elsewhere), the _cabin-verify TXT record from cabin_domain_status is required too: it proves the domain is yours, and nothing serves until it's published. cabin_domain_status shows verified once it's seen and live when it's serving.
Self-service at runcabin.com/cancel - sign in with the same account you connected Claude with (Google or email + password) and click cancel. Hosting runs through the end of the period you already paid for, then your custom domain stops serving here - but if you bought it through RunCabin it is still yours: we release it to you and send the transfer code so you can take it to any registrar. Your free *.sites.runcabin.com subdomain keeps working either way.
Email hello@runcabin.com - a human reads it.
RunCabin's MCP server: https://runcabin.com/mcp (Streamable HTTP, OAuth 2.1) · runcabin.com