FFxF

net.ffxf/cloud · v1.12.0 · data-and-databases

FFxF is healthy: it completed an MCP handshake in 660 ms and exposes 71 tools.

Create and manage VMs, managed databases, firewalls and load balancers in Montréal, Canada.

Endpoint: https://ffxf.net/mcp (streamable-http)

No repository listed · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count71
Latency660 ms
Last checked (UTC)2026-10-29T00:50:12.351Z

Health history

Checked (UTC)StatusLatencyError
2026-10-29T00:50:12.351ZHealthy660

Tools (71)

list_regionsWhere machines can run. Public, no key needed.
list_plansPlans with their resources and prices (hourly and monthly, in CAD). Public, no key needed.
list_imagesOperating systems and ready-to-use application images. The slug is what create_vm expects. Public, no key needed.
get_accountCredit balance, hourly burn rate and runway, quota and budget caps. Scope: billing.read.
list_vmsThe account's machines with their status, addresses and billing. Scope: vms.read.
get_vmOne machine: status, IPv4, IPv6 /64, specs, traffic (Internet only, this traffic month: used_gb, limit_gb, period_ends_at), billing, suspension. Scope: vms.read.
get_vm_metricsCPU, memory, disk and network as measured from outside the machine. Scope: vms.read.
estimate_vmRuns every check of create_vm and prices it, without creating anything: would_succeed, hourly rate, monthly price, credit required. Call it before create_vm. Scope: vms.create.
create_vmOrders a machine and spends credit (hourly) or raises an invoice (monthly). Returns the machine and a provisioning action to poll with get_action. Retrying the same order is safe: it is deduplicated for 24 hours. Scope: vms.create.
power_vmstart, shutdown (clean ACPI), reboot, or stop (hard power-off). Returns an action to poll with get_action. Scope: vms.action.
rename_vmChanges the hostname, inside the guest and in the console. Scope: vms.action.
reinstall_vmERASES THE DISK and redeploys another image. Ask the user first. confirm_hostname must be the machine's exact current hostname. Scope: vms.action.
destroy_vmDESTROYS the machine and its disk, with no undo and no backup kept. Ask the user first. confirm_hostname must be the machine's exact hostname. Scope: vms.destroy.
get_actionFollows an asynchronous action (create, reinstall, power…). Poll until status leaves running; on error it carries the reason. Scope: vms.read.
list_vm_actionsHistory of actions on one machine, from the API and the console. Scope: vms.read.
get_vm_networkIPv4 and IPv6 addresses of a machine with their reverse DNS, and its private networks. Scope: vms.read.
set_reverse_dnsSets the PTR record of one of the machine's addresses; null restores the default. Scope: network.write.
list_vpcsThe account's private networks with their range, gateway and connected machines, plus the quota. Scope: vms.read.
get_vpcOne private network and the machines on it, with their private address. Scope: vms.read.
create_vpcCreates an isolated private network; ready when the call returns. The first usable address (.1) is reserved for the gateway. Scope: network.write.
delete_vpcDeletes an empty private network. Refused while a machine is still on it: disconnect or destroy those first. Ask the user first. Scope: network.write.
connect_vpcHot-adds a card on the private network and sets its address in the system, without a restart. configuration: manual means the address must be set by hand in the guest. Connecting again returns the same address. Scope: network.write.
disconnect_vpcRemoves the machine's private address and card, without a restart. Refused for the only network of a machine with no public address. Scope: network.write.
move_vpcJoins the target network, then leaves this one, so the machine is never cut off. Keeps the same address ending when free. Scope: network.write.
list_firewallsThe account's firewalls with their inbound rules and the machines they protect, plus the quota. Scope: vms.read.
get_firewallOne firewall: its rules and the machines it protects, with the status of each (applied, pending, error). Scope: vms.read.
create_firewallCreates a reusable set of inbound and outbound rules. Without rules it starts with SSH (TCP 22) and ping open from anywhere; pass rules: [] for none. Nothing is filtered until it is attached to a machine. Scope: network.write.
update_firewallrules REPLACES the whole list and is applied at once to every attached machine: send every rule to keep, not only the new one (read get_firewall first). Removing the SSH rule can lock the agent out. pending_machines counts machines not updated yet, retried automatically. Scope: network.write.
delete_firewallDeletes a firewall attached to no machine. Refused while it protects one: detach it first. Scope: network.write.
attach_firewallFrom now on the machine refuses inbound traffic no rule of its firewalls opens; enforced within about ten seconds of the call. Up to 5 firewalls per machine, rules add up. Refused for a machine with no public address. Attaching again is harmless. Scope: network.write.
detach_firewallRemoves the firewall's rules from the machine; with no other firewall it accepts all inbound traffic again. Scope: network.write.
list_load_balancersThe account's load balancers with their addresses, pools, targets and health, listeners and rules, certificates; plus the quota. Scope: vms.read.
get_load_balancerOne load balancer in full: status, ipv4/ipv6 to put in DNS, pools with targets (health, sessions, response time), listeners with rules in evaluation order, certificates. Scope: vms.read.
get_load_balancer_metricsRequests by response class, connections, bytes in/out and peak sessions over 1h (1-minute buckets), 24h (15 minutes) or 7d (1 hour), plus totals. Scope: vms.read.
create_load_balancerOrders a load balancer in a private network, billed by the hour from now (the account needs 24 hours of credit), or by the month (7.30 CAD) or the year (73 CAD) with billing. A monthly or yearly period comes out of credit if it covers it; otherwise billing.pending_invoice holds the invoice to pay an
delete_load_balancerDeletes the load balancer, its address and its configuration; billing stops. Target machines are not touched. Ask the user first. Scope: vms.destroy.
upsert_poolWithout pool: creates one (name required, up to 10). With pool: changes only the fields given. Deleting a pool also removes its targets and the rules leading to it. Scope: network.write.
delete_poolRemoves a pool, its targets and the rules leading to it. Scope: network.write.
set_targetsREPLACES the pool's targets with exactly this list (up to 25): send every target to keep. Each machine must be in the load balancer's private network (connect_vpc first). drain: true stops new connections to a target before maintenance. Scope: network.write.
upsert_listenerAn entry port on the load balancer's address. Without listener: opens one (port and protocol required, up to 5; 22 and 8402 are reserved). https gets certificates for its rules' hostnames; redirect_https makes port 80 redirect to it. A tcp listener needs a tcp default_pool. sources restricts who may
delete_listenerCloses the port and removes its rules. Scope: network.write.
set_rulesREPLACES the http/https listener's rules: each sends a hostname and/or path prefix to an http pool (up to 25). They are evaluated most specific first, whatever the order sent; anything unmatched goes to the default pool. No wildcard hostname on https. Each https hostname gets a certificate once it p
list_databasesThe account's managed databases with their status, private and public addresses, disk, backups and billing (no passwords), plus the quota. Scope: vms.read.
get_database_optionsWhat can be ordered: engines and versions, extensions, sizes with their hourly, monthly and yearly prices per region, and the price of disk beyond what a size includes. Call it before create_database and show the price to the user. Scope: vms.read.
get_databaseOne database: status, connection (host, private ip, port, defaultdb and ffxfadmin; on Valkey no database and default), public access and sources, disk usage and cap, users with their databases (null: all) and read_only, logical databases and extensions, Valkey's eviction policy and data memory, back
get_database_credentialsEvery user with its password, databases and read_only, and its own connection_uri; ready-made connection strings for the admin (private network, and public when open). Treat the result as a secret: give it to the application through an environment variable or a secret store, never into code, commits
get_database_metricsCPU, memory, connections and commits per minute (commands per minute on Valkey) over 1h (1-minute buckets), 24h (10 minutes) or 7d (1 hour); only buckets with samples. Scope: vms.read.
get_slow_queriesThe 20 queries with the most total time (pg_stat_statements, values replaced by $1, $2…; performance_schema on MySQL and MariaDB, values replaced by ?): calls, total and mean time, rows. A starting point for indexes. On Valkey, the commands with the most total time since the engine started (GET, HSE
list_database_backupsCompleted backups (weekly full, daily differential; the transaction log is archived continuously) and the restore window: any minute in it can be restored with restore_database. On Valkey, snapshots (rdb) every hour when there were writes, all kept 24 hours, then one a day. Scope: vms.read.
create_databaseOrders a managed database (PostgreSQL, MySQL, MariaDB or Valkey) in a private network, billed by the hour from now (the account needs 24 hours of credit), or by the month (730 hours) or the year (ten months) with billing; get_database_options gives each price. A monthly or yearly period comes out of
restore_databaseCreates a NEW database, billed like any other, holding the data as it was at a given minute of the source's restore window (list_database_backups; Valkey: the last snapshot before that minute), with the same users and passwords. The source is not touched and may have been deleted in the last 7 days.
fork_databaseCreates a NEW database, billed like any other, whose data is an instant copy of this one (for a test or staging copy), with the same users and passwords. It stays linked to its source for up to 7 days (no backups of its own, the source cannot be deleted) unless detach_database_fork ends that sooner.
detach_database_forkGives a linked fork its own copy of the data; the database is unavailable for about 30 seconds, then its backups start. Scope: vms.action.
resize_databaseMoves the database to a LARGER size (more vCPU, memory and included disk; see get_database_options): same data, users, names and addresses. It restarts: one to two minutes of downtime, status maintenance meanwhile (resize.to_gb set), then active with the new size_gb. The new rate applies from the ne
delete_databaseDELETES the database and its data; billing stops. Ask the user first. confirm_name must be the database's exact name. Its backups stay 7 days (restore_database can bring it back meanwhile). Refused while a linked fork depends on it. Scope: vms.destroy.
update_databaseAny of: the name; the weekly maintenance window (day 0 = Sunday, start hour, Montréal time, 2 hours long; minor updates, usually under 2 minutes of downtime); the disk cap (the disk grows by itself at 80 % full, up to the cap; disk beyond what the size includes is billed per GB); on Valkey, the evic
set_database_public_accessOpens the database to the internet at its public host and port (IPv4 and IPv6, TLS and password still required), or closes it. sources restricts who may connect (IPv4/IPv6 addresses or ranges); omitted it is left as is, null or [] means everyone. Prefer listing the user's addresses. Live within abou
backup_databaseStarts a differential backup within a minute, e.g. before a risky migration. Not available on a linked fork. Scope: backups.write.
create_database_userCreates a user with a generated password, returned here once (also readable with get_database_credentials); live within seconds. Up to 30 users. It connects only to its databases (every logical database, future ones included, when databases is omitted): it reads and writes everything there and creat
set_database_user_accessSets the logical databases a user connects to (databases: a list, or null for all of them, future ones included) and whether it only reads; a field left out keeps its value. Applied within seconds; where its access is removed or lowered, its open connections are closed, so tell the user first if an
reset_database_passwordGives the user a new password, returned here; the old one stops working within seconds, so update the application first or right after. Scope: databases.write.
delete_database_userHands the user's objects to the admin, then drops the user. The admin (ffxfadmin, or default on Valkey) cannot be deleted. Scope: databases.write.
create_logical_databaseCreates another database inside the managed database (like defaultdb), owned by the admin; up to 30. Not on Valkey (numbered databases, SELECT 0 to 15). Scope: databases.write.
delete_logical_databaseDROPS the logical database with everything in it (the backups keep it 7 days). Ask the user first. Scope: databases.write.
enable_extensionPostgreSQL only. Enables an extension from get_database_options (vector for pgvector, postgis, pg_trgm…) in one logical database; installed on demand, live within a minute. Scope: databases.write.
disable_extensionDrops the extension without CASCADE: if objects depend on it, it stays and get_database shows why in warning. Scope: databases.write.
get_runnersThe runs-on labels with their vCPU, memory and price per minute, the account's concurrency (vCPU of jobs starting or running, and the cap), the linked GitHub organizations and accounts, this month's minutes and cost per repository, the actions cache next to the runners (bytes, entries and last use p
list_runner_jobsJobs that ran or wait on FFxF runners, most recent first: repository, workflow and job, label, status (queued with waiting_reason credit, budget or account; running; succeeded; failed, stopped_for_credit when the credit ran out; cancelled; refused with refusal), times, billed minutes and amount, lin
list_ssh_keysSSH keys saved on the account, to pass to create_vm. Scope: sshkeys.write or vms.read.
add_ssh_keySaves a public key on the account so new machines can be reached without a password. Scope: sshkeys.write.
delete_ssh_keyRemoves a key from the account. Machines already deployed with it keep it; only future deployments change. Scope: sshkeys.write.