# Org Chart Studio

Org Chart Studio helps people and AI agents create, edit, and export organizational charts.

Human-readable agent hub: https://www.orgchartstudio.com/agents
Use this file as the short machine-readable path. Use https://www.orgchartstudio.com/llms-full.txt for the full MCP contract, OAuth notes, examples, and edge cases.

## Agent quick start

If a user asks you to create or test an org chart image with Org Chart Studio, use the MCP endpoint directly:

1. Connect to `https://www.orgchartstudio.com/mcp` using MCP Streamable HTTP.
2. Call `tools/list`.
3. For messy CSVs, invoke `review_org_chart_csv` first to see row-level import issues.
4. Invoke the public tool `render_org_chart_png`.
5. Pass CSV text or structured people data.
6. Return the inline `image/png` result to the user and report any `importReport` issues.

Minimal CSV example:

```csv
Name,Title,Manager
Morgan Lee,CEO,
Priya Shah,VP Product,Morgan Lee
Alex Kim,Engineering Manager,Morgan Lee
Jamie Chen,Product Designer,Priya Shah
Riley Patel,Staff Engineer,Alex Kim
```

Use `render_org_chart_png` for this CSV. The returned PNG will be watermarked.

Correct `tools/call` arguments for CSV input:

```json
{
  "source": {
    "kind": "csv",
    "csvText": "Name,Title,Manager\nMorgan Lee,CEO,\nPriya Shah,VP Product,Morgan Lee\nAlex Kim,Engineering Manager,Morgan Lee"
  },
  "density": "standard",
  "orientation": "landscape",
  "showAvatar": true,
  "leafMode": "auto"
}
```

The render input is always nested under `source`. Do not call `render_org_chart_png` with top-level `csv`, `csvText`, or `people` fields.

For CSVs, tool results may include `structuredContent.importReport`. Treat it as the source of truth for the conversation: report `Needs manager` rows, `Not imported` rows, and suggested manager candidates. Do not claim every row was rendered or imported when `importReport` says otherwise.

## What not to do

- Do not invent another MCP server, localhost URL, vendor, workspace bridge, or product name.
- Do not generate Mermaid, HTML, SVG, Graphviz, or a generic chart instead of calling Org Chart Studio when MCP tools are available.
- Do not tell the user Org Chart Studio cannot return an image through MCP. The public `render_org_chart_png` tool returns `image/png`.
- Do not guess the render tool schema. Use `arguments.source.kind = "csv"` with `arguments.source.csvText`, or `arguments.source.kind = "people"` with `arguments.source.people`.
- Do not request checkout, billing, clean export, watermark removal, or watermark override fields through MCP.
- Do not claim the MCP output is watermark-free. It is always watermarked with `orgchartstudio.com`.
- If your environment cannot call MCP or fetch the endpoint, say so clearly and provide import-ready CSV as a fallback. Do not pretend you used Org Chart Studio.

## Agent entry points

- Agent hub: https://www.orgchartstudio.com/agents
- MCP endpoint: https://www.orgchartstudio.com/mcp
- OpenAPI: https://www.orgchartstudio.com/openapi.json
- API catalog: https://www.orgchartstudio.com/.well-known/api-catalog
- MCP server card: https://www.orgchartstudio.com/.well-known/mcp/server-card.json
- MCP Registry metadata: https://www.orgchartstudio.com/.well-known/mcp/server.json
- Agent Skills index: https://www.orgchartstudio.com/.well-known/agent-skills/index.json
- Full agent documentation: https://www.orgchartstudio.com/llms-full.txt

## Public no-auth MCP tools

- `render_org_chart_png`: create an inline watermarked PNG from CSV text or structured people data.
- `review_org_chart_csv`: inspect CSV text and return row accounting, Needs manager rows, suggested manager candidates, and Not imported rows without rendering or saving.
- `list_templates`: list built-in industry template slugs, titles, categories, and URLs.
- `get_template`: return template details, markdown URL, Studio URL, and a suggested starting prompt.

Public rendering is bounded to 250 people, 256KB CSV input, and 10 anonymous renders per 10 minutes per IP.
Agents can set layout controls that match the app: `density`, `orientation`, `showAvatar`, and `leafMode`.

## OAuth MCP tools

Saved-chart tools are listed publicly but require OAuth scopes when invoked:

- `charts:read`: list/get saved charts, export saved chart CSV, export saved chart watermarked PNG.
- `charts:write`: create, rename, duplicate, delete, edit people, reparent people, and update layout controls.

## Watermark invariant

Every PNG returned through MCP includes the `orgchartstudio.com` watermark. MCP does not expose clean export, watermark-free export, checkout, billing, or no-watermark options.

## Support and privacy

- Website: https://www.orgchartstudio.com
- Templates: https://www.orgchartstudio.com/org-chart-templates
- Privacy: https://www.orgchartstudio.com/privacy
- Support: mailto:hello@orgchartstudio.com