Org Chart Studio

AI agents for Org Chart Studio

Org Chart Studio speaks MCP. Give your agent Excel, CSV, or structured people data and get back an org chart. This page is the agent entry point; the real contract lives in /llms-full.txt.

Quick start

  1. Read /llms.txt for the short path.
  2. Connect to /mcp with MCP Streamable HTTP.
  3. Call tools/list before guessing a schema.
  4. Use review_org_chart_xlsx for Excel (.xlsx) workbooks.
  5. Use review_org_chart_csv for messy CSV input.
  6. Use render_org_chart_png when the user wants an image.
  7. Use list_chart_styles, preview_chart_style, and set_chart_style to browse, preview (watermarked), and apply chart styles.
  8. Use export_chart_png, export_chart_pdf, or export_chart_pptx with x402 payment signatures for clean, watermark-free exports.

Endpoints

Agent hub                https://www.orgchartstudio.com/agents
Short guide              https://www.orgchartstudio.com/llms.txt
Full guide               https://www.orgchartstudio.com/llms-full.txt
MCP endpoint             https://www.orgchartstudio.com/mcp
OpenAPI                  https://www.orgchartstudio.com/openapi.json
MCP server card          https://www.orgchartstudio.com/.well-known/mcp/server-card.json
MCP server descriptor    https://www.orgchartstudio.com/.well-known/mcp/server.json
API catalog (RFC 9727)   https://www.orgchartstudio.com/.well-known/api-catalog
Agent Skills index       https://www.orgchartstudio.com/.well-known/agent-skills/index.json

Discovery links

Tools

Public PNG rendering

Call render_org_chart_png with Excel, CSV, or structured people data. The result is an inline image/png from the actual Org Chart Studio renderer. Always watermarked with orgchartstudio.com by default.

Spreadsheet import review

Call review_org_chart_xlsx (base64 .xlsx) or review_org_chart_csv (CSV text) when the spreadsheet is messy. Report Needs manager and Not imported rows from importReport, not a guess.

Saved-chart tools (OAuth)

Authenticated (OAuth) tools operate on a signed-in user's saved charts: create (create_chart, create_chart_from_csv, create_chart_from_people), edit (add_person, update_person, set_manager, set_chart_style, set_density, set_orientation, set_leaf_mode, set_show_avatar), organize (list_charts, get_chart, rename_chart, duplicate_chart, delete_chart, delete_person), and export (export_chart_png, export_chart_pdf, export_chart_pptx, export_chart_csv). Call tools/list for the authoritative set. Public rendering does not require OAuth.

Chart styles — browse, preview, apply

Call list_chart_styles for the built-in recipes (professional, boardroom, soft), or author your own. preview_chart_style returns ONE watermarked preview of a chart in a recipe or a custom style; set_chart_style applies the chosen style to a saved chart. A custom style mirrors the visual Theme Editor's controls exactly and is strictly enforced — you cannot request a look the Theme Editor does not offer.

Programmatic Clean Export (x402)

Agents export watermark-free PNG, PDF, or PPTX files by paying via the x402 Programmatic Payment Protocol (USDC on Base, eip155:8453). This requires OAuth — a pass attaches to your account (reachable by web login or agent OAuth), so an unauthenticated request is refused (401), not handed a challenge. Call an export tool without a covering pass to get an x402 V2 challenge; the payTo is a one-time Stripe deposit address (USDC settles to fiat in our Stripe balance), so read it fresh each time and never reuse it. Settlement is fully asynchronous: send exactly accepts[0].amount in USDC to that payTo on Base (a normal on-chain transfer — no proof to sign, no paymentSignature). Stripe captures the deposit and grants the matching sized pass automatically; poll get_subscription_status until the pass is active, then re-call the export tool. Pricing is by chart SIZE × pass DURATION (passDuration: 1day/7day/30day/annual) — from $1 (≤250 people, 1-day) up to $1,250 (≤2,500, annual); read accepts[0].amount, never assume $1. The full loop is the clean-export-via-x402 skill.

Rules

  • Public MCP PNGs are always watermarked with orgchartstudio.com by default.
  • Do not ask MCP for human billing or checkout; programmatic clean exports use USDC on Base via the x402 protocol.
  • Clean watermark-free exports need an active pass: call export_chart_png/pdf/pptx without one to get an x402 challenge, send USDC to its payTo on Base, then poll get_subscription_status and re-call the export once the pass is active.
  • Every chart-style preview (preview_chart_style) is watermarked and single-image; a watermark-free export still requires a pass.
  • Excel and CSV results may include Needs manager and Not imported rows.
  • Do not claim every row rendered when importReport says otherwise.

Limits (public, unauthenticated)

  • 250 people maximum per chart.
  • 256 KB CSV body.
  • 256 KB Excel (.xlsx) decoded payload.
  • 10 renders per 10 minutes per IP.

Authenticated saved charts scale to the account's size tier (free baseline 250, paid up to 2,500); call get_subscription_status for the effective maxNodes.