datawrapper-mcp

A Model Context Protocol (MCP) server and app for creating Datawrapper charts using AI assistants. Built on the datawrapper Python library.

Example Usage

You can provide a data file and simply ask for the chart you want. The draft will soon appear in the panel.

Books chat chart

Here's a more complete example showing how to create, publish, update, and display a chart by chatting with the assistant:

"Create a datawrapper line chart showing temperature trends with this data:
2020, 15.5
2021, 16.0
2022, 16.5
2023, 17.0"
# The assistant creates the chart and returns the chart ID, e.g., "abc123"

"Publish it."
# The assistant publishes it and returns the public URL

"Update chart with new data for 2024: 17.2°C"
# The assistant updates the chart with the new data point

"Make the line color dodger blue."
# The assistant updates the chart configuration to set the line color

"Show me the editor URL."
# The assistant returns the Datawrapper editor URL where you can view/edit the chart

"Show me the PNG."
# The assistant embeds the PNG image of the chart in its contained response.

"Suggest five ways to improve the chart."
# See what happens!

Tools

Tool	Description
`list_chart_types`	List available chart types with descriptions
`get_chart_schema`	Get the full configuration schema for a chart type
`create_chart`	Create a new chart with data and configuration
`update_chart`	Update an existing chart's data or styling
`publish_chart`	Publish a chart to make it publicly accessible
`get_chart`	Retrieve a chart's configuration and metadata
`delete_chart`	Permanently delete a chart
`export_chart_png`	Export a chart as a PNG image

Chart Types

bar, line, area, arrow, column, multiple column, scatter, stacked bar

Use list_chart_types to see descriptions, then get_chart_schema to explore configuration options for any type.

Getting Started

Requirements

A Datawrapper account (sign up at https://datawrapper.de/signup/)
An MCP client such as Claude or OpenAI Codex
Python 3.10 or higher

Get Your API Token

Go to https://app.datawrapper.de/account/api-tokens
Create a new API token
Add it to your MCP configuration as shown in the installation guide

Quick Start (Claude Code)

{
  "mcpServers": {
    "datawrapper": {
      "command": "uvx",
      "args": ["datawrapper-mcp"],
      "env": {
        "DATAWRAPPER_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

For other clients (Claude Desktop, Cursor, VS Code Copilot, ChatGPT, OpenAI Codex) and Kubernetes deployment, see the installation guide.

Using Your Own Token (Hosted Deployments)

When connecting to a hosted instance of the server over HTTP, you can authenticate with your own Datawrapper API token by sending it in the Authorization header:

Authorization: Bearer <your-datawrapper-api-token>

This ensures charts are created under your account instead of the server operator's. The token is read from the header automatically — no need to include it in every tool call.

You can also pass access_token directly as a tool argument, which takes precedence over the header. When neither is provided, the server falls back to its DATAWRAPPER_ACCESS_TOKEN environment variable.

Supported Clients

Client	Config file	Transport
Claude Desktop	`claude_desktop_config.json`	stdio or streamable-http
Claude.ai	Managed connector	streamable-http
Claude Code	`.claude/settings.json`	stdio
VS Code Copilot	`.vscode/mcp.json`	stdio
Cursor	`.cursor/mcp.json`	stdio or streamable-http
ChatGPT	Dev Mode settings	streamable-http only
OpenAI Codex	`~/.codex/config.toml`	stdio

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datawrapper_mcp-0.2.3.tar.gz (1.1 MB view details)

Uploaded Mar 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

datawrapper_mcp-0.2.3-py3-none-any.whl (22.4 kB view details)

Uploaded Mar 27, 2026 Python 3

File details

Details for the file datawrapper_mcp-0.2.3.tar.gz.

File metadata

Download URL: datawrapper_mcp-0.2.3.tar.gz
Upload date: Mar 27, 2026
Size: 1.1 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for datawrapper_mcp-0.2.3.tar.gz
Algorithm	Hash digest
SHA256	`fb7eb09dd3fe5ec42af15e2e369a5f880a24e5755f6da4706fb573c9524ada26`
MD5	`d48b5f5f3351eae231373c7f146bde38`
BLAKE2b-256	`b0e3618be73e25ab6ec58906d5e1d5032eeb649e3df09013d8834de4c7dfa1d0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for datawrapper_mcp-0.2.3.tar.gz:

Publisher: continuous-deployment.yaml on palewire/datawrapper-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: datawrapper_mcp-0.2.3.tar.gz
- Subject digest: fb7eb09dd3fe5ec42af15e2e369a5f880a24e5755f6da4706fb573c9524ada26
- Sigstore transparency entry: 1188751079
- Sigstore integration time: Mar 27, 2026
Source repository:
- Permalink: palewire/datawrapper-mcp@508cd5338ef02a6f54590db2bd4134ccfc3a5aa6
- Branch / Tag: refs/tags/0.2.3
- Owner: https://github.com/palewire
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: continuous-deployment.yaml@508cd5338ef02a6f54590db2bd4134ccfc3a5aa6
- Trigger Event: push