# Yaml Toml Converter — REST API endpoint `yaml-toml-converter`

Convert YAML to TOML 1.0 or TOML back to YAML. Mappings become tables, lists of mappings become arrays of tables, and scalar lists stay inline arrays. The YAML root must be a mapping because TOML has no top-level list. TOML has no null either: nulls is "drop" (default, the key is left out and reported) or "empty" (an empty string). Anchors, aliases and `<<` merge keys are resolved on load and written out in full. Comments are not preserved in either direction. Parse errors report the line and column.

- Category: data
- 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/yaml-toml-converter/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/yaml-toml-converter/
- Same tool on the other surface: https://findutils.com/mcp/yaml-toml-converter/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/yaml-toml-converter/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "title: demo\ndatabase:\n  host: localhost"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/yaml-toml-converter
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `input` | string | yes | The YAML document or the TOML document to convert. |
| `mode` | string (yaml-to-toml \| toml-to-yaml) | no | Conversion direction. Default: yaml-to-toml. Default: `"yaml-to-toml"`. |
| `nulls` | string (drop \| empty) | no | yaml-to-toml: what to do with a null value. "drop" leaves the key out; "empty" writes "". Default: drop. Default: `"drop"`. |
| `indent` | integer | no | toml-to-yaml: YAML indentation width (1-8). Default: 2. Default: `2`. |
| `sort_keys` | boolean | no | Sort keys alphabetically at every level. Default: false (input order). Default: `false`. |

Example arguments (verified):

```json
{
  "input": "title: demo\ndatabase:\n  host: localhost"
}
```

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:yaml_toml_converter`. Full MCP reference: https://findutils.com/mcp/yaml-toml-converter/

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