# Json To Timeline — REST API endpoint `json-to-timeline`

Generate the HTML for a timeline (div.timeline with .timeline-event/.event-marker/.event-content classes) from JSON of the form {"title","orientation","events":[{"date","title","description","color"}]}. Returns the HTML, the orientation, and a summary of each event.

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

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/json-to-timeline/execute \
  -H "Content-Type: application/json" \
  -d '{
    "json": "{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/json-to-timeline
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `json` | string | yes | Timeline JSON: {"title"?: string, "orientation"?: "vertical"\|"horizontal", "events": [{"date": string, "title": string, "description"?, "color"?: "#hex"}]}. |
| `orientation` | string (vertical \| horizontal) | no | Override the orientation from the JSON. Default: the JSON "orientation", else "vertical". |

Example arguments (verified):

```json
{
  "json": "{\"title\":\"History\",\"events\":[{\"date\":\"2020\",\"title\":\"Founded\",\"color\":\"#10b981\"},{\"date\":\"2021\",\"title\":\"Launch\"}]}"
}
```

Decoded `json` argument (readability only — send it as a string):

```json
{
  "title": "History",
  "events": [
    {
      "date": "2020",
      "title": "Founded",
      "color": "#10b981"
    },
    {
      "date": "2021",
      "title": "Launch"
    }
  ]
}
```

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:json_to_timeline`. Full MCP reference: https://findutils.com/mcp/json-to-timeline/

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