Documentation

Complete reference for all Mediagram MCP tools

Getting Started

1. Prerequisites
  • An MCP-compatible client (Claude Desktop, Continue, Cursor, etc.)
  • A Mediagram account (sign up for free)
  • Your API key from the Mediagram dashboard
2. Configure Your MCP Client
{
  "mcpServers": {
    "mediagram": {
      "command": "npx",
      "args": ["-y", "@mediagram/mcp-server"],
      "env": {
        "MEDIAGRAM_API_KEY": "your-api-key-here"
      }
    }
  }
}
3. Start Using

Once configured, simply ask your AI assistant to generate visual content. For example: “Create a map of Paris with markers at the Eiffel Tower and Louvre” or “Generate a portfolio chart showing monthly returns.”


Output Formats

Each tool supports one or more output formats:

Image
PNG image output
PPTX
Editable PowerPoint
GIF / MP4
Animated content
HTML
Coming soon

Tool Categories

Map Styles

All map tools support multiple tile styles. Choose the one that best fits your use case.

OSMOSM
Carto LightCarto Light
Carto DarkCarto Dark
SatelliteSatellite
ValueNameDescription
osmOpenStreetMapStandard map with roads, labels, and terrain colors
satelliteSatelliteAerial/satellite imagery from ESRI
cartoCarto LightClean, minimal light-themed map
carto-nolabelsCarto Light (No Labels)Light theme without text labels
carto-darkCarto DarkDark-themed map for presentations
carto-dark-nolabelsCarto Dark (No Labels)Dark theme without text labels
topoTopographicTopographic map with elevation contours

Social Media Presets

Pixel-perfect sizing for every platform — TikTok, Instagram, X, Facebook, YouTube

Every image, animation, and map tool supports the preset parameter. Just specify the platform and Mediagram handles the dimensions automatically. Works with PNG images, GIF animations, and MP4 videos.

// Just add preset to any tool call:
{ "preset": "tiktok" }      // 1080x1920 (9:16)
{ "preset": "instagram-story" }  // 1080x1920 (9:16)
{ "preset": "instagram-square" } // 1080x1080 (1:1)
{ "preset": "twitter" }     // 1200x675  (16:9)
{ "preset": "youtube-thumbnail" } // 1280x720 (16:9)

// Or simply ask in natural language:
// "Create a TikTok-sized zoom animation into Paris"
// "Generate an Instagram story map of Tokyo"
TikTok
tiktok
Instagram
instagram-story
instagram-square
instagram-landscape
X (Twitter)
twitter
twitter-header
Facebook
facebook
YouTube
youtube-thumbnail
PresetPlatformDimensionsAspect Ratio
tiktokTikTok1080 x 19209:16
instagram-storyInstagram Story1080 x 19209:16
instagram-squareInstagram Post1080 x 10801:1
instagram-landscapeInstagram Feed1080 x 5661.91:1
twitterX (Twitter) Post1200 x 67516:9
twitter-headerX (Twitter) Header1500 x 5003:1
facebookFacebook1200 x 6301.91:1
youtube-thumbnailYouTube Thumbnail1280 x 72016:9

Need Help?

Check out our GitHub repository for source code and issue tracking. For questions or feature requests, open an issue or join the community discussions.