# Pipintama Charts Skill

Use Pipintama Charts when an agent should turn text or structured values into a chart instead of only prose.

## Use this skill for

- line charts
- bar charts
- pie charts
- radar charts
- text to chart
- AI data visualization
- quantitative comparisons

## Do not use this skill for

- mindmaps
- flowcharts
- kanban boards
- architecture diagrams

Use Pipintama Boards for those instead.

## MCP endpoint

- `https://api.pipintama.com/mcp`

## Main tools

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

## Agent workflow

1. Understand the request.
2. Choose the simplest correct chart type.
3. Build a concise title.
4. Preserve the user intent in `source_text`.
5. Default visibility to `shared` unless the user says otherwise.
6. Let the authenticated API key determine the workspace.
7. Return the hosted viewer URL first.
8. If the channel benefits from images, also return the PNG URL.

## Valid outputs

- viewer: `https://pipintama.com/charts/<chart-id>`
- shared viewer: `https://pipintama.com/charts/<chart-id>?t=<share-token>`
- PNG: `https://api.pipintama.com/mcp-chart-exports/<chart-id>.png?theme=light`