Whatsease MCP

CLI tool to run a Model Context Protocol (MCP) server for the Whatsease API.

Installation

pip install whatsease-mcp

Usage

Basic Usage

whatsease-mcp --api-url https://api.whatsease.com

Or using environment variable:

export WHATSEASE_API_BASE_URL=https://api.whatsease.com
whatsease-mcp

Options

Examples

# Run on custom port
whatsease-mcp -u https://api.whatsease.com -p 8080

# Run on localhost only
whatsease-mcp -u https://api.whatsease.com -h localhost

# Use stdio transport (for direct MCP client integration)
whatsease-mcp -u https://api.whatsease.com -t stdio

# Use custom config file
whatsease-mcp -u https://api.whatsease.com -c /path/to/include.json

Configuration

include.json

Create an include.json file to control which API routes are exposed as MCP tools.

Default behavior (no config or empty config): All routes from the OpenAPI spec are exposed.

With config: Only matching routes are exposed, plus a catch-all exclude at the end.

Format

{
    "include": [
        {
            "mcp_type": "TOOL",
            "methods": ["GET", "POST"],
            "pattern": "/platforms/.*"
        },
        {
            "mcp_type": "TOOL",
            "methods": ["GET"],
            "pattern": "/templates/.*"
        }
    ]
}

Fields

Example Configurations

Expose only GET routes:

{
    "include": [
        {
            "mcp_type": "TOOL",
            "methods": ["GET"],
            "pattern": ".*"
        }
    ]
}

Expose specific endpoints:

{
    "include": [
        {
            "mcp_type": "TOOL",
            "methods": ["GET", "POST"],
            "pattern": "^/platforms/.*"
        },
        {
            "mcp_type": "TOOL",
            "methods": ["GET"],
            "pattern": "^/templates/.*"
        },
        {
            "mcp_type": "TOOL",
            "methods": ["GET", "POST"],
            "pattern": "^/campaigns/.*"
        }
    ]
}

License

MIT