Sessionize MCP Server

A Model Context Protocol (MCP) server that exposes Sessionize session data as a tool. It allows AI agents and LLM clients to search for speakers and talks by date.

Tools

Tool	Description
search_sessionize	Search for sessions by month in Month Year format (e.g. April 2025)

Configuration

The server is configured via environment variables:

Variable	Description	Required
SESSIONIZE_URL	Sessionize API endpoint URL	Yes
SESSIONIZE_DATE_FILTER_CATEGORY_ID	Category ID used to filter sessions by date	Yes

Running Locally

With Python

pip install -r requirements.txt

SESSIONIZE_URL="https://sessionize.com/api/v2/<your-id>/view/Sessions" \
SESSIONIZE_DATE_FILTER_CATEGORY_ID=61493 \
python src/sessionize_tool.py

With Podman / Docker

podman build -t sessionize-mcp .

podman run -p 8080:8080 \
  -e SESSIONIZE_URL="https://sessionize.com/api/v2/<your-id>/view/Sessions" \
  -e SESSIONIZE_DATE_FILTER_CATEGORY_ID=61493 \
  sessionize-mcp

The MCP endpoint will be available at http://localhost:8080/mcp.

Client Configuration

VS Code / GitHub Copilot

Add to your .vscode/mcp.json:

{
  "servers": {
    "sessionize": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sessionize": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "sessionize": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Open WebUI

1. Go to Settings → Tools → Add MCP Server
2. Set the URL to http://<host>:8080/mcp

curl

# Initialize session
curl -i -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# Call the tool (use mcp-session-id from the response headers above)
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <session-id>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_sessionize","arguments":{"date":"April 2025"}}}'