# 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.
## 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
### ⭐ Easiest Method (Recommended)
**One command to install with Claude Code/Desktop:**
```bash
# 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**
```bash
npm install -g cakemail-api-docs
claude mcp add cakemail-api-docs cakemail-api-docs
```
**Method 2: Using pip**
```bash
pip install cakemail-api-docs-mcp
claude mcp add cakemail-api-docs cakemail-api-docs-mcp
```
**Method 3: From source (for development)**
```bash
git clone https://github.com/cakemail/cakemail-api-documentation-mcp.git
cd cakemail-api-documentation-mcp
uv pip install -e ".[dev]"
```
See [INSTALLATION.md](./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`:
```json
{
"mcpServers": {
"cakemail": {
"command": "cakemail-api-docs-mcp",
"env": {
"OPENAPI_SPEC_PATH": "https://api.cakemail.dev/openapi.json"
}
}
}
}
```
### Running Standalone
```bash
cakemail-api-docs-mcp
```
Or using Python module:
```bash
python -m cakemail_mcp
```
### Integrating with Claude Desktop
Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"cakemail": {
"command": "cakemail-api-docs-mcp",
"env": {
"OPENAPI_SPEC_PATH": "/path/to/cakemail/openapi.json"
}
}
}
}
```
## Development
### Setup
```bash
# 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
```bash
pytest
```
### Code Quality
```bash
# Format code
black src tests
# Lint
ruff check src tests
# Type check
mypy src
```
## License
MIT License - see [LICENSE](LICENSE) for details.
## Contributing
Contributions are welcome! Please see our [contributing guidelines](CONTRIBUTING.md) for details.
## Support
- [Documentation](https://github.com/cakemail/cakemail-api-docs-mcp#readme)
- [Issue Tracker](https://github.com/cakemail/cakemail-api-docs-mcp/issues)
- [Cakemail API Documentation](https://docs.cakemail.com)
Raw data
{
"_id": null,
"home_page": null,
"name": "cakemail-api-docs-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, api, cakemail, mcp, model-context-protocol, openapi",
"author": null,
"author_email": "Cakemail <support@cakemail.com>",
"download_url": "https://files.pythonhosted.org/packages/bb/98/f9f58d34f152ace3ab68ba58922dc9c52ae4123424d9c6b1813a7b40c488/cakemail_api_docs_mcp-0.1.2.tar.gz",
"platform": null,
"description": "# Cakemail API MCP Server\n\nA Model Context Protocol (MCP) server that exposes Cakemail's email marketing API documentation to AI agents, eliminating hallucination and enabling accurate code generation.\n\n## Overview\n\nThe 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.\n\n## Features\n\n- **Zero-hallucination guarantee**: AI agents get facts from OpenAPI spec, not statistical guesses\n- **Real-time API documentation**: Always reflects the latest API state\n- **Seamless integration**: Works with Claude Desktop, Cursor, and other MCP-compatible tools\n- **Fast queries**: <500ms response time for spec lookups\n\n## Installation\n\n### \u2b50 Easiest Method (Recommended)\n\n**One command to install with Claude Code/Desktop:**\n\n```bash\n# Using npx (works for everyone!)\nclaude mcp add cakemail-api-docs -- npx cakemail-api-docs\n\n# Or using uvx (Python developers)\nclaude mcp add cakemail-api-docs -- uvx cakemail-api-docs-mcp\n```\n\nThat's it! No manual configuration needed.\n\n### Alternative Methods\n\n**Method 1: Using npm**\n```bash\nnpm install -g cakemail-api-docs\nclaude mcp add cakemail-api-docs cakemail-api-docs\n```\n\n**Method 2: Using pip**\n```bash\npip install cakemail-api-docs-mcp\nclaude mcp add cakemail-api-docs cakemail-api-docs-mcp\n```\n\n**Method 3: From source (for development)**\n```bash\ngit clone https://github.com/cakemail/cakemail-api-documentation-mcp.git\ncd cakemail-api-documentation-mcp\nuv pip install -e \".[dev]\"\n```\n\nSee [INSTALLATION.md](./INSTALLATION.md) for detailed installation options.\n\n## Quick Start\n\n### Using with Claude Desktop\n\nAfter running `claude mcp add`, restart Claude Desktop. You should see a \ud83d\udd0c icon indicating the server is connected.\n\n**Test it:**\n- \"Can you check the health of the Cakemail MCP server?\"\n- \"List all Cakemail API endpoints\"\n- \"Show me how to authenticate with the Cakemail API\"\n\n### Manual Configuration\n\nIf not using `claude mcp add`, edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"cakemail\": {\n \"command\": \"cakemail-api-docs-mcp\",\n \"env\": {\n \"OPENAPI_SPEC_PATH\": \"https://api.cakemail.dev/openapi.json\"\n }\n }\n }\n}\n```\n\n### Running Standalone\n\n```bash\ncakemail-api-docs-mcp\n```\n\nOr using Python module:\n\n```bash\npython -m cakemail_mcp\n```\n\n### Integrating with Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n \"mcpServers\": {\n \"cakemail\": {\n \"command\": \"cakemail-api-docs-mcp\",\n \"env\": {\n \"OPENAPI_SPEC_PATH\": \"/path/to/cakemail/openapi.json\"\n }\n }\n }\n}\n```\n\n## Development\n\n### Setup\n\n```bash\n# Clone repository\ngit clone https://github.com/cakemail/cakemail-api-docs-mcp.git\ncd cakemail-api-docs-mcp\n\n# Install with development dependencies\nuv pip install -e .[dev]\n```\n\n### Running Tests\n\n```bash\npytest\n```\n\n### Code Quality\n\n```bash\n# Format code\nblack src tests\n\n# Lint\nruff check src tests\n\n# Type check\nmypy src\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Contributing\n\nContributions are welcome! Please see our [contributing guidelines](CONTRIBUTING.md) for details.\n\n## Support\n\n- [Documentation](https://github.com/cakemail/cakemail-api-docs-mcp#readme)\n- [Issue Tracker](https://github.com/cakemail/cakemail-api-docs-mcp/issues)\n- [Cakemail API Documentation](https://docs.cakemail.com)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server exposing Cakemail API documentation to AI agents",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://github.com/cakemail/cakemail-api-documentation-mcp#readme",
"Homepage": "https://github.com/cakemail/cakemail-api-documentation-mcp",
"Issues": "https://github.com/cakemail/cakemail-api-documentation-mcp/issues",
"Repository": "https://github.com/cakemail/cakemail-api-documentation-mcp"
},
"split_keywords": [
"ai",
" api",
" cakemail",
" mcp",
" model-context-protocol",
" openapi"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bb8789150d89754fc8a18d652e7c843affab32bce6b0f785f986df4bda602a61",
"md5": "6f7972ec75fcf13f2d839b59d2f9db8f",
"sha256": "e857bd256b66467fbd0548706bf1d551a72c7919450243ba998e2f70bed6388b"
},
"downloads": -1,
"filename": "cakemail_api_docs_mcp-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6f7972ec75fcf13f2d839b59d2f9db8f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 48892,
"upload_time": "2025-10-06T19:44:39",
"upload_time_iso_8601": "2025-10-06T19:44:39.499817Z",
"url": "https://files.pythonhosted.org/packages/bb/87/89150d89754fc8a18d652e7c843affab32bce6b0f785f986df4bda602a61/cakemail_api_docs_mcp-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bb98f9f58d34f152ace3ab68ba58922dc9c52ae4123424d9c6b1813a7b40c488",
"md5": "74e10116d988a3ef693f49b0c1d52d1e",
"sha256": "c4c2e6cbaf5e834928347eb516eb92f796b91331f9a14949039766081b0d1b88"
},
"downloads": -1,
"filename": "cakemail_api_docs_mcp-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "74e10116d988a3ef693f49b0c1d52d1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 358794,
"upload_time": "2025-10-06T19:44:40",
"upload_time_iso_8601": "2025-10-06T19:44:40.601794Z",
"url": "https://files.pythonhosted.org/packages/bb/98/f9f58d34f152ace3ab68ba58922dc9c52ae4123424d9c6b1813a7b40c488/cakemail_api_docs_mcp-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 19:44:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cakemail",
"github_project": "cakemail-api-documentation-mcp#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cakemail-api-docs-mcp"
}
JSON
