Developers

Connect your AI assistant to Squish

Squish runs a Model Context Protocol server. Point Claude Code, Claude Desktop, Cursor, or any MCP client at it with a key from your dashboard, and your assistant gets the same guarded actions the Squish assistant has on your account. Never a server. Never a raw API.

The endpoint is https://api.squish.co/mcp. Keys are created in your dashboard under the Assistant tab, Connected assistants, shown once, and revocable any time.
01

What your assistant can do

Two kinds of key:

  • Read. Your domains, DNS records, hosting and site health, mailboxes and migrations, support cases, orders, the public pricing catalogs, and the full diagnostic set (DNS, WHOIS, SSL, email authentication, security headers, uptime, blacklist checks).
  • Read and write. Everything above, plus single-record changes: one DNS record at a time, auto-renew on or off, domain forwarding, your billing address and phone, notes on a support case. Every write is two steps: the assistant asks for a preview, then applies it. Creating a read-and-write key requires two-factor authentication on your login.

A read-and-write key or connection can also be allowed to buy domains: it may pay for a domain it prepared, on your saved card, up to per-purchase and daily caps you set ($100 and $250 unless you change them, $500 and $1,000 at most). Off unless you choose it, and every purchase is emailed to you.

What no key can do, in any scope: cancel hosting, change nameservers or request a transfer code, start or confirm an email migration, change the account email, make bulk DNS changes, or turn the assistant permission on. Those stay behind a person in the dashboard.

02

Set up

The short way: sign in and tell the Squish assistant “set up MCP”. It explains the two scopes, creates the key with you, shows it once in the chat, and gives you the line below with your key already in it.

The manual way: turn on Let the assistant act on my account in your dashboard first. Keys use the same permission, and a key cannot be created while it is off. Then create a key in the Connected assistants row and add the server to your client.

Claude Code

claude mcp add --transport http squish https://api.squish.co/mcp \
  --header "Authorization: Bearer sq_mcp_…"

Claude desktop and claude.ai — no key needed. Add https://api.squish.co/mcp as a custom connector (Settings → Connectors → Add custom connector), sign in to Squish in the window that opens, choose read or read-and-write, and approve. The connection appears in Connected assistants like a key and is revoked the same way.

ChatGPT — no key either, but a different door. On the web, open chatgpt.com/plugins, select +, then Add custom MCP server, paste https://api.squish.co/mcp as the server URL, choose OAuth, tick the risk notice, and select Create as a plugin. Sign in to Squish and approve as above. In a chat, type @ and pick Squish. OpenAI offers custom MCP servers on Business and Enterprise/Edu workspaces, on the web only; if the plus menu has no such item, your plan does not include it, and a key with another client is the way in. Claude Code also accepts this path: claude mcp add --transport http squish https://api.squish.co/mcp with no header, then /mcp to sign in.

Cursor and other clients — add a remote MCP server with the URL above and an Authorization: Bearer sq_mcp_… header. Each client has its own settings screen for this; the server needs nothing else.

Then ask your assistant something it can only answer with your account: “Why is mail for acme.com failing?” It will read your DNS and run the email checks, and with a read-and-write key it can offer to add the missing record.

03

How keys behave

  • A key is tied to one account and one login. It cannot see or act on any other account.
  • A key expires 90 days after it is made. Revoke it earlier from the same row; a revoked or expired key stops within a minute.
  • At most ten active keys and connections per account.
  • Creating a key sends you an email. Every call your assistant makes is logged on your account the same way the Squish assistant’s actions are.
  • Calls are rate-limited per key, and changes are rate-limited per account, the same limits the Squish assistant has.
04

Treat results as data

Some tools return text from outside Squish: WHOIS records, DNS values, headers and content fetched from a website. That text is returned to your assistant as data. It is not an instruction, and a well-built client will not treat it as one. If you are writing your own agent, keep that boundary.

05

Everything a connection can do

The full list, read from the server’s own tool registry so it is never out of date. “Read” tools look; “write” tools change one thing, preview first, and apply only after your explicit yes. The scope column says which key or connection can call it.

59 tools in 10 areas: 37 read, 22 write. Tools marked “shared hosting” work on shared hosting sites; a Managed Cloud server has its own panel for those.

Account

get_account_infoReturns the customer's profile on file — name, email, phone, billing address, company, and account number.read
list_my_recent_ordersReturns recent orders on the customer's account, with order number, total, status, effective date, and what has been refunded.read
update_account_addressUpdate the customer's billing address on file (Stripe + Salesforce).writeread-write
update_account_phoneUpdate the phone number on the customer's account (Stripe + Salesforce).writeread-write

Support

list_my_casesReturns the customer's support tickets (Salesforce Cases) — ticket number, subject, status, priority, and when it was opened.read
close_my_caseClose one of the customer's OWN support tickets (Salesforce Cases) when they say the issue is resolved.writeread-write
add_case_noteAdd a note / reply from the customer to one of their OWN support tickets (Salesforce Cases) — the note lands on the case as a public comment the support team can see.writeread-write
reopen_my_caseReopen one of the customer's OWN support tickets (Salesforce Cases) that was closed — use when a previously-resolved issue has come back or was never actually fixed.writeread-write

Domains

search_domainsSearch domain-name availability and pricing.read
list_my_domainsReturns the list of domains the customer owns through Squish, with status, expiry, auto-renew, order number, and purchase date.read
get_my_domain_transfersWhere the customer's inbound domain transfers stand, one row per domain, with counts: awaiting_code (paid, the customer still has to enter the transfer code in their dashboard — orread
toggle_autorenewTurn auto-renew on or off for a domain the customer owns.writeread-write
setup_domain_forwardingConfigure URL forwarding so visits to the domain (and its www) redirect to a target URL.writeread-write

DNS

get_dns_recordsReturns the DNS records currently set on a domain the customer owns (A, AAAA, CNAME, MX, TXT, NS, etc.) — same data as the registrar's DNS panel.read
update_dns_recordUpdate an existing DNS record on a domain the customer owns.writeread-write
create_dns_recordCreate a new DNS record on a domain the customer owns.writeread-write
delete_dns_recordDelete a DNS record on a domain the customer owns.writeread-write

Purchases

prepare_domain_purchasePrepares the purchase of an AVAILABLE domain for this customer and returns a checkout link: the domain is priced and placed in a cart on their Squish account, and the link opens thwriteread-write
prepare_domain_transfersPrepares moving one or more domains the customer already owns at ANOTHER registrar to Squish, and returns ONE checkout link for all of them: each eligible domain is priced and placwriteread-write
pay_prepared_purchasePays a cart that prepare_domain_purchase created, on the customer's saved card, within the spending caps the customer set when they granted purchases to this connection.writepurchase grant

Hosting

list_my_hostingReturns the list of hosting sites the customer has provisioned, with the panel URL, setup type (general / WordPress / AI Quick Start), and Plesk login.read
get_my_site_healthReturns MEASURED uptime history for the customer's own hosted sites — how the site has BEEN over a trailing window, from our SLA monitoring record.read
diagnose_my_serverDiagnoses performance on the customer's own VPS from the server's telemetry — CPU load relative to their plan's vCPU count, memory pressure, and disk fullness — and explains in plain language what is wrong.read
list_my_backupsLists the restore points held for one of the customer's SHARED hosting sites, newest first: the nightly backups of the whole site (source "nightly") and the edit points (source "ed · shared hostingread
restore_my_site_backupRestores one of the customer's SHARED hosting sites from a restore point. · shared hostingwriteread-write
get_my_cdn_statsReturns whether the CDN (edge cache) is on for one of the customer's hosting sites and, for a Managed Cloud server, the last 30 days of edge traffic across the sites on that server: requests, bandwidth, cache hit rate.read
purge_my_cdn_cacheClears the CDN edge cache for one of the customer's hosting sites so visitors get the latest files right away.writeread-write
set_my_cdnTurns the CDN (edge cache in front of the site) on or off for one of the customer's hosting sites.writeread-write
list_site_filesLists one folder of a customer's SHARED hosting site's web root (the files the site serves): name, type (file / dir / symlink), size. · shared hostingread
read_site_fileReturns the text of one file in a customer's SHARED hosting site's web root (HTML, CSS, JS, JSON, text…), up to 512 KB. · shared hostingread
write_site_filesWrites (creates or replaces) up to 25 web files in a customer's SHARED hosting site's web root and publishes them immediately — this is how an assistant puts an edit on the live site. · shared hostingwriteread-write
get_site_import_statusWhere a "Move a site here" import stands for one of the customer's hosting sites: whether an import can start, the current run (kind, phase, progress) or the preview waiting to goread
get_hosting_upgrade_optionsWhich higher plan tiers one of the customer's hosting sites can move up to, with each tier's monthly sticker and whether it is eligible (and why not).read
get_my_site_runtimeReturns what one of the customer's SHARED hosting sites actually runs, read from the server: the PHP version the site uses down to the patch level (e.g. · shared hostingread

AI Visibility

check_ai_visibilityCheck how legible and citable a business website is to AI answer engines (ChatGPT, Perplexity, Google AI answers) and get an A-F grade with plain-English findings.read
plan_ai_visibility_fixesFor a website, scan it AND return a reviewable PLAN of proposed fixes to make it more legible to AI answer engines — generated business structured data (schema), a meta descriptionread
apply_ai_visibility_fixesApplies AI Visibility fixes to one of the customer's OWN hosted WordPress sites — adds business structured data (schema), a meta description, and an FAQ page.writeread-write
run_my_ai_visibility_reportRuns an AI Visibility report on one of the customer's OWN Squish-hosted sites and SAVES it to their history, so the grade can be tracked over time (the CRM shows it move).writeread-write
get_my_ai_visibility_coverageWhich domains a customer's AI Visibility plan watches: the plan's own site plus the extra domains they have added, each with how it was verified and its latest grade (null grade =read
add_ai_visibility_coverageAdds one more domain to a customer's AI Visibility plan (up to 3 extra).writeread-write
remove_ai_visibility_coverageRemoves a domain from a customer's AI Visibility coverage, freeing its slot.writeread-write

Email

list_my_migrationsList the customer's email migrations across all states (in-progress, scheduled, complete, cancelled).read
get_migration_statusGet the full state of a single email migration: current stage, the tenant ID we discovered, the SKU mapping the orchestrator proposed (sourceSkus / targetSkus), the scheduled cutovread
detect_email_providerInspect a customer's email domain via Microsoft's public getuserrealm.srf endpoint to figure out whether their Microsoft 365 is bought direct from Microsoft or resold through GoDaddy.read
advance_email_migrationDrive a migration to its next stage.writeread-write

Diagnostics (any site)

check_email_authCheck a domain's email authentication posture — SPF, DKIM, and DMARC — and get an A-F grade with plain-English findings.read
lookup_dnsLook up DNS records for any domain — A, AAAA, MX, TXT, NS, and CNAME.read
lookup_whoisLook up WHOIS / RDAP registration info for any domain.read
check_sslCheck the SSL/TLS certificate for a domain.read
check_uptimeCheck whether a website is up and reachable right now.read
check_security_headersCheck a website's HTTP security headers and get an A-F grade.read
lookup_ip_hostingLook up the IP address(es) for a domain and identify which network announces them — ASN, AS name, BGP prefix, registry, and the registry country for the allocation.read
check_blacklistCheck whether a domain or its IP address appears on major spam and malware blacklists (Spamhaus ZEN, SORBS, SpamCop, Barracuda, Spamhaus DBL, URIBL, SURBL).read
trace_redirectsTrace the full HTTP redirect chain for a domain — follows every hop (up to 15) and reports each URL and status code.read
detect_technologyDetect the technologies powering a website — CMS (WordPress, Shopify, Drupal, etc.), CDN (Cloudflare, Fastly, CloudFront, etc.), web server, frontend framework (Next.js, Gatsby, Nuxt, etc.), and analytics platforms.read
scan_portsScan common TCP ports on a domain to see which services are publicly accessible.read
detect_web_hostFind out WHO HOSTS a website — the hosting company behind a domain, plus the CDN in front of it, the DNS provider, and the email provider.read

Pricing and catalogs

get_public_pricingFetch the live public Squish pricing catalogs.read
list_capabilitiesLists everything a Squish connection or the Squish assistant can do, grouped by area (account, domains, DNS, purchases, hosting, AI Visibility, email, diagnostics, catalogs), withread

Not offered to any connection: changing your login email or nameservers, transfer codes, starting or cancelling an email migration, cancelling hosting, bulk DNS changes, and managing keys. Those stay in the dashboard or the Squish assistant.

06

Skills file

A short skills file with the workflows that make the connection worth having — point a domain at hosting, find out why email is failing, check a site before a launch, read your AI Visibility report — is at squish.co/squish-skill.md. Drop it into your client’s skills or instructions folder.

Questions, or a tool you wish was here? Open a case from your dashboard.

Squish is operated by Squish LLC — © 2026