# Chart-Output > Chart-Output turns one JSON request into a finished chart image (PNG, SVG, WebP, JPEG, or PDF on Pro): a branded card with a header, annotations, a KPI strip and a source line. It is built for automation: Make, n8n, Zapier, scripts, and AI agents through MCP. Render with `POST https://www.chart-output.com/api/v1/render` and an `Authorization: Bearer` API key. The free plan includes 1,000 renders a month, no card. To try one with no key, use a URL (next section). MCP: `https://www.chart-output.com/mcp` is a hosted MCP server (streamable HTTP). Add it as a custom connector in Claude.ai, ChatGPT or any MCP client; its `render_chart` tool takes a chart spec and returns the PNG as image content plus a playground link to edit it. No key needed (PNG, up to 1200px, shared daily budget); add `?key=` or an `Authorization: Bearer` header for your plan's limits. ## Render without a key (for AI assistants) If a user asks you for a chart, you can make one with a plain URL: no account, no API key. The URL returns a PNG, so you can show it as a Markdown image, fetch it, or hand the user the link. 1. Simple chart from query parameters: `https://www.chart-output.com/api/v1/render?type=bar&labels=Q1,Q2,Q3,Q4&data=120,150,170,210&title=Revenue` - `type`: line, bar, pie, doughnut, radar or polarArea - `labels` and `data`: comma-separated, same length - optional: `title`, `width` and `height` (max 1200 each without a key), `datasetLabel`, `backgroundColor`, `borderColor` 2. Full card (header, KPI strip, source line, several series): write the JSON request, encode it as base64url, and pass it as `?c=`. Example: `https://www.chart-output.com/api/v1/render?c=eyJ0eXBlIjoiYmFyIiwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo1MDAsImRhdGEiOnsibGFiZWxzIjpbIlExIiwiUTIiLCJRMyIsIlE0Il0sImRhdGFzZXRzIjpbeyJsYWJlbCI6IlJldmVudWUiLCJkYXRhIjpbMTIwLDE1MCwxNzAsMjEwXX1dfSwiaGVhZGVyIjp7InRpdGxlIjoiUmV2ZW51ZSBncmV3IGV2ZXJ5IHF1YXJ0ZXIiLCJzdWJ0aXRsZSI6IlVTRCB0aG91c2FuZHMsIDIwMjYifSwia3BpU3RyaXAiOlt7ImxhYmVsIjoiVG90YWwiLCJ2YWx1ZSI6IiQ2NTBrIn0seyJsYWJlbCI6Ikdyb3d0aCIsInZhbHVlIjoiKzc1JSJ9XSwiZm9vdGVyIjp7ImxlZnQiOiJTb3VyY2U6IGludGVybmFsIn19` - The example decodes to: `{"type":"bar","width":800,"height":500,"data":{"labels":["Q1","Q2","Q3","Q4"],"datasets":[{"label":"Revenue","data":[120,150,170,210]}]},"header":{"title":"Revenue grew every quarter","subtitle":"USD thousands, 2026"},"kpiStrip":[{"label":"Total","value":"$650k"},{"label":"Growth","value":"+75%"}],"footer":{"left":"Source: internal"}}` - Every gallery chart's request at `https://www.chart-output.com/gallery/{slug}/spec.json` is a good starting point; trim it if the encoded URL runs past the limit below. 3. Give the user an editable version: `https://www.chart-output.com/playground?c=` opens that exact chart in the playground, where they can change it and download it. Limits without a key: PNG only, at most 1200px per side, a URL of at most 2000 characters, and a few renders per IP every 15 minutes (HTTP 429 with `Retry-After` when exceeded). For more, the user signs up for a free API key and you add `&key=` or use the `POST` endpoint above. ## Gallery 15 finished charts. Open one for its exact request, or read the machine-readable files below. - [Gallery index (JSON)](https://www.chart-output.com/gallery.json): every chart with its job, type, when to use it, the data it needs, and links to its request - [A chart's request (JSON)](https://www.chart-output.com/gallery/{slug}/spec.json): the exact request for one chart, for example https://www.chart-output.com/gallery/mrr-growth/spec.json - [A chart's page (Markdown)](https://www.chart-output.com/gallery/{slug}/index.md): when to use it, the data it takes, its request and common questions, for example https://www.chart-output.com/gallery/mrr-growth/index.md - [Gallery page](https://www.chart-output.com/gallery): the same charts as images, grouped by job ### Revenue What you earn, where it comes from, and what moved it. - [Recurring revenue](https://www.chart-output.com/gallery/mrr-growth): Line. Use it to show recurring revenue over a year, with the launch or event that moved it marked on the line. - [Revenue by plan](https://www.chart-output.com/gallery/revenue-by-plan): Doughnut. Use it to show how a total splits across a handful of plans or segments, with each share on the chart. - [Revenue bridge](https://www.chart-output.com/gallery/revenue-bridge): Waterfall. Use it when someone asks "why did the number change?" and you want the drivers as steps from the start to the end. ### Growth People arriving, trying the product and converting. - [Signups by channel](https://www.chart-output.com/gallery/signups-by-channel): Stacked bar. Use it when the total matters but so does where it came from: weekly signups split by channel. - [Trial-to-paid funnel](https://www.chart-output.com/gallery/trial-funnel): Horizontal bar. Use it to show where people drop off between steps, with the count printed on each bar. - [Trials and conversion rate](https://www.chart-output.com/gallery/trials-and-conversion): Bar and line. Use it when a count and a rate move together and putting them on one axis would flatten one of them. ### Customers Who stays, who leaves, and how they feel about it. - [Churn vs target](https://www.chart-output.com/gallery/churn-vs-target): Bar. Use it to show whether a monthly rate is on target: months over target take a second colour. - [Active users, year on year](https://www.chart-output.com/gallery/active-users-yoy): Line, two series. Use it for any year-on-year comparison where the gap between the two lines is what people should see. - [Customer satisfaction](https://www.chart-output.com/gallery/csat-breakdown): 100% stacked bar. Use it to show how a mix shifts over time when the share matters more than the count. ### Sales The pipeline, the team and the win rate. - [Pipeline by stage](https://www.chart-output.com/gallery/pipeline-by-stage): Bar. Use it for a weekly sales call: open value at each stage, printed on every bar. - [Quota attainment by rep](https://www.chart-output.com/gallery/quota-by-rep): Ranked horizontal bar. Use it for a team scoreboard: who is above plan, who is below, and by how much. - [Win rate with a rolling average](https://www.chart-output.com/gallery/win-rate-trend): Line with moving average. Use it when the week-to-week numbers are noisy and the trend is what you want people to see. ### Efficiency and goals What customers cost, how support is coping, and how far to goal. - [LTV vs CAC by channel](https://www.chart-output.com/gallery/ltv-vs-cac): Grouped horizontal bar. Use it to compare what a customer is worth with what it costs to win them, channel by channel. - [Quarter to goal](https://www.chart-output.com/gallery/quarter-to-goal): Gauge. Use it for a single "how far to goal" number in a weekly digest, a Slack post or a report cover. - [Support tickets by priority](https://www.chart-output.com/gallery/tickets-by-priority): Stacked area. Use it to show a total and its parts over time when the shape of the total matters. ## Docs - [Quick start](https://www.chart-output.com/docs/quick-start): the first render in a few minutes - [API reference](https://www.chart-output.com/docs/api-reference): every endpoint, request field and response - [Chart specs](https://www.chart-output.com/docs/chart-specs): the request format - [Card composition](https://www.chart-output.com/docs/card-composition): header, KPI strip, annotations and footer - [Brand kits](https://www.chart-output.com/docs/brand-kits): your logo, colours and font applied to every chart - [Output formats](https://www.chart-output.com/docs/output-formats): PNG, SVG, WebP, JPEG and PDF - [MCP server](https://www.chart-output.com/docs/mcp): the hosted server for Claude.ai and ChatGPT, and the local npm package for editors - [Errors](https://www.chart-output.com/docs/errors): status codes, including plan limits ## Guides Step-by-step guides and comparisons from the blog, newest first. - [Google Chart API Is Gone: What to Use Instead of chart.googleapis.com](https://www.chart-output.com/blog/google-chart-api-replacement): Google Image Charts was turned off in 2019 and chart.googleapis.com URLs now return 404. Your options for keeping old URLs, making QR codes, or rewriting charts as Chart.js image URLs, with a parameter translation table. - [Branded charts that match your website, as a shareable link](https://www.chart-output.com/blog/branded-chart-links-from-your-website-with-claude-mcp): Draft a brand kit from your website with one prompt, then have your AI render on-brand charts and return links you can paste into Slack, email or docs. - [Turn a CSV into a chart inside Claude, Cursor or Windsurf (MCP setup)](https://www.chart-output.com/blog/csv-to-chart-with-claude-mcp): Add the Chart-Output MCP server once, paste a CSV into your AI chat, and get a real chart image back. Setup, three prompts to try, and the errors you may hit. - [What changed this month? Ask your AI for a waterfall chart](https://www.chart-output.com/blog/explain-revenue-change-waterfall-chart-claude): Give your AI a before and after for each line item. The Chart-Output MCP server returns a waterfall chart and a plain summary of the biggest movers. - [How to Add a Chart to an n8n Workflow (Google Sheets to Slack)](https://www.chart-output.com/blog/add-chart-to-n8n-workflow): Turn rows from Google Sheets, a database, or any n8n node into a chart image and post it to Slack or email. One Code node and one HTTP Request node. - [How to Add a Chart to a Zapier Zap or Make Scenario](https://www.chart-output.com/blog/add-chart-to-zapier-or-make): Zapier and Make move data between apps but neither draws a chart. Here is how to turn a spreadsheet row into a chart image URL and send it to Slack or email. - [Convert Chart.js to Image: PNG, SVG, WebP, and PDF](https://www.chart-output.com/blog/convert-chartjs-to-image): How to export a Chart.js config into a static PNG, SVG, WebP, or PDF image — for email, reports, Slack, and any pipeline running outside the browser. - [chartjs-node-canvas vs Puppeteer: Which Should You Use to Render Chart.js Server-Side?](https://www.chart-output.com/blog/chartjs-node-canvas-vs-puppeteer): An honest comparison of the two most common DIY approaches to server-side Chart.js rendering — native canvas polyfills vs headless browser screenshotting — and when neither is worth building yourself. - [Chart.js in Email: Generate a Static Image](https://www.chart-output.com/blog/chartjs-in-email): Email clients can't run JavaScript, so interactive Chart.js charts don't work in email. Here's how to render Chart.js configs as static PNG images that display reliably across Gmail, Outlook, and Apple Mail. - [How to Generate Chart.js PDF Reports Programmatically](https://www.chart-output.com/blog/chartjs-pdf-reports): A guide to building automated PDF reports with Chart.js visuals — without launching a headless browser to print a webpage. - [Generate Charts for Slack, Discord, and Teams Bots](https://www.chart-output.com/blog/charts-for-slack-discord-teams): A guide to building bot integrations that post real Chart.js-rendered images — daily metrics, alerts, and reports — into Slack, Discord, or Microsoft Teams. - [QuickChart Alternatives (2026): Hosted, Self-Hosted and DIY Options Compared](https://www.chart-output.com/blog/quickchart-alternatives): Five ways to render Chart.js to an image on a server, checked against each vendor's own pricing and docs on November 16, 2026. Real prices, a migration checklist, and when QuickChart is still the right call. - [QuickChart vs Chart-Output: Which Chart API Is Right for Your Pipeline?](https://www.chart-output.com/blog/quickchart-vs-chart-output): A direct comparison of QuickChart and Chart-Output, checked against QuickChart's own pricing and docs in November 2026: formats, Chart.js coverage, brand kits, async rendering, and price per render. - [Image-Charts vs Chart-Output: An Honest Comparison for Production Pipelines](https://www.chart-output.com/blog/image-charts-vs-chart-output): Image-Charts and Chart-Output compared side by side, checked against Image-Charts' own pricing and docs in November 2026: input format, output formats, brand kits, async pipelines, and price. ## Optional - [Pricing](https://www.chart-output.com/pricing): Free, Pro and Agency plans - [FAQ](https://www.chart-output.com/faq) - [Playground](https://www.chart-output.com/playground): render a chart with no account