Servers Playground How we check Add a server Log in

DropTheHassle

Working · 1.8 s

io.github.bosmdavid-gif/dropthehasslev0.5.2

Your AI publishes your site: free HTTPS link, or a .com for €19 that goes live with no DNS.

Cloud & DevOps

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://dropthehassle.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

award_readiness Read-only

(needs account token) Returns whether a site on this account is ready to be considered for an award: favicon, share image, title and description, mobile viewport, page weight, custom domain, https, and a real page rather than the DropTheHassle placeholder. Each item includes a fix hint. Read-only. Does not charge.

hoststring, required

The public host of a site on this account, e.g. "example.com".

DropTheHassle MCP server | mcptry

Tools (52)

award_readiness

read-only

Argument	Type	Description
host*	string	The public host of a site on this account, e.g. "example.com".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "host"
  ],
  "properties": {
    "host": {
      "type": "string",
      "description": "The public host of a site on this account, e.g. \"example.com\"."
    }
  }
}

check_live

(needs account token) Checks, at the time of the call, whether the site's address points here, has a valid certificate and loads. backend true sends one request to the linked backend instead. Read-only.

read-only

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
backend	boolean	true tests the linked backend instead.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "backend": {
      "type": "boolean",
      "description": "true tests the linked backend instead."
    }
  }
}

check_trademark

Look up live identical or very similar word marks for a name in USPTO and EUIPO. Read-only. Does not charge. Works with no account. Each hit includes its Nice classes. When intended_use is given, each hit also includes a relevance note for that use. Tell the human the Nice classes and any relevance note, not only that a mark exists. The result lists the registers that answered and the ones not checked. USPTO is checked. EUIPO is checked only when keys are set. National offices are not checked; the result includes a TMview link for them. This is not legal advice.

read-only

Argument	Type	Description
name*	string	A word such as "feylet", or a domain such as "feylet.com". The check uses the second-level label.
intended_use	string	One short sentence on what is being built, such as an AI site builder or a dating app. Optional. When set, each hit includes a relevance note.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "A word such as \"feylet\", or a domain such as \"feylet.com\". The check uses the second-level label."
    },
    "intended_use": {
      "type": "string",
      "description": "One short sentence on what is being built, such as an AI site builder or a dating app. Optional. When set, each hit includes a relevance note."
    }
  }
}

choose_link

Renames a site's link to name.dropthehassle.app. The previous link redirects to the new one. Without an account, claim_url or site_token identifies the unclaimed site. With an account, site identifies it. confirm=true applies the new name. Does not charge.

destructive

Argument	Type	Description
name*	string	The label only, e.g. "myproject" for myproject.dropthehassle.app.
site	string	With an account: the address of the site to rename, for example myproject.dropthehassle.app.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.
claim_url	string	The claim link from an unclaimed deploy. The part after # is the secret.
site_token	string	Without an account: that site's token, from the deploy reply. A site token sent as Bearer works too.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "confirm"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The label only, e.g. \"myproject\" for myproject.dropthehassle.app."
    },
    "site": {
      "type": "string",
      "description": "With an account: the address of the site to rename, for example myproject.dropthehassle.app."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    },
    "claim_url": {
      "type": "string",
      "description": "The claim link from an unclaimed deploy. The part after # is the secret."
    },
    "site_token": {
      "type": "string",
      "description": "Without an account: that site's token, from the deploy reply. A site token sent as Bearer works too."
    }
  }
}

claim_site

(needs account token) Attaches an unclaimed site to this account using its claim link (the link ends with # and a code). One claim, and not a site already on another account. Does not charge.

Argument	Type	Description
claim_url*	string	The full claim link, or the code after the #.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "claim_url"
  ],
  "properties": {
    "claim_url": {
      "type": "string",
      "description": "The full claim link, or the code after the #."
    }
  }
}

clear_site_password

(needs account token) Removes the password from a claimed site so anyone can open it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    }
  }
}

connect_domain

(needs account token) Attaches a domain registered at another registrar to a site. Nothing is transferred or bought. The reply includes the A record and the TXT ownership record to set at that registrar. On a site that already has a domain, the name is an extra that redirects (301) to the main one. A repeat with the same domain re-checks whether the name points here. Does not charge.

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain*	string	The domain, e.g. example.com.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "domain"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "The domain, e.g. example.com."
    }
  }
}

delete_site

(needs account token) Deletes a site, including its files and versions. Not reversible. A site with a domain registered here, or with email still on, is refused until those are settled. A suspended site is refused. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of the site to delete, for example myproject.dropthehassle.app.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site to delete, for example myproject.dropthehassle.app."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

deploy_site

Uploads site files and returns a live HTTPS link (name.dropthehassle.app) and a claim link (claim_url). Works without an account. Files are sent inline as path, content and encoding (utf8 or base64). This server cannot read a folder on the caller's computer. The published files are index.html at the top, or the built folder dist/, build/, out/, _site/, .output/public or docs/. With an account, site names the site to update and name is omitted; without site the oldest reserved address on the account is filled. Does not buy a name. Size limits: 25 MB and 1,000 files before the site is claimed, 100 MB and 5,000 files when signed in.

destructive

Argument	Type	Description
name	string	Address label, for example "lisas-bakery" for lisas-bakery.dropthehassle.app. Used when creating a site. Works with no account token.
site	string	Optional site address to update, for example myproject.dropthehassle.app. Absent fills the oldest reserved address on the account.
slug	string	Same as name. Older clients send this.
email	string	Optional. Where the claim link and up to 3 reminders are sent. Ask after go-live, not before. Do not make one up. Omit it to publish with a claim link only.
files*	array	Site files sent inline. Each item has path, content, and encoding utf8 or base64. node_modules, .git and hidden files are not part of the site. .well-known is allowed.

design_inspiration

Returns a link to the gallery of customer sites picked as Site of the Month. Works without an account. Read-only.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

domain_email

DropTheHassle turns on email for a domain already on DropTheHassle, such as [email protected]. The address sends and receives. The price is shown and confirmed before anything is enabled. Needs sign-in. The main inbox is €5 / $5 a month, including VAT in the EU.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

domain_renewal

(needs account token) Returns when each domain of a site renews, the price, and whether auto-renew is on. autorenew false with confirm=true stops the renewal. autorenew true is refused, because it commits a charge. Does not pay.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain	string	Optional: which domain, when changing auto-renew. Default: the site's main domain.
confirm	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.
autorenew	boolean	false stops the yearly renewal when confirm is true. true is refused, because it commits a charge. Absent means only read.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "Optional: which domain, when changing auto-renew. Default: the site's main domain."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    },
    "autorenew": {
      "type": "boolean",
      "description": "false stops the yearly renewal when confirm is true. true is refused, because it commits a charge. Absent means only read."
    }
  }
}

edit_site_file

(needs account token) Replaces one file on a live site, or adds it. Other files stay as they are. This is not a full folder Update. Restore undoes the last Update or Edit files save. site is the address. path is the file. content is the new text, or base64 when encoding is base64. A site token for that site works, including before the site is claimed, the same way an update with that token does. Without a token, claim the site first. Does not charge.

destructive

Argument	Type	Description
path*	string	The file to replace, or to add, for example index.html.
site*	string	The address of the site, for example myproject.dropthehassle.app.
content*	string	The new file. UTF-8 text, or standard base64 when encoding is base64.
encoding	string	utf8 (default) or base64.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "path",
    "content"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "The file to replace, or to add, for example index.html."
    },
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    },
    "content": {
      "type": "string",
      "description": "The new file. UTF-8 text, or standard base64 when encoding is base64."
    },
    "encoding": {
      "enum": [
        "utf8",
        "base64"
      ],
      "type": "string",
      "description": "utf8 (default) or base64."
    }
  }
}

email_status

(needs account token) Returns the email on a site's own domain: each address, whether it is a mailbox that sends and receives or forwards to another address, status, the monthly price, and the next step. No passwords. Read-only. Does not charge.

read-only

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    }
  }
}

enable_form

(needs account token) Turns lead collection on or off for a claimed site. Visitors can send a name, email and message. Each message is emailed to the owner's mailbox and kept for the dashboard. Claim the site first. Does not charge.

Argument	Type	Description
site*	string	The address of a claimed site on this account, for example myproject.dropthehassle.app.
enabled*	boolean	True turns the contact form on. False turns it off.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "enabled"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a claimed site on this account, for example myproject.dropthehassle.app."
    },
    "enabled": {
      "type": "boolean",
      "description": "True turns the contact form on. False turns it off."
    }
  }
}

gallery_preference

(needs account token) Sets whether this account's sites may be considered for Site of the Month. A site is featured only after the account holder agrees. Does not charge.

Argument	Type	Description
featured*	boolean	true: sites may be considered. false: sites are not considered.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "featured"
  ],
  "properties": {
    "featured": {
      "type": "boolean",
      "description": "true: sites may be considered. false: sites are not considered."
    }
  }
}

get_checkout_link

(needs account token) Returns a payment link to register a domain and put it on one of the account's sites. The account holder opens and pays the link on a Stripe payment page, which also asks for the domain owner's name, address and phone. After payment the domain is registered here and the site goes live on it with HTTPS and no DNS settings. For a site that is not on the account yet, the claim happens first. Does not charge a card.

Argument	Type	Description
name*	string	The domain to register, e.g. "myidea.com".
site*	string	The address of the site the domain attaches to, for example myproject.dropthehassle.app.
extras	array	Optional extra domain names on the same payment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The domain to register, e.g. \"myidea.com\"."
    },
    "site": {
      "type": "string",
      "description": "The address of the site the domain attaches to, for example myproject.dropthehassle.app."
    },
    "extras": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional extra domain names on the same payment."
    }
  }
}

get_email_checkout_link

(needs account token) Returns a payment link that turns on email for a site's own domain (a main inbox such as [email protected], €5 / $5 a month, including VAT in the EU). It is a mailbox that sends and receives. The account holder opens and pays the link. After payment the mailbox and its DNS records are set up. Mail is read and sent in the DropTheHassle webmail, or in a mail app over IMAP and SMTP with the settings and password shown in the dashboard. A saved card is not charged. The site needs an active domain registered here first.

Argument	Type	Description
site*	string	The address of the site whose domain gets email, for example myproject.dropthehassle.app.
address	string	The part before the @ of the main inbox, e.g. "hello". Default hello.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site whose domain gets email, for example myproject.dropthehassle.app."
    },
    "address": {
      "type": "string",
      "description": "The part before the @ of the main inbox, e.g. \"hello\". Default hello."
    }
  }
}

get_site_file

(needs account token) Returns one file from a site you can update, as utf8 text or base64. site is the address. path is the file, such as index.html or css/site.css. A site token for that site works, including before the site is claimed, the same way an update with that token does. Without a token, claim the site first. Read-only. Does not charge.

read-only

Argument	Type	Description
path*	string	The file, for example index.html or css/site.css.
site*	string	The address of the site, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "The file, for example index.html or css/site.css."
    },
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    }
  }
}

get_site_metrics

(needs account token) Visitors, page views, top pages, referrers, countries, devices, and a one-sentence summary for one claimed site. period is day, week, month or year. Month is the default. Read-only. Does not charge. Does not promise a ranking.

read-only

Argument	Type	Description
site*	string	The address of the site, for example myproject.dropthehassle.app.
period	string	day, week, month or year. Month is the default.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    },
    "period": {
      "enum": [
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string",
      "description": "day, week, month or year. Month is the default."
    }
  }
}

get_site_readiness

(needs account token) Award readiness checklist for one claimed site: favicon, share image, title and description, mobile viewport, page weight, custom domain, https, and a real page. Read-only. Does not charge. Does not promise a ranking.

read-only

Argument	Type	Description
host	string	The same address, when you have a host rather than a site field.
site*	string	The address of the site, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "host": {
      "type": "string",
      "description": "The same address, when you have a host rather than a site field."
    },
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    }
  }
}

get_site_status

(needs account token) Whether one claimed site is live, its domains and renewals, its email, and whether the previous version can be restored. Read-only. Does not charge.

read-only

Argument	Type	Description
site*	string	The address of the site, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    }
  }
}

list_form_submissions

(needs account token) Lists recent messages from a claimed site's contact form. Read-only.

read-only

Argument	Type	Description
site*	string	The address of a claimed site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a claimed site on this account, for example myproject.dropthehassle.app."
    }
  }
}

list_invoices

(needs account token) Lists the account's invoices with date, amount and a printable link. Read-only. Does not charge.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_site_files

(needs account token) Lists file paths on a site you can update. site is the address, for example myproject.dropthehassle.app. A site token for that site works, including before the site is claimed, the same way an update with that token does. Without a token, claim the site first. Read-only. Does not charge.

read-only

Argument	Type	Description
site*	string	The address of the site, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    }
  }
}

list_site_leads

(needs account token) Latest form messages for one claimed site. limit is how many to return, at most 50. Read-only. Does not charge.

read-only

Argument	Type	Description
site*	string	The address of the site, for example myproject.dropthehassle.app.
limit	integer	How many messages to return. At most 50. 50 is the default.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    },
    "limit": {
      "type": "integer",
      "description": "How many messages to return. At most 50. 50 is the default."
    }
  }
}

list_sites

(needs account token) Lists the account's sites with live link, status and the domains on each.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

make_primary_domain

(needs account token) Chooses which of a site's domains is its main name: the one that serves the site and that search engines and shared links use. The site's other domains redirect (301) to it. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain*	string	One of the domains already on the site.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "domain",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "One of the domains already on the site."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

point_domain

(needs account token) Moves a domain that is already on the account to another of its sites, or back onto a site it was split from. Does not buy a name and does not edit DNS at another registrar. confirm=true applies the move. Does not charge.

destructive

Argument	Type	Description
domain*	string	A domain already on this account.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.
to_site*	string	The address of the site to point it at, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "to_site",
    "confirm"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "A domain already on this account."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    },
    "to_site": {
      "type": "string",
      "description": "The address of the site to point it at, for example myproject.dropthehassle.app."
    }
  }
}

remove_email_address

(needs account token) Removes one email address from a site's domain. Mail to it stops. A mailbox's stored mail is deleted. The main inbox is not removed here. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
address*	string	The address, e.g. "info" or [email protected].
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "address",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "address": {
      "type": "string",
      "description": "The address, e.g. \"info\" or [email protected]."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

rename_main_inbox

(needs account token) Renames the main email address of a site's domain, for example hello@ to info@. Same mailbox, same mail, same price. confirm=true applies it.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
address*	string	The new part before the @, e.g. "info".
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "address",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "address": {
      "type": "string",
      "description": "The new part before the @, e.g. \"info\"."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

request_google_business

(needs account token) Sends the DropTheHassle team a request to set up a Google Business Profile for a site. The team follows up by email. Does not charge.

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    }
  }
}

resend_owner_verification

(needs account token) Sends the registry's owner-confirmation email again for a domain registered here. The account holder confirms it from that email. Does not charge.

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain*	string	The domain registered here.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "domain"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "The domain registered here."
    }
  }
}

resend_receipt

(needs account token) Emails the most recent receipt again to the account email address. Does not charge.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

rollback_site

(needs account token) Restores the previous version of a site. Restore undoes the last Update or Edit files save. Doing it again restores the version that was replaced. confirm=true applies it. Refused for a suspended or inactive site. Does not charge. After the site is claimed, the human can Restore from the site's Update screen.

destructive

Argument	Type	Description
site*	string	The address of the site, for example myproject.dropthehassle.app.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site, for example myproject.dropthehassle.app."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

search_domain

Checks one domain name with the domain registry and returns whether it is available and what it costs. One name per call. A name without an ending, such as mybakery, is checked as .com, .nl and .app in that call. Read-only. Does not register, reserve or charge. A registered name is returned as Unavailable, or as For sale by another party when a marketplace lists it. A registry premium name is returned as premium, separate from a marketplace listing. A single-name result can include a trademark note, which is not legal advice. Works without an account. When the exact name is taken, offer the human the free variant names.

read-only

Argument	Type	Description
name*	string	A full domain such as "myidea.com", or a bare name such as "mybakery" (checked as .com, .nl and .app).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "A full domain such as \"myidea.com\", or a bare name such as \"mybakery\" (checked as .com, .nl and .app)."
    }
  }
}

send_claim_mail

Sends the claim mail for an unclaimed site. site_id and site_token are the values from the deploy reply. email is the address that receives the mail. The site stays unclaimed until the link in the mail is opened. Does not charge.

Argument	Type	Description
email*	string	The address the claim mail is sent to.
site_id*	integer	The site id from the deploy reply.
site_token*	string	The site token from the deploy reply.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site_id",
    "site_token",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "The address the claim mail is sent to."
    },
    "site_id": {
      "type": "integer",
      "description": "The site id from the deploy reply."
    },
    "site_token": {
      "type": "string",
      "description": "The site token from the deploy reply."
    }
  }
}

send_feedback

(needs account token) Sends the DropTheHassle team a note about a site, in the account holder's words. Does not charge.

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
message*	string	The note, 3 to 2000 characters.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "message"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "message": {
      "type": "string",
      "description": "The note, 3 to 2000 characters."
    }
  }
}

set_analytics_level

(needs account token) Switches a site's statistics between standard (cookieless, no banner, the default) and enhanced (adds a cookie consent banner for every visitor, and the click heatmap). Enhanced changes what visitors see. confirm=true applies enhanced. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
level*	string	standard or enhanced.
confirm	boolean	True applies enhanced statistics. False leaves the level unchanged and the reply describes the change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "level"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "level": {
      "enum": [
        "standard",
        "enhanced"
      ],
      "type": "string",
      "description": "standard or enhanced."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies enhanced statistics. False leaves the level unchanged and the reply describes the change."
    }
  }
}

set_backend

(needs account token) Links an HTTPS backend hosted on AWS, Google Cloud, DigitalOcean or your own server to a DropTheHassle name. url is an HTTPS origin with no path, port 443, and a hostname that has an IPv4 address. Paths pass through unchanged. With uploaded files, only the path rules (default /api/*) go to the backend and the rest is served from the files. Without uploaded files, the whole site comes from the backend. Without site, a new site is created in the account. With site, the site is already on the account. An empty url with site removes the link. confirm=true applies a change to an existing site. A new site does not use confirm. Does not charge.

destructive

Argument	Type	Description
url*	string	The HTTPS origin of the backend, e.g. "https://api.example.com". Empty string (with site) unlinks.
site	string	Optional address of an existing site to link, for example myproject.dropthehassle.app. Absent creates a new site served fully from the backend.
slug	string	Optional address label for a NEW site, e.g. "myapp" -> myapp.dropthehassle.app. Errors when taken.
paths	array	Optional path rules for split mode, e.g. ["/api/", "/webhooks/"]. Default ["/api/*"].
confirm	boolean	True applies a change to an existing site. False leaves that site unchanged and the reply describes the change.

Input schema (JSON)

set_site_image

(needs account token) Sets or removes a site's browser icon (favicon) or share image (the picture shown when a link is shared). content is the image as base64. clear true removes the current image. Available once the site has its own domain. Does not charge.

destructive

Argument	Type	Description
file	string	Local server only: path to the image file on this computer.
kind*	string	favicon (browser icon) or share (preview image).
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
clear	boolean	true removes the current image.
content	string	The image file as standard base64 (PNG, JPEG, SVG, ICO, WebP).
filename	string	Optional: the file name, e.g. logo.png.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "kind"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Local server only: path to the image file on this computer."
    },
    "kind": {
      "enum": [
        "favicon",
        "share"
      ],
      "type": "string",
      "description": "favicon (browser icon) or share (preview image)."
    },
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "clear": {
      "type": "boolean",
      "description": "true removes the current image."
    },
    "content": {
      "type": "string",
      "description": "The image file as standard base64 (PNG, JPEG, SVG, ICO, WebP)."
    },
    "filename": {
      "type": "string",
      "description": "Optional: the file name, e.g. logo.png."
    }
  }
}

set_site_indexing

(needs account token) Asks search engines to skip a claimed site, or to list it again. mode is allow or noindex. Claim the site first. Does not charge.

Argument	Type	Description
mode*	string	allow lists the site. noindex asks search engines to skip it.
site*	string	The address of a claimed site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "allow",
        "noindex"
      ],
      "type": "string",
      "description": "allow lists the site. noindex asks search engines to skip it."
    },
    "site": {
      "type": "string",
      "description": "The address of a claimed site on this account, for example myproject.dropthehassle.app."
    }
  }
}

set_site_password

(needs account token) Sets a password visitors type before a claimed site opens. An empty password makes the site public. Works on the free link and on a custom domain. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
password*	string	The password visitors type. Empty makes the site public.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "password"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "password": {
      "type": "string",
      "description": "The password visitors type. Empty makes the site public."
    }
  }
}

sign_in

Returns a link the user opens to sign in to DropTheHassle. They enter their email, the 6-digit code, and approve. The next call in this chat is signed in. Nothing to copy.

read-only

Argument	Type	Description
pending	string	A short code from an earlier sign-in link, when this chat did not keep its session.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "pending": {
      "type": "string",
      "description": "A short code from an earlier sign-in link, when this chat did not keep its session."
    }
  }
}

site_analytics

(needs account token) Returns visitor numbers for a site on this account: visitors, page views, top pages, referrers, countries and devices, plus a one-sentence summary. Same numbers as the dashboard. Read-only.

read-only

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
period	string	day, week, month (default) or year.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "period": {
      "enum": [
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string",
      "description": "day, week, month (default) or year."
    }
  }
}

site_of_the_day_badge

(needs account token) Returns the embed line for a Site of the Month award. The ribbon names the award and the period and links to the verification page. site selects a site on this account. host selects a confirmed winner. With neither, the reply lists awards this account has earned. Read-only. Does not charge.

read-only

Argument	Type	Description
host	string	Optional. The public host that was featured.
site	string	Optional. The address of a site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "host": {
      "type": "string",
      "description": "Optional. The public host that was featured."
    },
    "site": {
      "type": "string",
      "description": "Optional. The address of a site on this account, for example myproject.dropthehassle.app."
    }
  }
}

site_status

(needs account token) One read of a site: whether it is live, its links, recent deploys, whether the previous version can be restored, its domains with renewal date and auto-renew, and its email. Read-only.

read-only

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    }
  }
}

split_domain

(needs account token) Moves one domain off a site that has several, onto a new site that shows a coming-soon page. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain*	string	The domain to split off. One of the domains already on the site.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "domain",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "The domain to split off. One of the domains already on the site."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

transfer_domain_out

(needs account token) Starts moving a domain registered here to another registrar. Auto-renew goes off and the transfer code is emailed to the account within a day. The domain keeps working until it moves. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of the site the domain belongs to, for example myproject.dropthehassle.app.
domain	string	Optional: which domain of that site. Default: its main domain.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of the site the domain belongs to, for example myproject.dropthehassle.app."
    },
    "domain": {
      "type": "string",
      "description": "Optional: which domain of that site. Default: its main domain."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

turn_off_email

(needs account token) Turns off email for a site's domain. It stops renewing and keeps working until the end of the month already paid. Turning it back on is not done here. confirm=true applies it. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
confirm*	boolean	True applies the change. False leaves it unchanged and the reply describes what would change.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "site",
    "confirm"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "The address of a site on this account, for example myproject.dropthehassle.app."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies the change. False leaves it unchanged and the reply describes what would change."
    }
  }
}

update_site_settings

(needs account token) Sets how a site appears in search results and when a link is shared: site name, brand colour, search title and description, share title and description. Applies to the whole site, or to one domain when domain is set. Available once the site has its own domain. Does not charge.

destructive

Argument	Type	Description
site*	string	The address of a site on this account, for example myproject.dropthehassle.app.
domain	string	Optional: apply to this one domain of the site only.
serp_title	string	Optional: the title in search results.
brand_color	string	Optional: a hex colour, e.g. "#1a73e8".
share_title	string	Optional: the title when the link is shared.
display_name	string	Optional: the site's name.
serp_description	string	Optional: the description in search results.
share_description	string	Optional: the description when the link is shared.

whoami

Reports the DropTheHassle connection. Without an account it reports which actions are available with no sign-in. With an account it names the account.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "required": [
    "files"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Address label, for example \"lisas-bakery\" for lisas-bakery.dropthehassle.app. Used when creating a site. Works with no account token."
    },
    "site": {
      "type": "string",
      "description": "Optional site address to update, for example myproject.dropthehassle.app. Absent fills the oldest reserved address on the account."
    },
    "slug": {
      "type": "string",
      "description": "Same as name. Older clients send this."
    },
    "email": {
      "type": "string",
      "description": "Optional. Where the claim link and up to 3 reminders are sent. Ask after go-live, not before. Do not make one up. Omit it to publish with a claim link only."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "path",
          "content"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "Relative path, for example index.html or css/site.css."
          },
          "content": {
            "type": "string",
            "description": "File contents. UTF-8 text, or standard base64 when encoding is base64."
          },
          "encoding": {
            "enum": [
              "utf8",
              "base64"
            ],
            "type": "string",
            "description": "utf8 (default) or base64."
          }
        }
      },
      "description": "Site files sent inline. Each item has path, content, and encoding utf8 or base64. node_modules, .git and hidden files are not part of the site. .well-known is allowed."
    }
  }
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The HTTPS origin of the backend, e.g. \"https://api.example.com\". Empty string (with site) unlinks."
    },
    "site": {
      "type": "string",
      "description": "Optional address of an existing site to link, for example myproject.dropthehassle.app. Absent creates a new site served fully from the backend."
    },
    "slug": {
      "type": "string",
      "description": "Optional address label for a NEW site, e.g. \"myapp\" -> myapp.dropthehassle.app. Errors when taken."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional path rules for split mode, e.g. [\"/api/*\", \"/webhooks/*\"]. Default [\"/api/*\"]."
    },
    "confirm": {
      "type": "boolean",
      "description": "True applies a change to an existing site. False leaves that site unchanged and the reply describes the change."
    }
  }
}