Skip to content

AI assistants (MCP)

Qlyne has an MCP server: an AI assistant can operate your sites with your account API key. Rules (the same document as rules as code), waiting room events, what is being blocked, IP lists, access gates, the scanner, sites and domains, and hosting by Qlyne. Billing, members and API keys stay out on purpose.

The server is at https://app.qlyne.com/mcp (HTTP transport). Authenticate with the account API key from Account › API key as a Bearer token.

Claude Code:

Terminal window
claude mcp add --transport http qlyne https://app.qlyne.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor, Claude Desktop or any client that takes a JSON config:

{
"mcpServers": {
"qlyne": {
"url": "https://app.qlyne.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}

A key generated before October 2026 also needs the header X-Tenant-ID with the id of one of your sites. Generating a new key in the panel removes that need.

Every tool takes the site id from list-sites.

ToolWhat it does
list-sitesYour sites: id, name, plan, mode and domains
get-rulesThe whole rules document of a site, as YAML
validate-rulesChecks a document without saving; every problem comes back with its path
apply-rulesSaves the document and tells the Qlyne servers; visitors see it within a minute
list-eventsWaiting room events: key, open or closed, stage, release rate, capacity, times, live queue numbers
save-eventCreates an event or changes one: name, target URL, release rate, capacity, start and end, open or closed
release-visitorsLets a number of people through an event right now
delete-eventDeletes an event and empties its queue
traffic-summaryLast 24 hours or 7 days: requests, passed, challenged, queued, blocked, each decision, spikes, top countries, paths, IPs, networks and user agents
recent-eventsRecent requests the rules acted on, with the reason in words; filter by what happened, search any field
site-metricsLive counters of the site (Prometheus text): decisions, queues, rate limits
ip-rulesThe IP lists: list, block, trust, remove
access-gatesPassword or e-mail link in front of paths: list, save, remove
run-scanStarts the security scanner on the confirmed domain
scan-reportThe latest finished scan: grade, findings with impact and fix, what was resolved
create-siteAdds a site to the account
set-domainSets the site domain and shows the TXT record that proves it is yours
check-domainLooks the TXT record up and confirms the domain
hosted-proxyHosting by Qlyne: show, set origins with weights, hosts and options, or turn it off

The assistant reads before it writes, so it never guesses a field name. Ask it in plain words:

Put loja in enforce mode and block Tor, but keep the waiting room as it is.

Open a waiting room for the drop on Friday at 8 pm, 200 people a minute, and send /drop to it.

Who was blocked in the last hour, and why?

apply-rules and delete-event are marked destructive in the protocol, so well-behaved clients confirm them with you.

120 calls a minute per account. The document has to be sent whole, not in parts, and up to 256 KB.