# ImageCharts MCP MCP

> ImageCharts generates data visualizations as embeddable images instantly. Use this MCP to create bar charts, line graphs showing trends, pie charts for market share percentages, or even scannable QR codes from raw text. It builds complex graphics on the fly directly from conversation parameters.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** data-visualization, chart-generation, qr-codes, api-driven-graphics, embeddable-charts

## Description

Need a quick visual breakdown of your data? This connector lets you generate professional-grade charts—from basic bar graphs to complex radar comparisons—all through natural chat prompts. You just describe the data, and it outputs ready-to-embed images. Developers can use this to drop visualizations right into an application or email without writing chart rendering code. Marketing teams get instant visuals for social campaigns. When you connect ImageCharts via Vinkius, your agent handles all the complex parameters—colors, labels, axis types, and data series—so you don't have to worry about the API specifics. It’s like having a graphic designer available in your chat window.

## Tools

### generate_bar_chart
Produces an image visualizing data using vertical or horizontal bars.

### generate_bubble_chart
Creates a visualization where points are sized to represent a third dimension of data.

### generate_doughnut_chart
Generates an image showing proportional parts within a ring structure.

### generate_line_chart
Builds a graph to show data trends over continuous periods or time series.

### generate_pie_chart
Creates an image illustrating the percentage distribution of categories from a single total.

### generate_polar_area_chart
Generates charts that map data across multiple axes in a circular format.

### generate_qr_code
Produces an scannable image containing text or a URL.

### generate_radar_chart
Creates a spider chart to compare multiple quantitative variables simultaneously.

### generate_scatter_plot
Makes a graph showing the relationship between two paired data points.

### generate_venn_diagram
Draws circles to illustrate shared elements and overlaps among defined sets of items.

## Prompt Examples

**Prompt:** 
```
Create a bar chart showing Q1-Q4 revenue and a pie chart of market share.
```

**Response:** 
```
Bar chart generated! Revenue Q1-Q4: Q1 ($120K), Q2 ($145K), Q3 ($190K), Q4 ($210K). Colors: blue gradient. Size: 600x400px. Image URL ready for embedding. Pie chart generated! Market share: Product A (42%, blue), Product B (28%, green), Product C (18%, orange), Others (12%, gray). Size: 500x500px. Both charts ready for download or embedding.
```

**Prompt:** 
```
Generate a QR code for our website and a line chart of monthly user growth.
```

**Response:** 
```
QR code generated! Content: https://company.com. Size: 300x300px. Error correction: Medium. Scannable and ready for print. Line chart generated! Monthly users (Jan-Jun): Jan (1.2K), Feb (1.5K), Mar (2.1K), Apr (2.8K), May (3.4K), Jun (4.1K). Growth trend: +242% over 6 months. Colors: teal with markers.
```

**Prompt:** 
```
Create a radar chart comparing 5 team skills and a bubble chart of project priorities.
```

**Response:** 
```
Radar chart generated! Team skills: Frontend (85%), Backend (92%), DevOps (70%), Design (65%), Testing (78%). Shape shows strong backend with design as growth area. Bubble chart generated! Projects: 'Alpha' (high impact, low effort, large team), 'Beta' (medium impact, high effort, small team), 'Gamma' (low impact, low effort, medium team). Bubble size = team size. Both charts ready.
```

## Capabilities

### Show distribution comparisons
Create scatter plots or bubble charts to map relationships between two variables using size encoding.

### Map multi-variable performance
Generate radar charts for comparing how different entities score against multiple metrics simultaneously.

### Track changes over time
Build line charts to visualize trends, showing growth or decline across specific periods.

### Visualize composition and parts
Produce pie or doughnut charts to show how a whole is divided among different segments.

### Create scannable identifiers
Generate QR codes from any text string or URL so you can print them anywhere.

## Use Cases

### Analyzing Project Status
The project manager needs to show how five different teams ranked on skill sets. They prompt the agent: 'Compare our team's skills using a radar chart.' The agent uses generate_radar_chart, providing an immediate visual comparison instead of dumping raw scores.

### Reporting Sales Performance
A sales rep needs to report Q1 vs. Q2 revenue and market share simultaneously. They ask the agent for a bar chart and a pie chart combination, using generate_bar_chart and generate_pie_chart in one prompt.

### Mapping User Behavior
A product developer wants to see if user engagement (X-axis) relates to time spent on site (Y-axis). They ask the agent to run a scatter plot, using generate_scatter_plot to visualize potential correlations.

### Creating Training Materials
A trainer needs to show how three departments overlap in terms of specialized knowledge. They prompt the agent for a Venn diagram, which uses generate_venn_diagram to clearly outline shared versus unique skills.

## Benefits

- Need to show market share? Use generate_pie_chart or generate_doughnut_chart. These tools take raw percentages and immediately render a clean, professional visual you can embed.
- Tracking growth is simple with generate_line_chart. Feed it time-series data—like monthly user counts—and get an instant trend graph showing direction and magnitude.
- Comparing performance across several metrics? The generate_radar_chart handles this. It lets you compare five or six different team skills on a single, easy-to-read visual map.
- Visualizing relationships between two variables is where scatter plots shine. Use generate_scatter_plot to see if there's a correlation, like spending vs. revenue.
- Need to link content? The dedicated generate_qr_code tool turns any URL or text into an instantly scannable image for print materials.

## How It Works

The bottom line is you talk about the visualization, and the system outputs the finished graphic.

1. Subscribe to ImageCharts and provide your API key (optional, but recommended for watermark-free output).
2. Send a natural language request—for example, 'Show me Q1 revenue vs. Q2 revenue in a bar chart.'
3. The MCP routes the data parameters, generates the image file, and returns a ready-to-use URL.

## Frequently Asked Questions

**How do I use ImageCharts MCP generate_bar_chart?**
You simply ask the agent for a bar chart and provide the data points. Specify if you want it vertical or horizontal, and list your categories and values.

**Can generate_qr_code handle URLs longer than 50 characters?**
Yes, generate_qr_code handles long strings without issue. Just provide the full URL you want to encode; it generates a scannable image ready for use.

**What's the difference between generate_pie_chart and generate_doughnut_chart?**
They show proportional data, but the doughnut chart leaves a hole in the middle. You just need to specify which style you prefer when prompting the agent.

**Do I need to use generate_scatter_plot for all correlation checks?**
No, that's not required. Use generate_scatter_plot if you are looking at a relationship between two variables, but try generate_bubble_chart when the third variable (like size) adds critical context.

**When I use generate_venn_diagram, what data input is needed for overlapping sets?**
You must provide three distinct lists of values. The system automatically calculates the intersection between those sets and renders the overlap area in the diagram. This makes visualizing shared elements straightforward.

**Are there rate limits if I call generate_bar_chart too many times?**
Yes, all MCPs operate under specific usage quotas to ensure stability. If you hit a limit, your agent will receive an error code requiring a pause. Check the Vinkius documentation for current rate parameters.

**What is the recommended resolution when embedding a chart from generate_bubble_chart?**
We recommend requesting images at a minimum of 800x600 pixels. This high resolution ensures that size encoding and data labels stay crisp, even when embedded in large dashboards or print reports.

**Can generate_line_chart track trends for more than two different variables?**
Absolutely, it supports multiple data series. Just define the parameters for each line you want to plot. The resulting graph keeps every trend distinct using unique colors and markers.

**Do I need an API key to use ImageCharts?**
The API key is optional. Without it, generated charts include a watermark. With a paid API key, charts are watermark-free and you get higher rate limits. The key is passed as a query parameter to `image-charts.com/chart`.

**What chart types can I generate?**
Six types: bar charts (`generate_bar_chart`), pie charts (`generate_pie_chart`), line charts (`generate_line_chart`), radar charts (`generate_radar_chart`), bubble charts (`generate_bubble_chart`), and QR codes (`generate_qr_code`). Each supports custom colors, labels, sizes, and data series.

**Can I generate QR codes from any text or URL?**
Yes. The `generate_qr_code` tool creates a scannable QR code image from any text, URL, or data string. You can customize the size and error correction level.