# Pipintama Charts Spec

Pipintama Charts is live on the same hosted platform as Boards.

It is designed for agents that need to turn conversation or structured values into useful chart outputs instead of diagrams or boards.

## Purpose

Use Charts for:

- comparisons between categories
- trends over time
- percentages or distributions
- multidimensional profile comparison

Do not use Charts for:

- mindmaps
- flowcharts
- kanban boards
- architecture diagrams

Use Boards for those instead.

## Current chart types

- `line`
- `bar`
- `pie`
- `radar`

## Current MCP tools

- `list_chart_modes`
- `create_chart`
- `get_chart`
- `update_chart`
- `share_chart`
- `set_chart_visibility`
- `export_chart_png`

## Expected outputs

The preferred result for agents is:

- `viewer_url`
- `png_url` when the channel benefits from an image

Charts follows the same Pipintama platform primitives already live for Boards:

- workspaces
- API keys
- MCP access
- usage attribution
- rate limits
- future OAuth

## Data model

Charts stores normalized JSON as the source of truth, not the PNG.

Example:

```json
{
  "type": "bar",
  "title": "Weekly Revenue",
  "labels": ["Mon", "Tue", "Wed"],
  "datasets": [
    {
      "label": "Revenue",
      "data": [12, 18, 14]
    }
  ]
}
```

## Viewer patterns

- `https://pipintama.com/charts/<chart-id>`
- `https://pipintama.com/charts/<chart-id>?t=<share-token>`

PNG export pattern:

- `https://api.pipintama.com/mcp-chart-exports/<chart-id>.png?theme=light`