MCP Server - Easy-Peasy.AI

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 the id, email, and name of the authenticated account — the quickest way to confirm auth works before spending credits.

Browse the tools

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

Troubleshooting

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

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

​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

Troubleshooting