Prepare the server locally
Run this once before adding it to Claude Code.
pip install mcp httpxRegister it in Claude Code
claude mcp add -e "SERPER_API_KEY=${SERPER_API_KEY}" infographic-mcp -- python /path/to/server.pyReplace any placeholder paths in the command with the real path on your machine.
SERPER_API_KEYMake your agent remember this setup
infographic-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Search for web pages and articles featuring infographics
- Search for infographic images with size and aspect ratio filters
- Target specific platforms like Visual Capitalist, Behance, or Dribbble
- Automatic infographic context injection on all queries
- SSE transport for real-time MCP client communication
Tools 3
search_infographicsSearch for infographic-related web pages and articles.search_infographic_imagesSearch for infographic images with optimized size and aspect ratio filters.search_infographics_by_sourceSearch for infographics from a specific curated platform.Environment Variables
SERPER_API_KEYrequiredYour Serper API key for accessing search services.Try it
Original README from Devansh-365/infographic-mcp
Infographic MCP Server
A Python MCP server that lets AI assistants search for infographic images using the Serper API. Find data visualizations, statistical graphics, and visual explainers — with smart filters optimized for infographic content.
Features
search_infographics— Find web pages, articles, and galleries featuring infographicssearch_infographic_images— Search for infographic images with size and aspect ratio filterssearch_infographics_by_source— Target specific platforms like Visual Capitalist, Behance, or Dribbble- Automatic "infographic" context injection on all queries
- Large image + tall aspect ratio filters by default (how most infographics are shaped)
- SSE transport for real-time MCP client communication
Quick Start
1. Install dependencies
pip install mcp httpx
2. Set your API key
Get a free key at serper.dev, then set it as an environment variable:
export SERPER_API_KEY="your-api-key-here"
3. Run the server
python server.py
The server starts on http://0.0.0.0:8000 with the SSE endpoint at /sse.
4. Connect your MCP client
Point your MCP client (e.g. Claude Desktop) to:
http://<your-server-address>:8000/sse
Tools
`search_infographics`
Search for infographic-related web pages and articles.
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Topic to find infographics about |
num_results |
integer | 10 | Number of results (1–20) |
Example queries: "climate change", "social media marketing stats", "coffee production worldwide"
`search_infographic_images`
Search for infographic images with optimized size and aspect ratio filters.
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Topic to find infographic images for |
num_results |
integer | 10 | Number of results (1–20) |
aspect_ratio |
string | "tall" |
Image shape: "tall", "wide", "square", or "panoramic" |
Example queries: "nutrition facts", "startup funding process", "global warming statistics"
`search_infographics_by_source`
Search for infographics from a specific curated platform.
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Topic to search for |
source |
string | required | Platform name (see list below) |
num_results |
integer | 10 | Number of results (1–20) |
Supported sources: visual capitalist, behance, dribbble, information is beautiful, cool infographics, venngage, canva, statista, pinterest, visme
Example: search for "economy" on "visual capitalist"
Project Structure
server.py # MCP server — tool definitions and Serper API integration
config.py # Configuration — API keys, filters, curated sources
pyproject.toml # Project metadata and dependencies
Configuration
All settings live in config.py:
| Variable | Default | Description |
|---|---|---|
SERPER_API_KEY |
from env | Your Serper API key |
SERPER_SEARCH_URL |
https://google.serper.dev/search |
Web search endpoint |
SERPER_IMAGES_URL |
https://google.serper.dev/images |
Image search endpoint |
DEFAULT_NUM_RESULTS |
10 |
Results per query |
DEFAULT_IMAGE_SIZE |
"l" (large) |
Image size filter |
DEFAULT_ASPECT_RATIO |
"t" (tall) |
Default aspect ratio for infographics |
INFOGRAPHIC_SOURCES |
dict | Curated source name → domain mapping |
Troubleshooting
| Problem | Solution |
|---|---|
SERPER_API_KEY is not set |
Set the environment variable or add it to .env |
API Error: status 401 |
Invalid API key — verify it at serper.dev |
API Error: status 429 |
Rate limit hit — wait and retry |
Network Error |
Check your internet connection |