Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

GearHost

REMOTE · MCP.GEARHOST.COM

Publish a website to a live HTTPS URL in seconds, no account needed. Keep it free on GearHost.

Available components

+4 this week 70 Trust /100

Last scanned (15 hours ago)

Scores higher than 54% of remote servers

Reachable. Last reached 21 Nov 2026.

Category Cloud Infrastructure

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security57
Transport & Reachability100
Schema Quality & AI Usability78
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 6796 tokens (~226/item across 30 items; 29 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
  • Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage98
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 93% of tool parameters carry a description.Partial
  • Structured output schemas are declared (93% of tools); any adoption earns full credit.Pass
Tool Safety94
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 3 of 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "get_publish_info" implies "publish" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Partial
  • An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
  • Supports UI / widget rendering.Pass
What we tested

Checks we ran (14)

  • TLS certificate
  • Authorization
  • HTTPS
  • HSTS header
  • DNSSEC
  • Transport
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol
  • Capabilities

Does not apply to this hosted endpoint (2)

  • Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
  • Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Nov 26 +1
    • The server rewrote its instructions, which are the text every model session reads security
    • Schema quality: 6034 → 6796 ▼ functional
    • New tool “create_database” functional
    • New tool “create_mailbox” functional
    • New tool “enable_email” functional
  • 18 Nov 26 +1
    • The server rewrote its instructions, which are the text every model session reads security
    • Schema quality: 5198 → 6034 ▼ functional
    • MCP protocol: Implements a current MCP spec version (2026-07-28). functional
    • MCP protocol version: 2025-11-25 → 2026-07-28 functional
    • Server version: 1.0.0 → 1.3.0 functional
    • New tool “list_orders” functional
    • New tool “list_saved_domains” functional
    • New tool “save_domain” functional
    • New tool “save_products” functional
    • New tool “set_up_store” functional
  • 15 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

  • 13 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Nov 26 +1
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “get_plans” rewrote its description, which is the text the model reads security
    • Stability: unverified → 0.03 ▲ functional
    • New tool “search_domains” functional
  • 10 Nov 26 64

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Probed https://mcp.gearhost.com/

TLS valid

Negotiated TLS 1.2 with TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=gearhost.com CN=WE1,O=Google Trust Services,C=US 3 Nov 2026 1 Feb 2027 ECDSA 256 ECDSA-SHA256 ce1b34233ea65bb9135d38a845478f52
SANs: gearhost.com, *.gearhost.com
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of mcp.gearhost.com. — Not signed

Zone DS Keys Algorithms Outcome
. Trust anchor 20326, 38696 8, 8 Verified
com. DS published 19718 13 Verified
gearhost.com. No DS Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://mcp.gearhost.com/ Verified 200
http (plaintext) http://mcp.gearhost.com/ HTTPS enforced 301 https://mcp.gearhost.com/
MCP tools · 29 exposed · ~6,074 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
attach_custom_domain ~194

Requires signing in to GearHost. Attach a custom domain (e.g. mycoffeeshop.com or www.mycoffeeshop.com) to one of the user's CloudSites, the same as "Attach Custom Domain" in the GearHost panel. Works on every plan, including free. Afterwards the domain's DNS must point at the site: the result lists the exact records to add at the domain's DNS host. HTTPS is issued automatically once DNS resolves; get_domain_status reports progress. Returns structuredContent { status, domain, site, attached, records:[{ type, host, value }], next }.

NameTypeReqDescription
domainstringyesThe custom domain to attach, e.g. "mycoffeeshop.com".
sitestringyesThe CloudSite to attach to, by its current address (e.g. "glowing-raven.gearhost.io"; list_my_sites shows them).
NameTypeReqDescription
attachedbooleanyes–
domainstring––
nextstring––
recordsarray––
sitestring––
statusstringyes–

No examples provided.

check_site ~272

Loads a published GearHost site from GearHost's servers and reports problems to fix: missing files and broken links on the site, external scripts/stylesheets that fail to load (e.g. a wrong CDN version), no mobile viewport tag, no <title>, images without alt text, http:// resources on an https page, images over 1 MB, contact forms that send nowhere, and leftover placeholder text (Lorem ipsum, example.com). Pass the site url (or token / name + project_key) and optionally a path. Works for GearHost-hosted sites only. JavaScript is not executed, so runtime script errors are not detected. Each issue has a severity (error, warning, info) and a suggested fix.

NameTypeReqDescription
namestring–Alternative to url: site name (pair with project_key).
pathstring–Optional page path to check on the site, e.g. "/contact.html". Default: the home page.
project_keystring–The project_key the named site was published with.
tokenstring–Alternative to url: the manage token returned by publish_website.
urlstring–The site or page address, e.g. https://my-site.gearhost.io/ or https://my-site.gearhost.io/about.html.
NameTypeReqDescription
bytesinteger––
checkedobject––
countsobject––
final_urlstring––
http_statusinteger|null––
issuesarray––
msinteger–Time to load the page from GearHost, in milliseconds.
not_checkedstring––
okboolean–true when no error-level issues were found.
statusstringyes–
urlstring––

No examples provided.

claim_website ~132

Keep a preview permanently: claims a site made with publish_website into the user's GearHost account, so it becomes a free, permanent CloudSite at the same URL (no 72h expiry). Use when the user wants to keep their site. Requires signing in to GearHost: if they aren't signed in, they are asked to sign in or create a free account. Needs the preview's manage token (from publish_website). Returns structuredContent { status, url, claimed, expires_at, dashboard_url }.

NameTypeReqDescription
tokenstringyesThe manage token of the preview to claim (keep it forever).
NameTypeReqDescription
claimedbooleanyes–
dashboard_urlstring––
expires_atstring|null––
setupstring–in_progress while the CloudSite is set up in the background (~2 min; the site keeps serving), then done.
statusstringyes–
urlstringyes–

No examples provided.

create_database ~251

Requires signing in to GearHost. Create a MySQL or SQL Server database in the user's GearHost account (the first 25 MB of each is free; larger sizes are chosen in the GearHost panel). Optionally link it to one of the user's CloudSites: its connection string is then set on the site as an environment variable (default name ConnectionStrings__Default). Returns the connection details once, including the password: they are credentials, so do not publish them in a site's public files. Returns structuredContent { status, name, engine, host, port, database, user, password, connection_string, linked_site, env_var }.

NameTypeReqDescription
enginestring–mysql (PHP, WordPress, Node, Python) or sqlserver (.NET). Default mysql.
env_varstring–Optional environment variable name for the link (default ConnectionStrings__Default).
namestringyesDatabase name: letters, numbers, hyphens and underscores, starting with a letter or number, up to 63 characters (e.g. "shop_orders").
sitestring–Optional: a CloudSite address in the account to link the database to (list_my_sites shows them).
NameTypeReqDescription
connection_stringstring––
databasestring––
enginestring––
env_varstring|null––
hoststring––
linked_sitestring|null––
namestring––
notestring|null––
passwordstring––
portinteger––
statusstringyes–
userstring––

No examples provided.

create_mailbox ~215

Requires signing in to GearHost. Create a mailbox (e.g. hello@mycoffeeshop.com) on a domain that has GearHost email turned on (enable_email). A strong password is generated and returned once: give it to the user and suggest they change it after signing in to webmail. If each mailbox costs extra on the site's plan, the first call changes nothing and returns needs_confirmation with the monthly charge; call again with accept_charges:true ONLY after the user agrees. Returns structuredContent { status, address, password, webmail, settings:{ incoming, outgoing } }.

NameTypeReqDescription
accept_chargesboolean–Set true only after the user agreed to the monthly charge a previous call returned.
domainstringyesThe email domain, e.g. "mycoffeeshop.com".
usernamestringyesThe part before the @, e.g. "hello" for hello@mycoffeeshop.com. Letters, numbers, dots, hyphens and underscores.
NameTypeReqDescription
addressstring––
chargesobject––
passwordstring–Shown once. A credential: give it only to the user.
settingsobject––
statusstringyessuccess, or needs_confirmation (nothing changed yet).
webmailstring––

No examples provided.

delete_my_site ~144

Requires signing in to GearHost. Delete one of the user's GearHost CloudSites (by domain): its hosting, files, certificates, DNS, HA replicas and Git Push repo, exactly like deleting it in the GearHost panel. Destructive - set confirm:true. Databases linked to the site are KEPT (unlinked, still in the account) unless delete_databases:true. Returns structuredContent { status, domain, deleted, databases }.

NameTypeReqDescription
confirmbooleanyesMust be true to actually delete.
delete_databasesboolean–Also permanently delete the databases linked to this site. Default false: they are kept.
domainstringyes–
NameTypeReqDescription
databasesstring–kept | deleted | none
deletedbooleanyes–
domainstring––
statusstringyes–

No examples provided.

enable_email ~258

Requires signing in to GearHost. Turn on GearHost email for a custom domain in the user's account (e.g. mycoffeeshop.com), so it can have mailboxes like hello@mycoffeeshop.com. The domain must already be in the account (attach_custom_domain adds one to a site); gearhost.io addresses cannot have email. When the domain's DNS is managed at GearHost (or a Cloudflare zone the user connected), the mail records (MX, SPF, DKIM, DMARC) are added automatically; otherwise the result lists the records to add at the DNS host. If email costs extra on the site's plan, the first call changes nothing and returns needs_confirmation with the monthly charges; tell the user the charge and call again with accept_charges:true ONLY after they agree. Then use create_mailbox. Returns structuredContent { status, domain, dns:{ applied, records:[{type,name,content,priority}] }, settings:{ incoming, outgoing } }.

NameTypeReqDescription
accept_chargesboolean–Set true only after the user agreed to the monthly charge a previous call returned.
domainstringyesThe custom domain to receive email, e.g. "mycoffeeshop.com".
NameTypeReqDescription
chargesobject–Present with needs_confirmation: monthly USD amounts.
dnsobject––
domainstring––
settingsobject–Mail client settings for every mailbox on the domain.
statusstringyessuccess, or needs_confirmation (nothing changed yet).

No examples provided.

get_claim_status ~151

Check whether a preview has been claimed into a GearHost account, and how long is left to claim it (the site is auto-removed at expiry unless claimed). Pass token, or name+project_key. Read-only. Returns structuredContent { status, url, claimed, claimable, expiring_soon, seconds_left, time_left, claim_url, owner }. claim_url is the page where the user can keep the site.

NameTypeReqDescription
namestring–The site name (with project_key) instead of a token.
project_keystring–The project_key (with name) instead of a token.
tokenstring–The manage token (or use name+project_key).
NameTypeReqDescription
claim_urlstring|null–Browser claim link (null once claimed).
claimablebooleanyesTrue if still within the claim window and not yet claimed.
claimedbooleanyes–
expiring_soonboolean–True within ~6h of expiry — prompt the user to claim now.
ownerstring|null–Masked account once claimed, e.g. "z***@gmail.com".
seconds_leftinteger|null––
statusstringyes–
time_leftstring|null–Human, e.g. "2d 23h".
urlstring––

No examples provided.

get_domain_setup ~276

Get everything needed to put a custom domain (e.g. yourshop.com) on a GearHost site: the exact DNS records, plus how to attach it. Identify the site by token, or by name+project_key. A custom domain can only be attached to a site in a GearHost account (it binds the domain to a real owner). The steps are: (1) the preview is claimed into a free account (claim_website or claim_url), (2) the domain is attached (attach_custom_domain when signed in, or "Attach Custom Domain" in the GearHost panel), (3) the DNS records are added at the domain's DNS host, (4) get_domain_status reports when it is live. Returns structuredContent { status, domain, claim_first, requires_account, attach_in_dashboard, claim_url, how_to_attach, records:[{ type, host, value, priority, note }], steps }.

NameTypeReqDescription
domainstringyesThe custom domain to point here, e.g. "yourshop.com".
namestring–The site name (with project_key) instead of a token.
project_keystring–The project_key (with name) instead of a token.
tokenstring–The site manage token (or use name+project_key).
NameTypeReqDescription
attach_in_dashboardboolean–Always true — the attach itself is a click in Octane (Attach Custom Domain), not an API call.
claim_firstboolean–True if the site is not yet claimed — it must be claimed to an account before a custom domain can be attached.
claim_urlstring|null–Surface this to the user to claim the site (one click if signed in). null if already claimed.
domainstringyes–
how_to_attachstring–A ready-to-relay walkthrough of the claim → attach → DNS → verify steps.
recordsarrayyes–
requires_accountboolean–Always true — attaching needs the owner's GearHost account; it is not API-automatable by design.
statusstringyes–
stepsarray––

No examples provided.

get_domain_status ~227

Check whether a custom domain is wired up and serving yet — the verify/poll half of the custom-domain flow. After you give the user the DNS records (get_domain_setup) and they attach the domain + add the records, call this to see live progress: is it attached to the CloudSite, does DNS resolve to the GearHost node, and is HTTPS active. Identify the site by token or name+project_key. Poll this every ~30-60s after the user adds DNS until https:"active" — like get_site_status for a publish. Returns structuredContent { status, domain, attached, dns_ok, apex_ok, www_ok, https, live, live_url, next }.

NameTypeReqDescription
domainstringyesThe custom domain to check, e.g. "yourshop.com".
namestring–The site name (with project_key) instead of a token.
project_keystring–The project_key (with name) instead of a token.
tokenstring–The site manage token (or use name+project_key).
NameTypeReqDescription
apex_okboolean––
attach_in_dashboardboolean––
attachedbooleanyesTrue if the domain is attached to your CloudSite (done in the Octane dashboard via Attach Custom Domain).
claim_urlstring|null–If the site is unclaimed, surface this so the user can claim it before attaching. null if already claimed.
dns_okbooleanyesTrue if DNS for the apex OR www resolves to your GearHost site.
domainstringyes–
httpsstringyes"active" (serving over HTTPS), "provisioning" (DNS resolves, cert issuing), or "waiting_dns" (records not visible yet).
liveboolean––
live_urlstring|null––
nextstring–The single next action to get it live.
requires_accountboolean–Always true — if not attached yet, the attach is done in the user's Octane account, not via the API.
statusstringyes–
www_okboolean––

No examples provided.

get_plans ~154

GearHost CloudSite plans and monthly prices in USD, read live from GearHost (the free plan included). Each plan: name, monthly_price_usd, disk_mb, monthly_requests (null = no fixed limit). Every plan, including free, can use custom domains with automatic HTTPS. Add-on prices (email, high availability, databases) are per plan. Plans are changed in the GearHost panel (the CloudSite's "Change plan" link); this tool only reads prices. pricing_model states how billing works: flat monthly prices, no credits or usage charges, and what happens when a site passes its request limit. Returns structuredContent { status, currency, plans:[...], pricing_model, change_plan }.

Input schema present but exposes no named parameters.

NameTypeReqDescription
change_planstring––
currencystring––
plansarrayyes–
pricing_modelobject––
statusstringyes–

No examples provided.

get_publish_info ~75

Optional: read the GearHost publishing docs (methods, limits ~25 MB and an hourly cap on new sites, 72h lifecycle). The docs describe a raw HTTP API (octane.gearhost.com/preview/) for non-MCP clients - when using MCP you do NOT need it; just call publish_website.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_site_stats ~183

Requires signing in to GearHost. Traffic for the user's CloudSites: requests per day for the last 7 or 30 days (successful and not-found), bandwidth, and this billing cycle's requests against the plan's limit. Requests count every page and file served, not unique visitors; the numbers are refreshed about hourly. Use when the user asks how many visits or how much traffic a site gets. Omit domain for all sites. Read-only. Returns structuredContent { status, days, sites:[{domain, requests, ok, not_found, bandwidth_mb, cycle_requests, cycle_limit, daily:[{date, requests}]}] }.

NameTypeReqDescription
daysinteger–Period in days: 7 or 30 (default 7).
domainstring–One CloudSite (its main address). Omit for all sites in the account.
NameTypeReqDescription
daysinteger––
refreshed_atstring|null––
sitesarrayyes–
statusstringyes–

No examples provided.

get_site_status ~172

Full status of a published site — the one call to confirm a publish landed and inspect it. Identify the site by token, OR by name + project_key. Runs a real server-side HTTP probe (live_http) so you get a definitive "is it serving?" answer even while the fresh DNS has not propagated to you yet — prefer this over fetching the URL directly right after publishing. Also returns the current version, content_hash (to detect drift from what you published), size, file_count, source, and the claim/expiry state.

NameTypeReqDescription
namestring–Site name (alternative to token; pair with project_key).
project_keystring–The project_key you published the named site with (>=16 chars).
tokenstring–The manage token returned when the site was published.
NameTypeReqDescription
claimobject|null–If unclaimed: how to keep it forever (free) — { time_left, seconds_left, claimable_until, claim_url }. Surface claim_url to the user so they can own the site before it expires.
claimedboolean––
content_hashstring|null–Hash of the live content — compare to your publish content_hash to confirm the live site matches what you sent.
deploy_countinteger|null––
existsbooleanyes–
expires_atstring|null––
expiring_soonboolean–True when unclaimed and < 6h from expiry — prompt the user to claim it NOW so it is not auto-removed.
file_countinteger|null––
last_publishedstring|null–ISO-8601 time of the most recent deploy.
live_httpobject–Server-side HTTP probe of the live URL: { ok, status_code, ms, final_url, error }. ok=true means it is genuinely serving right now.
namestring|null––
sourcestring|null–The attribution tag it was published with.
statusstringyes–
total_bytesinteger|null–Total uncompressed size of the site.
urlstring|null––
versioninteger|null–Current published version number.

No examples provided.

list_form_messages ~197

Requires signing in to GearHost. Lists messages visitors sent through contact forms on the user's CloudSites (GearHost Forms), newest first. Use when the user asks whether anyone contacted them through their site or wants to read form submissions. Optionally limit to one site (domain), to messages since a date, and the number returned (default 20, max 50). Read-only; visitor IP addresses are not included. Returns structuredContent { status, total, messages:[{site, received_at, subject, reply_to, fields}] }.

NameTypeReqDescription
domainstring–Only messages from this site (e.g. mysite.gearhost.io or a custom domain on the site). Omit for all sites.
limitinteger–How many messages to return, newest first (1-50, default 20).
sincestring–Only messages received on or after this date (YYYY-MM-DD, UTC).
NameTypeReqDescription
messagesarrayyes–
statusstringyes–
totalinteger–Messages matching the filters (may be more than returned).

No examples provided.

list_my_previews ~101

List the live preview sites you created with a given project_key (your cross-session identity). Reuse one project_key across several named publishes, then call this to enumerate + manage them all. Returns structuredContent { status, count, sites:[{ name, url, expires_at, last_published, claimed }] }.

NameTypeReqDescription
project_keystringyesThe secret project_key you published with (>=16 chars). Lists every live preview that shares it.
NameTypeReqDescription
countinteger––
sitesarrayyes–
statusstringyes–

No examples provided.

list_my_sites ~45

Requires signing in to GearHost. List the CloudSites in the user's GearHost account. Returns structuredContent { status, sites:[{domain,url,status,plan,node}] }.

Input schema present but exposes no named parameters.

NameTypeReqDescription
sitesarrayyes–
statusstringyes–

No examples provided.

list_orders ~141

Requires signing in to GearHost. Paid orders from a CloudSite's GearHost Store, newest first: items, total, buyer name and email, shipping address. Use when the user asks what sold or who to ship to. Read-only; refunds are made in the user's Stripe dashboard. Returns structuredContent { status, site, orders:[{order, total, items, customer_name, customer_email, shipping, paid_at}] }.

NameTypeReqDescription
limitinteger–1-100, default 20.
sincestring–Only orders paid on or after this date (YYYY-MM-DD).
sitestringyesThe CloudSite address.
NameTypeReqDescription
ordersarrayyes–
sitestring––
statusstringyes–

No examples provided.

list_saved_domains ~85

Requires signing in to GearHost. The domain names the user saved for later (with save_domain or in the GearHost panel), each re-checked with the registry: available, taken (someone else registered it) or unknown. Read-only; nothing is bought. Returns structuredContent { status, domains:[{domain, availability, note, saved_at, checked_at}] }.

Input schema present but exposes no named parameters.

NameTypeReqDescription
domainsarrayyes–
statusstringyes–

No examples provided.

list_versions ~105

List the recent publish history for a site (newest first), so you can undo a change. Pass token, or name+project_key. Each publish is a version; use a version number with rollback_website to restore it. Returns structuredContent { status, url, current_version, count, versions:[{ version, published_at, sha, is_current }] }.

NameTypeReqDescription
namestring––
project_keystring––
tokenstring––
NameTypeReqDescription
countinteger––
current_versioninteger|null––
statusstringyes–
urlstringyes–
versionsarrayyes–

No examples provided.

publish_to_my_site ~175

Requires signing in to GearHost. Publish/update content to a CloudSite ALREADY in the user's GearHost account (by domain). To put a NEW site online, use publish_website instead: it needs no account. Provide ONE of: html, files map (must include index.html at the root), or zip_base64. Returns structuredContent { status, url, domain, files, updated }.

NameTypeReqDescription
domainstringyesThe CloudSite domain to publish to (must be in your account).
filesobject–Map of relative path => contents. MUST include "index.html" at the root.
htmlstring–HTML for a one-page site (served as index.html at the root).
zip_base64string–Base64 .zip with index.html at the archive root.
NameTypeReqDescription
domainstring––
filesinteger–Number of files deployed.
statusstringyes–
updatedboolean––
urlstringyes–

No examples provided.

publish_website ~1,342

Publish a website to a live public URL on GearHost in seconds (no account). For when the user has you build a website, landing page, portfolio, or HTML/CSS/JS app and wants to see it live or share a link. Provide ONE of: html (a one-page site), files (a map of relative path => text contents), or zip_base64. Pass token to update a site you published before (same URL). Optionally pass name to request a specific subdomain (e.g. name:"daily-grind" → daily-grind.gearhost.io); omit it for an auto-generated fun-name. Pair name with project_key (a secret you generate and STORE) for a PERSISTENT handle: re-publishing the same name + project_key in any future session updates that same URL, even after the token is gone. config applies serving behavior. Supported today: spa (serve index.html for any unmatched route — REQUIRED for client-side-routed apps like React/Vue so deep links + refresh work) and not_found. Unsupported config keys (e.g. redirects, headers) are rejected with bad_request. The response echoes config_applied with EXACTLY what took effect — read it to confirm what was honored instead of assuming. To verify SPA end-to-end, fetch any non-existent deep path and confirm it returns 200 with your index page, not 404. The published site is served at https://<name>.gearhost.io. This tool does the whole publish; static sites can have a working contact form by posting it to https://octane.gearhost.com/forms/ (get_publish_info has the exact markup; messages are emailed to the owner once the site is kept). octane.gearhost.com/preview/ in the docs is the equivalent raw HTTP API for non-MCP clients. Returns structuredContent { status, url, name, token, token_is_secret, updated, url_ready_in_seconds, verify_with, expires_at, claim }. live_now:true means the URL works right away (most publishes, and every update). If live_now is false the address is brand new and its DNS can take ~10s, so do NOT GET it immediately and assume failure; confirm with get_site_status (the verify_w…

NameTypeReqDescription
configobject–Optional serving config. Supported today: { "spa": true } — serve index.html for any path that is not a real file (so client-routed React/Vue/SvelteKit apps work on deep links + refresh), and optiona…
filesobject–Map of relative path => contents. MUST include "index.html" at the root (served at /). Paths are relative (no leading slash, no ".."). Each value is EITHER a string (text file) OR, for a binary asset…
htmlstring–HTML for a one-page site (served as index.html at the root).
namestring–Optional subdomain for a NEW site: name:"daily-grind" → daily-grind.gearhost.io. 3-40 chars, lowercase letters/numbers/hyphens, no leading/trailing hyphen. Taken → kind:name_taken; bad format/reserve…
notestring–Optional short label for this version, shown in list_versions (e.g. "added pricing section"). Max 200 chars.
notify_urlstring–Optional HTTPS webhook. GearHost POSTs lifecycle events to it as JSON { event, name, url, ... } where event is "expiring_soon" (~6h before auto-removal), "expired" (removed), or "claimed" (the user k…
project_keystring–Optional PERSISTENT HANDLE for cross-session editing without an account. A random secret of AT LEAST 16 characters (shorter is rejected with kind:bad_request) that you generate once and STORE. Best p…
sourcestring–Optional attribution tag for the builder/app/integration publishing on the user's behalf (e.g. "lovable", "v0", "my-gpt-name"). Shown on the claim page ("published with …"). Free-form, short.
tokenstring–Manage token from a previous publish - updates the SAME url. Treat as a secret credential.
zip_base64string–Base64 of a .zip of the built site. MUST contain index.html at the archive root. Max ~25 MB.
NameTypeReqDescription
claimobject–How to keep the site permanently (free).
config_appliedobject|null–Present only when you sent config — confirms what was actually applied (e.g. {"spa":true,"not_found":"index.html"}). A positive ack: if spa is true here, deep links/refresh serve index.html. Unsuppor…
content_hashstring|null–Stable hash of the published content (timestamp-independent). Re-publishing identical content returns unchanged:true with no redeploy.
expires_atstring|null–When the site auto-expires unless claimed (ISO 8601), or null.
live_nowboolean–True when the URL works right away (a ready-made site, or an update to an existing one). Open or share it immediately.
namestring–The site's fun-name slug (e.g. "fuzzy-gecko").
quotaobject|null–Your new-preview budget for the rolling hour, so you can pace yourself instead of hitting rate_limited. { hourly_limit, used_this_hour, remaining, unlimited }.
statusstringyes"success" on publish.
tokenstringyesManage token. A WRITE CREDENTIAL - reuse it (as the token arg) to update this same URL. Treat as secret; do not echo in public logs.
token_is_secretboolean–Always true - a reminder that token must be handled as a credential.
unchangedboolean–True if the content was identical to the current version — idempotent no-op (no redeploy, version held). The 72h expiry timer IS reset, so re-publishing identical content is a safe "touch to keep ali…
updatedboolean–True if this updated a previously published site (token was supplied) rather than creating a new one.
urlstringyesLive public URL of the published site.
url_ready_in_secondsinteger|null–Approx seconds before the URL resolves: 0 = live now. Above 0 the address is brand new, and an immediate GET may fail with a DNS/connection error even though the publish SUCCEEDED — wait this long, o…
verifyobject–Exact verify cadence: wait poll_after_ms, then call the named tool every poll_every_ms until the `until` condition holds, giving up after give_up_after_ms. Saves you from guessing the DNS delay or ha…
verify_withstring–The tool to call to confirm the site is live (get_site_status) — more reliable than fetching url right after publishing.
versioninteger|null–Monotonic version number of this publish (1, 2, 3…). Pass it to rollback_website / see it in list_versions.
warningsarray–Non-blocking quality hints about the published site (e.g. no <title>, http:// mixed-content asset, large size). Fix-then-republish if you want, but the publish DID succeed.

No examples provided.

report_abuse ~64

Report a GearHost preview site being used for phishing/malware/abuse.

NameTypeReqDescription
namestringyesThe preview fun-name, e.g. 'azure-lynx'.
reasonstringyesWhat's wrong with it (phishing, malware, etc.).

No output schema declared.

No examples provided.

rollback_website ~116

Restore a site to a previous version (undo). Pass the manage token and the version number from list_versions. Restores that version's content to the live URL and resets the expiry timer. Returns structuredContent { status, url, restored_from, updated, url_ready_in_seconds }. Errors: version_not_found (no such version) | no_versions (nothing to roll back to) | invalid_token.

NameTypeReqDescription
tokenstringyesManage token (write credential).
versionintegeryesThe version to restore, from list_versions.
NameTypeReqDescription
restored_fromintegeryes–
statusstringyes–
updatedboolean––
urlstringyes–
url_ready_in_secondsinteger––

No examples provided.

save_domain ~180

Requires signing in to GearHost. Save a domain name to the user's GearHost account to decide on later. It is checked with the domain registry now and every time the saved list is looked at. Saving does NOT register, hold or reserve the name with the registry and costs nothing: anyone can still register it until the user buys it. The user buys it themselves in their GearHost account (Domains). Use when the user likes a name but is not ready to buy, or asks to keep it in mind. Returns structuredContent { status, domain, availability, already_saved, saved_count, where }.

NameTypeReqDescription
domainstringyesThe full domain to save, e.g. "harborgrind.com".
notestring–Optional short note shown with it, e.g. "for the coffee shop site". Max 200 chars.
NameTypeReqDescription
already_savedboolean––
availabilitystringyesavailable, taken or unknown (the registry did not answer; not the same as available).
domainstringyes–
saved_countinteger––
statusstringyes–
wherestring–Where the user sees the saved list.

No examples provided.

save_products ~211

Requires signing in to GearHost. Add or update products a CloudSite sells (GearHost Store). Prices are kept by GearHost, not in the page, so visitors cannot change what they pay. Each product: name, price (e.g. 12.5 for 12.50), optional id (used in the Buy button; made from the name if omitted), currency (default the store's), description, shipping (true = ask for a shipping address), active (false = hidden). Returns the products and ready-to-paste Buy button HTML (plain forms posting to https://octane.gearhost.com/checkout/) to put on the site with publish_to_my_site. Works before Stripe is connected; buttons start working once set_up_store is finished. Returns structuredContent { status, site, products:[{id,name,price,currency,shipping,active}], buy_buttons_html, payments_ready }.

NameTypeReqDescription
productsarrayyes–
sitestringyesThe CloudSite address.
NameTypeReqDescription
buy_buttons_htmlstring––
errorsarray––
payments_readyboolean––
productsarrayyes–
sitestring––
statusstringyes–

No examples provided.

search_domains ~319

Search for domain names: checks with the domain registry which names are available to register, across popular endings (.com, .co, .net, .org, .io, .app by default), and adds available ideas suggested by the registry. Pass the user's words in query (a business name, an idea, or a full domain) and/or your own name ideas in names (e.g. ["harborgrind", "harborgrindcoffee", "drinkharbor.com"]); up to 24 names are checked per search. When GearHost domain registration is open, available names include the yearly price GearHost charges and a buy_url where the user completes the purchase in their GearHost account; no purchase happens through this tool. Status "unknown" means the registry did not answer for that name, not that it is free. No sign-in needed.

NameTypeReqDescription
namesarray–Optional name ideas to check, with or without an ending (e.g. "harborgrind" or "harborgrind.co"). Names without an ending are tried on every ending in tlds.
querystring–The user's words: a business or project name ("Harbor Grind coffee"), or a full domain to check ("harborgrind.com").
tldsarray–Optional endings to try, e.g. ["com","shop","cafe"]. Default: com, co, net, org, io, app.
yearsinteger–Registration length for prices, in years (default 1).
NameTypeReqDescription
available_countinteger––
checkedinteger––
notestring––
resultsarrayyes–
sellingboolean–true when domains can be bought at GearHost right now (prices and buy_url are included).
statusstringyes–

No examples provided.

set_up_store ~157

Requires signing in to GearHost. Let one of the user's CloudSites take payments (GearHost Store): returns a link where the user connects their OWN Stripe account (or creates one) on Stripe's website; buyers then pay on Stripe-hosted pages and the money goes straight to the user. Nothing is charged by this tool. Give the user the link to open themselves. If payments are already on, says so. Then use save_products and add the returned Buy buttons to the site. Returns structuredContent { status, site, payments_ready, connect_url }.

NameTypeReqDescription
sitestringyesThe CloudSite address (list_my_sites shows them), e.g. "glowing-raven.gearhost.io" or its custom domain.
NameTypeReqDescription
connect_urlstring|null–Stripe page for the user to open (expires after a few minutes; call again for a new one).
payments_readybooleanyes–
sitestring––
statusstringyes–

No examples provided.

unpublish_website ~132

Take a published site DOWN immediately (delete it). Pass the manage token you got when you published. Use this to remove a site the moment it is no longer needed - or RIGHT AWAY if you accidentally published a secret (sites are public). Without this, a site only auto-expires ~72h after its last publish. Returns structuredContent { status:"deleted", url, deleted:true }. (A site that was CLAIMED into an account is a real CloudSite - delete it from the GearHost dashboard, not here.)

NameTypeReqDescription
tokenstringyesThe manage token returned when the site was published.
NameTypeReqDescription
deletedboolean––
statusstringyes–
urlstring––

No examples provided.

Install

How do I install the GearHost MCP server?

GearHost is a hosted endpoint at https://mcp.gearhost.com/, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · mcp.gearhost.com

# add to Claude Code
claude mcp add --transport http com-gearhost-mcp 'https://mcp.gearhost.com/'
Common questions

What is the GearHost MCP server?

GearHost is an MCP server listed in the public MCP registry as com.gearhost/mcp. Publish a website to a live HTTPS URL in seconds, no account needed. Keep it free on GearHost. This page covers its hosted endpoint (https://mcp.gearhost.com/).

Is the GearHost MCP server safe to use?

GearHost scores 70 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the GearHost MCP server expose?

GearHost exposes 29 tools: publish_website, get_publish_info, get_plans, unpublish_website, check_site, and 24 more. Their descriptions and schemas cost roughly 6,074 tokens of context every time the server is loaded.

Does the GearHost MCP server require authentication?

No. We connected to GearHost without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the GearHost MCP server still maintained?

GearHost is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the GearHost MCP server?

VerifyMCP ran 14 checks on GearHost, covering TLS certificate, Authorization, HTTPS, HSTS header and 10 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.