MCP Server

Overview

Easy-Peasy.AI runs a remote MCP (Model Context Protocol) server, so AI agents can use the platform directly — generate text from templates, create images and videos, synthesize speech, and transcribe audio. Any MCP-capable client works: Claude, Claude Code, Cursor, Windsurf, ChatGPT connectors, or your own agent.

Endpoint

https://easy-peasy.ai/mcp

Transport

Streamable HTTP (stateless)

All usage is billed to your account exactly like the REST API — same credits, word quotas, and plan limits.

Authentication

You can connect in one of two ways.

API key

Send your API key — the same one used by the REST API — as an x-api-key header or as Authorization: Bearer YOUR_API_KEY. Use this for clients that read headers from a config file.

Get your API key

Generate an API key from your Easy-Peasy.AI settings page.

Connect your client

Claude (claude.ai and Claude Desktop)

Go to Settings → Connectors → Add custom connector.
Paste https://easy-peasy.ai/mcp and click Add.
Click Connect, sign in to Easy-Peasy.AI, and approve access.

Claude Code

claude mcp add easy-peasy --transport http https://easy-peasy.ai/mcp \
  --header "x-api-key: YOUR_API_KEY"

Cursor, Windsurf, and generic `mcp.json`

{
  "mcpServers": {
    "easy-peasy": {
      "url": "https://easy-peasy.ai/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop config file

Claude Desktop connects best through Settings → Connectors (OAuth, above). If you prefer the config file with an API key, bridge the connection with mcp-remote:

{
  "mcpServers": {
    "easy-peasy": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://easy-peasy.ai/mcp",
        "--header",
        "x-api-key: YOUR_API_KEY"
      ]
    }
  }
}

Verify the connection

Ask your agent to call the get_account tool. It returns { "connected": true } to confirm authentication without spending generation credits. It does not expose account details or check your remaining quota.

Browse the tools

See all 13 tools, their parameters, and the async polling pattern.

Inline media previews

Ask your agent to show a saved image or video with display_media. Clients that support MCP Apps can show an image gallery or a playable video inside the conversation. Other clients receive the result links. Viewing an existing result does not consume generation credits. The video viewer can check a processing job without creating another video.

Troubleshooting

I see links but no image or video viewer

Refresh the connector’s tool list and ask your agent to use display_media with an existing image or video ID. In Claude, open Customize → Connectors → Yours → Easy-Peasy.AI, then choose Refresh tools list from the menu. Your client must support MCP Apps to render the viewer; links remain available otherwise.

401 Unauthorized

The API key is missing or invalid, or the OAuth token expired. Check the header name (x-api-key), or reconnect the connector to refresh the OAuth token.

A tool returns a plan error

generate_image and transcribe_audio require a paid plan for API access. Free accounts can still use generate_text, generate_speech, and the read-only tools.

Video or transcription never finishes

Both are asynchronous. The agent must poll get_video or get_transcription until the result is ready — see Tools.

Overview

Agents

MCP Server

Overview

Endpoint

Transport

Authentication

Get your API key

Connect your client

Claude (claude.ai and Claude Desktop)

Claude Code

Cursor, Windsurf, and generic `mcp.json`

Claude Desktop config file

Verify the connection

Browse the tools

Inline media previews

Troubleshooting

​Overview

Endpoint

Transport

​Authentication

Get your API key

​Connect your client

​Claude (claude.ai and Claude Desktop)

​Claude Code

​Cursor, Windsurf, and generic mcp.json

​Claude Desktop config file

​Verify the connection

Browse the tools

​Inline media previews

​Troubleshooting

Overview

Authentication

Connect your client

Claude (claude.ai and Claude Desktop)

Claude Code

Cursor, Windsurf, and generic `mcp.json`

Claude Desktop config file

Verify the connection

Inline media previews

Troubleshooting