MCP Servers
OMD Cleo exposes OMD back-end capabilities through Model Context Protocol (MCP) servers. MCP is an open standard for connecting AI agents to external tools and data sources over HTTP.
What is MCP?
The Model Context Protocol defines a standard way for AI agents to discover and invoke tools provided by external services. Each MCP server exposes a list of tools; an MCP client (the AI agent) calls these tools during a conversation.
OMD's MCP servers use Streamable HTTP transport with JWT Bearer token authentication. This means any MCP-compatible client — not just OMD Cleo — can connect to these servers provided it holds a valid OMD access token.
Available MCP servers
| Server | Port | Status | Description |
|---|---|---|---|
| omd-go-service | 8050 | Available | OData entity schema and query / CRUD for OMD Go |
| powerhouse-service | 8051 | Available | Superset BI dashboards, charts, SQL Lab for OMD Powerhouse |
| auth-server | 9000 | Dev / internal | JWT issuance and JWKS for development and internal use |
| docs-service | — | In development | Document Hub MCP server |
| OMD Assets service | — | Roadmap | Asset repository MCP server |
Authentication
All production MCP servers require a valid JWT Bearer token in the Authorization header:
Authorization: Bearer <access_token>
Tokens are issued by the OMD OAuth 2 identity provider. The server validates the token's signature using the JWKS endpoint and checks the issuer claim.
For local development, the included auth-server can issue development tokens.
Connecting a third-party MCP client
To connect an external MCP client (e.g. Claude Desktop, a custom agent) to an OMD MCP server:
- Obtain an access token from the OMD identity provider.
- Point the client at the server URL (e.g.
https://mcp.optimizemyday.com/omd-go/mcp). - Pass the token as a Bearer token on each request.
Development setup
All services in omd-mcp use uv for dependency management:
# Example: start the omd-go-service
uv sync --project omd-go-service
uv run --project omd-go-service --directory omd-go-service/src python main.py
See individual service pages for port numbers and environment variables.