Omilia MCP Tools

This repository contains a set of tools for working with the Omilia Cloud Platform (OCP). These utilities help manage miniapps, orchestrator apps, and dialog logs.

Tools Overview

• search_miniapps: Search for miniapps by name or keyword.
• get_miniapp: Retrieve details for a specific miniapp using its ID.
• set_miniapp_prompt: Update prompts (welcome, error, reaction messages) for a miniapp.
• get_dialog_logs: Fetch logs for a specific dialog session.
• search_orchestrator_apps: Search for Orchestrator apps by keyword.
• get_orchestrator_app: Retrieve the canvas (nodes and edges) for an Orchestrator app by ID.
• search_dialog_logs: Search dialog logs with various filters (date, app, region, etc.).
• search_numbers: Search for phone numbers with optional search term.
• search_variable_collections: Search variable collections with optional search term.
• get_collection_variables: Get a list of all variables in a collection by ID.

---

Installation

• Make sure you have Python 3.10 or newer installed.
• Install uv.
• Clone this repository and navigate to the project directory.
• Copy the file .env.example to .env and set the appropriate values.
• Test if the istallation is correct by running uv run mcp dev src/main.py. This should open the mcp development server. Click on connect and try it out.

Usage

You can use these tools in two main ways:

1. Self-hosting (MCP Python SDK)

You can run your own MCP server using the official Python MCP SDK. This is the most flexible option and is recommended for advanced users. For full instructions, see the MCP Python SDK README.

2. Local usage with Gemini CLI, Cursor, or Claude Desktop

You can also use this project locally with any MCP-compatible client, such as:

• Gemini CLI
• Cursor
• Claude Desktop

Each of these clients allows you to connect to local MCP servers. For more information, see their respective documentation:

• Gemini CLI: Configuring custom MCP servers
• Claude Desktop: MCP servers
• Cursor: Configuring custom MCP servers

Configuring MCP Servers

To use this project with any of the above clients, you need to configure your MCP servers. For example, you can use the following mcp.json configuration (place it in the appropriate config directory for your client):

{
  "mcpServers": {
    "Omilia MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "<path_to_cloned_repository>>/omilia-mcp/src/main.py"
      ],
      "env": {
        "PATH": "<depending on how you installed the needed tools you may need to paste your PATH here>"
      }
    }
  }
}

---