MCP tool reference

Interfold MCP tools map to the normal REST resources. Tool responses preserve the API’s structured JSON. List tools accept optional limit and offset and return their resource-specific array plus pagination; continue with pagination.nextOffset while pagination.hasMore is true.

Sites

Tool	Effect
list_sites	List sites in the authorized account.
create_site	Create a Site, optionally with an existing bucket.
get_site	Read one Site and reconciliation state.
update_site	Change name, access, status, or retry reconciliation.

See Sites API.

Buckets

Tool	Effect
list_buckets	List account-owned buckets.
create_bucket	Create storage.
get_bucket	Read bucket metadata.
update_bucket	Rename a bucket.

See Buckets API.

Files

Tool	Effect
list_files	List files or find an exact path.
read_file	Read text content and metadata up to 256 KiB.
write_file	Create or replace a complete text file.
delete_file	Delete a file.
list_file_versions	List recent revisions by stable file_id.
read_file_version	Read historical text content up to 256 KiB.
restore_file_version	Restore content with an expected current version ID.

Path-based file tools take an explicit bucket_id; history tools take the stable file_id returned by file metadata. Get a bucket ID from get_site or list_buckets. The 256 KiB text limit protects agent context and is an Interfold MCP client policy, not an MCP protocol limit. Download larger or binary revisions through the Files API or CLI. write_file accepts optional expected_current_version_id for conflict protection and returns the saved version ID. A restore creates another version; it does not change the file path or access rules.

Functions

Tool	Effect
list_functions	List deployed functions and current status.

Deploy by writing source to /api/<name>.ts; there is no separate MCP deploy tool. See Functions API.

Databases

Tool	Effect
list_databases	Inspect the site database and binding state.
create_database	Create or resume database provisioning.
list_database_migrations	List successful cloud migration metadata.
get_database_migration	Read one successful receipt and its stored SQL.
apply_database_migration	Apply one migration with explicit confirmation.

See Databases API.

Secrets

Tool	Effect
list_secrets	List names and metadata without values.
set_secret	Create or replace a secret.
delete_secret	Delete a secret.

There is intentionally no get_secret tool. See Secrets API.