Agentic Platform
Documentation API reference Tools Skills

Tools

Speedworkers Config

speedworkers_config MCP

Get the SpeedWorkers configuration of the production version (default), the draft version, or a specific version

Retrieve the SpeedWorkers configuration of a project. The version can be: - 'production' (default): the version currently live - 'draft': the version being edited, not yet pushed to production - a version number (e.g. 42) as shown in SpeedWorkers versioning (the speedworkers_versions agent lists the available ones) Returns website-level info (beam domain, delivery stop, interceptor checks) and the configuration of the requested version: settings (hosts, max speeds, cache refresh, refresh intervals...), versioning metadata (comment, release date, last editor), sections (cache behaviors and inventory optimization rules, with their refresh rules and markdown rules), JS snippets (code per rendering or delivery step, active or not, with sections_stable_ids for the sections they are declared on, or applied to the whole site), rendering configs, inventory sources, Live Update feeds and quality controls.

Playground

POST
item
version

SpeedWorkers version to get the configuration of: 'production' (default), 'draft', or a version number as shown in SpeedWorkers versioning (e.g. 42)

Credits

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
version string | integer

SpeedWorkers version to get the configuration of: 'production' (default), 'draft', or a version number as shown in SpeedWorkers versioning (e.g. 42)

Default: "production"

Example
{
  "version": "production"
}

Response

object
Properties
website object required

Website-level SpeedWorkers info (beam domain, delivery stop, interceptor checks)

version object required

Configuration of the requested version (settings, sections/cache behaviors, JS snippets with their code per step and sections_stable_ids (or applied to the whole site), rendering configs, inventory sources, Live Update feeds, quality controls)

Example
{
  "website": {},
  "version": {}
}

Endpoints

POST http://agents.botify.com/{organization}/{project}/speedworkers_config/process
POST http://agents.botify.com/{organization}/{project}/speedworkers_config/batch_process
POST http://agents.botify.com/{organization}/{project}/speedworkers_config/async_process
POST http://agents.botify.com/{organization}/{project}/speedworkers_config/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/speedworkers_config/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool speedworkers_config. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata