Skip to main content
Glama

Create timeline

create_timeline

Creates an interactive timeline in the user's Time.Graphics account from a title, events, and periods in one call. Dates are ISO strings; years before Christ are negative: "-0044-03-15" is March 15, 44 BC. Text color is set by Time.Graphics. New timelines are public by default: anyone on the internet can see them. Returns links to view, edit, and embed the timeline.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "title": "<title>",
      "events": "<events>"
    },
    "name": "create_timeline"
  }
}

Input Schema

NameRequiredDescriptionDefault
titleYes
accessNolink and private need Premiumpublic
eventsYes
periodsNo
descriptionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed19 schema fields changed
    • addedInput schema / properties / events / items / properties / color / description
      Added value: +"Color as \"#rrggbb\": the fill of shapes with text inside, and the line and text of the others. The default is #37a70b for events and #1898e0 for periods. Editor palette: #2c3d4d dark blue, #37a70b green, #96ec39 light green, #587934 olive, #1898e0 blue, #ffcca3 peach, #f56c00 orange. Text inside RECTANGLE, VERTICAL_RECT, CIRCLE_IN, RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT gets a contrasting color from Time.Graphics. On the other types, the text has this color and lies right on the background: on the light background (#FCFCFC), #2c3d4d, #587934, #1898e0, #f56c00, and #37a70b read well, while #ffcca3 and #96ec39 are unreadable and fit only shapes with text inside. Pure black and pure white hide the hover highlight."
    • changedInput schema / properties / events / items / properties / date / description
      Previous value: -"ISO date, negative year for BC, precision may be year only: \"-0509\", \"1957-10\", \"1969-07-20\""New value: +"Date of the event as an ISO string, as precise as is known. Years before Christ are negative. The month and the day can be omitted: \"-0509\", \"1957-10\", \"1969-07-20\"."
    • addedInput schema / properties / events / items / properties / description / description
      Added value: +"Text that opens in a separate window; it is not drawn on the timeline. Plain text: one or two sentences on why this matters, up to 300 characters, read best."
    • changedInput schema / properties / events / items / properties / over_line / description
      Previous value: -"true above the timeline line, false below it, default true"New value: +"Side of the line: true above it, false below it. The default is true for events and false for periods. The two sides stack independently. A plain list alternates sides; with two storylines, each keeps its own side (for example, politics above and culture below); background periods (FILL_AREA, BRACES) stay on one side."
    • changedInput schema / properties / events / items / properties / scale / description
      Previous value: -"size, 100 is normal, default 100"New value: +"Size of the object, a whole number from 10 to 1000; the default is 100, the normal size. It multiplies the font, the icon, and the padding. 120-150 fits 1-3 key events, 100 regular ones, and 70-85 small details in dense parts. Below 60 the text is unreadable; above 200 the object covers its neighbors. Objects of one category read best at one scale."
    • changedInput schema / properties / events / items / properties / text_position / description
      Previous value: -"text left or right of the icon, or CENTER above or below it (-1, 0, 1 in the style book), default CENTER"New value: +"Where the text stands relative to the icon; events only. CENTER, the default: above or below the icon. CENTER fits when events are sparse: more than one-fifteenth of the length of the whole timeline lies between neighboring dates. When neighboring events are closer, CENTER labels stack on top of each other in tiers and run off the edge of the canvas. LEFT on the earlier event and RIGHT on the later one move the labels apart, to opposite sides. In a run of close events, the labels fit in a single row with the order LEFT, LEFT, RIGHT, RIGHT."
    • addedInput schema / properties / events / items / properties / title / description
      Added value: +"The fact itself, 2 to 6 words, without the date: the axis shows the time. A name does not wrap on its own; \"\\n\" separates lines. A line of up to 3 words reads best, and 2 words read better still: a 6-word name is three lines of 2 words each. In dense parts, one line of up to 3 words reads best."
    • changedInput schema / properties / events / items / properties / type / description
      Previous value: -"icon type from the style book in timegraphics://guide, default RECTANGLE"New value: +"Icon type; the default is RECTANGLE. RECTANGLE: a rounded plate filled with the color, with the text inside; fits timelines of up to 15-20 events with room between neighboring dates. LINE: a thin stem from the line to the text, with no plate; the lightest look, fits a restrained style. CIRCLE: a dot on the line with the text beside it or above it; with LEFT or RIGHT its box is low. LINE and CIRCLE fit when there are more than 20 events or when events stand close together, so the labels do not pile up: LINE has the lowest and narrowest box, and CIRCLE with LEFT or RIGHT has a lower box than RECTANGLE. VERTICAL_RECT: a filled plate and a vertical line across the whole canvas height; very loud. VERTICAL_DOT: a dot and a vertical line across the whole canvas height; loud. VERTICAL_RECT and VERTICAL_DOT are for 1-3 turning points on the whole timeline. CIRCLE_IN: the text inside a filled circle that grows with the text; fits names of one to three words."
    • changedInput schema / properties / events / items / properties / url / description
      Previous value: -"source or reading link shown with the event"New value: +"Link to a reliable source or further reading, http or https, shown with the event or period; fits when sources are requested."
    • changedInput schema / properties / events / maxItems
      Previous value: -300New value: +100
    • addedInput schema / properties / periods / items / properties / color / description
      Added value: +"Color as \"#rrggbb\": the fill of shapes with text inside, and the line and text of the others. The default is #37a70b for events and #1898e0 for periods. Editor palette: #2c3d4d dark blue, #37a70b green, #96ec39 light green, #587934 olive, #1898e0 blue, #ffcca3 peach, #f56c00 orange. Text inside RECTANGLE, VERTICAL_RECT, CIRCLE_IN, RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT gets a contrasting color from Time.Graphics. On the other types, the text has this color and lies right on the background: on the light background (#FCFCFC), #2c3d4d, #587934, #1898e0, #f56c00, and #37a70b read well, while #ffcca3 and #96ec39 are unreadable and fit only shapes with text inside. Pure black and pure white hide the hover highlight."
    • addedInput schema / properties / periods / items / properties / date_from / description
      Added value: +"Start of the period as an ISO string, as precise as is known. Years before Christ are negative. The month and the day can be omitted: \"-0509\", \"1957-10\", \"1969-07-20\"."
    • addedInput schema / properties / periods / items / properties / date_to / description
      Added value: +"End of the period, in the same format as date_from."
    • addedInput schema / properties / periods / items / properties / description / description
      Added value: +"Text that opens in a separate window; it is not drawn on the timeline. Plain text: one or two sentences on why this matters, up to 300 characters, read best."
    • changedInput schema / properties / periods / items / properties / over_line / description
      Previous value: -"true above the timeline line, false below it, default false"New value: +"Side of the line: true above it, false below it. The default is true for events and false for periods. The two sides stack independently. A plain list alternates sides; with two storylines, each keeps its own side (for example, politics above and culture below); background periods (FILL_AREA, BRACES) stay on one side."
    • changedInput schema / properties / periods / items / properties / scale / description
      Previous value: -"size, 100 is normal, default 100"New value: +"Size of the object, a whole number from 10 to 1000; the default is 100, the normal size. It multiplies the font, the icon, and the padding. 120-150 fits 1-3 key events, 100 regular ones, and 70-85 small details in dense parts. Below 60 the text is unreadable; above 200 the object covers its neighbors. Objects of one category read best at one scale."
    • addedInput schema / properties / periods / items / properties / title / description
      Added value: +"The fact itself, 2 to 6 words, without the date: the axis shows the time. A name does not wrap on its own; \"\\n\" separates lines. A line of up to 3 words reads best, and 2 words read better still: a 6-word name is three lines of 2 words each. In dense parts, one line of up to 3 words reads best."
    • changedInput schema / properties / periods / items / properties / type / description
      Previous value: -"period type from the style book in timegraphics://guide, default RECT_TOP"New value: +"Period type; the default is RECT_TOP. RECT_TOP: a thin bar with the text under or above it; the name stays whole at any width. RECT_APPROX_TOP: RECT_TOP with fading edges on both sides. THIN: a 2-pixel line with the text under or above it; the most modest look, fits many overlapping periods. BRACES: a curly brace along the whole period with a light fill down to the line; fits eras and chapters that contain other objects. FILL_AREA: a thin line and a background band across the whole canvas height, drawn under everything else; fits the longest eras as a backdrop, at most three overlapping. RECT: a solid bar with the text inside, cut at the bar width. RECT_APPROX: RECT with fading edges on both sides (\"roughly from ... to ...\"). RECT_APPROX_LEFT: RECT with a fading left edge (the start is unknown). RECT_APPROX_RIGHT: RECT with a fading right edge (the end is unknown or it is still going on). By length: the longest eras fit FILL_AREA or BRACES; medium spans fit RECT_TOP or RECT_APPROX_TOP; short spans fit RECT_TOP or THIN; RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT fit only periods that are long relative to the whole timeline and have short names."
    • addedInput schema / properties / periods / items / properties / url / description
      Added value: +"Link to a reliable source or further reading, http or https, shown with the event or period; fits when sources are requested."
  2. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare the write and open-world nature. The description adds valuable behavior beyond them: new timelines are public by default, text color is controlled by Time.Graphics, and the response includes view, edit, and embed links. Authentication requirements are only implied by 'user's account'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded and free of filler. Each sentence conveys useful information, though it reads as a flat list of facts rather than a tightly structured document. The date example and public-default warning are especially valuable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex creation tool with many nested styling options and no output schema, the description covers the essential behavior: what is created, the privacy default, date syntax, and return links. It omits authentication details and failure modes, but the nested schema carries most parameter-level guidance.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Top-level schema description coverage is only 20%, so the description must compensate. It clarifies date formatting and the default visibility for access, but does not explain the title, events array, periods array, or the optional description parameter at the top level. Nested properties are already richly documented in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Creates an interactive timeline in the user's Time.Graphics account from a title, events, and periods in one call.' This clearly distinguishes it from an event-adding tool like add_events, though no sibling is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'in one call' implies this is for bulk creation from scratch, and the public-default note gives context. However, there is no explicit when-to-use guidance versus alternatives such as add_events or copy_timeline, and no exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources