# Yoyo Loading State Builder — REST API endpoint `yoyo-loading-state-builder`

Build Yoyo PHP "yoyo:spinning" loading-state attributes and a ready-to-paste HTML snippet. Choose show/hide, add class, remove class, set attribute, or a combination, with optional delay and target actions.

- Category: text
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/yoyo-loading-state-builder/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/yoyo-loading-state-builder/
- Same tool on the other surface: https://findutils.com/mcp/yoyo-loading-state-builder/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/yoyo-loading-state-builder/execute \
  -H "Content-Type: application/json" \
  -d '{
    "behavior": "add-class",
    "class_name": "opacity-50",
    "use_delay": true,
    "delay_ms": 200
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/yoyo-loading-state-builder
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `behavior` | string (show-hide \| add-class \| remove-class \| set-attr \| combination) | no | Loading behavior. Default: "show-hide". Default: `"show-hide"`. |
| `class_name` | string | no | CSS class for "add-class" or "remove-class" (e.g. "opacity-50"). |
| `attribute` | string | no | Attribute for "set-attr" (e.g. "disabled"). |
| `use_delay` | boolean | no | Add yoyo:spinning.delay. Default: false. Default: `false`. |
| `delay_ms` | integer | no | Delay in milliseconds when use_delay is true. Default: 300. Default: `300`. |
| `target_actions` | string | no | Comma-separated action names for yoyo:spin-on (e.g. "save,submit"). |
| `add_class_name` | string | no | For "combination": class to add. |
| `remove_class_name` | string | no | For "combination": class to remove. |
| `add_attribute` | string | no | For "combination": attribute to set. |

Example arguments (verified):

```json
{
  "behavior": "add-class",
  "class_name": "opacity-50",
  "use_delay": true,
  "delay_ms": 200
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:yoyo_loading_state_builder`. Full MCP reference: https://findutils.com/mcp/yoyo-loading-state-builder/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt