Skip to main content
Glama
Cakemail API MCP Server

Cakemail API MCP Server

Official
by cakemail

Cakemail API MCP Server

A Model Context Protocol (MCP) server that exposes Cakemail's email marketing API documentation to AI agents, eliminating hallucination and enabling accurate code generation.

Overview

The Cakemail API MCP Server provides AI coding assistants (Claude, Cursor, GitHub Copilot) with direct access to authoritative Cakemail API specifications. Instead of guessing endpoint URLs, parameters, and authentication details, AI agents can query the MCP server for exact specifications from Cakemail's OpenAPI documentation.

Related MCP server: AI Agent Template MCP Server

Features

  • Zero-hallucination guarantee: AI agents get facts from OpenAPI spec, not statistical guesses

  • Real-time API documentation: Always reflects the latest API state

  • Seamless integration: Works with Claude Desktop, Cursor, and other MCP-compatible tools

  • Fast queries: <500ms response time for spec lookups

Installation

One command to install with Claude Code/Desktop:

# Using npx (works for everyone!)
claude mcp add cakemail-api-docs -- npx cakemail-api-docs

# Or using uvx (Python developers)
claude mcp add cakemail-api-docs -- uvx cakemail-api-docs-mcp

That's it! No manual configuration needed.

Alternative Methods

Method 1: Using npm

npm install -g cakemail-api-docs
claude mcp add cakemail-api-docs cakemail-api-docs

Method 2: Using pip

pip install cakemail-api-docs-mcp
claude mcp add cakemail-api-docs cakemail-api-docs-mcp

Method 3: From source (for development)

git clone https://github.com/cakemail/cakemail-api-documentation-mcp.git
cd cakemail-api-documentation-mcp
uv pip install -e ".[dev]"

See INSTALLATION.md for detailed installation options.

Quick Start

Using with Claude Desktop

After running claude mcp add, restart Claude Desktop. You should see a 🔌 icon indicating the server is connected.

Test it:

  • "Can you check the health of the Cakemail MCP server?"

  • "List all Cakemail API endpoints"

  • "Show me how to authenticate with the Cakemail API"

Manual Configuration

If not using claude mcp add, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cakemail": {
      "command": "cakemail-api-docs-mcp"
    }
  }
}

Running Standalone

cakemail-api-docs-mcp

Or using Python module:

python -m cakemail_mcp

Integrating with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "cakemail": {
      "command": "cakemail-api-docs-mcp"
    }
  }
}

Development

Setup

# Clone repository
git clone https://github.com/cakemail/cakemail-api-docs-mcp.git
cd cakemail-api-docs-mcp

# Install with development dependencies
uv pip install -e .[dev]

Running Tests

pytest

Code Quality

# Format code
black src tests

# Lint
ruff check src tests

# Type check
mypy src

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please see our contributing guidelines for details.

Support

Available Tools

5 tools
cakemail_call_apiD

Execute a Cakemail API call.

Inputs: path (required), method (required), body, headers, +1 more. Returns: object

cakemail_get_authA

Get Cakemail API authentication documentation.

Returns: Authentication requirements and configuration details, or error response if spec cannot be loaded

Inputs: no named parameters. Returns: object

cakemail_get_endpointA

Get detailed specification for a specific Cakemail API endpoint.

Inputs: path (required), method (required). Returns: object

cakemail_healthA

Check if Cakemail MCP server is operational.

Returns: Health status information including server version and endpoint count

Inputs: no named parameters. Returns: object

cakemail_list_endpointsB

List all available Cakemail API endpoints.

Inputs: tag. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: health check, endpoint listing, endpoint details, auth documentation, and API execution. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent 'cakemail_verb_noun' pattern (e.g., cakemail_health, cakemail_list_endpoints), making them predictable and easy to understand.

    Tool Count5/5

    With only 5 tools, the server is well-scoped for its role as a wrapper around the Cakemail API. Each tool provides essential functionality without unnecessary bloat.

    Completeness4/5

    The server includes health checks, endpoint discovery, auth info, and a generic API call tool, covering the core needs. However, it lacks dedicated CRUD tools for specific resources, relying on the generic call_api to fill gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A proxy server that bridges AI agents and external APIs by dynamically translating OpenAPI specifications into standardized MCP tools, enabling seamless interaction without custom integration code.
      163 PyPI
      69
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A sophisticated MCP server providing advanced memory capabilities with RAG, hallucination detection, and enterprise-grade AI infrastructure for intelligent agent ecosystems.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools to fetch live, version-accurate documentation, changelogs, examples, and method signatures for npm and PyPI packages, preventing AI coding agents from hallucinating stale APIs.
      7 npm
      ISC