Omilia MCP Tools
OfficialThe Omilia MCP Tools server enables LLM clients to build, deploy, and operate conversational AI agents on the Omilia Cloud Platform (OCP) through natural language commands.
Discovery & Search: List and search OCP groups, agents, knowledge bases, Pathfinder projects, Orchestrator apps, miniapps, phone numbers, variable collections, and dialog logs.
Orchestrator Apps: Create, fetch, deploy, and test conversational flows; send messages to deployed applications to test agent replies.
Agent Management: Create and update Concierge and Task agents, manage instructions, configure sub-agents, and add escalation queues.
WebService Tools: Create and edit WebService miniapps, set welcome, initial, error, and reaction prompts, and attach tools to agents.
Knowledge Management: Create Pathfinder projects, crawl URLs into FAQs, and attach knowledge bases to agents.
Monitoring & Debugging: Retrieve full dialog logs for specific dialog IDs and search logs using filters such as app IDs, date ranges, caller phone numbers (ANI), and OCP group names.
Variables: Search variable collections and list all variables within a collection.
Integrates with Google's Gemini CLI as an MCP-compatible client, enabling users to interact with the Omilia Cloud Platform tools for conversational AI management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Omilia MCP Toolssearch miniapps for customer support"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Omilia MCP Server
Documentation: learn.ocp.ai
A Model Context Protocol server that lets MCP-aware LLM clients build, deploy, and operate conversational AI agents on the Omilia Cloud Platform (OCP) through natural language. Create an orchestrator app, spin up an autonomous agent, attach a knowledge base from a URL, wire a webservice tool, deploy, and smoke-test the result — all from a chat prompt in your editor or desktop app.
The server runs locally and talks to OCP over authenticated HTTPS. No data leaves your machine except the requests your MCP client makes on your behalf.
Supported MCP clients
Claude Desktop, Claude Code, Cursor, VS Code (with Copilot), and Codex.
Related MCP server: Spotinst MCP Server
Install
Recommended — interactive wizard (answers a few prompts, then confirms before writing anything):
npx github:omilia/mcp initThe wizard selects your client, collects credentials with masked input,
runs prereq checks (Node 20+, uv), installs the config, and prints a
PASS/FAIL smoke-test summary before exiting. See the
Interactive wizard section
in the installation guide for the full prompt sequence.
Non-interactive / CI — supply all flags to skip prompts:
npx github:omilia/mcp init --client <claude|claude-code|cursor|vscode|codex>See the full installation guide at docs/installation.md
for the .mcpb one-click bundle (Claude Desktop) and manual configuration
alternatives.
Authentication
Recommended: Keycloak password grant — set OCP_USERNAME, OCP_PASSWORD, and OCP_KEYCLOAK_REALM (default master).
Faster path: a Personal Access Token via OCP_ACCESS_TOKEN.
Both run in-memory only — credentials never persist. See docs/installation.md for the realm-by-environment table.
Tools (31)
The MCP surface, grouped by area. Each row is one tool your MCP-aware
LLM can invoke through tools/call.
Discovery & guides
Tool | Description |
| Return a markdown guide for a canonical OCP MCP workflow |
| List OCP groups the current user has access to |
| List all agents in scope |
| List knowledge bases (FAQ vector stores) |
| List Pathfinder projects (search filterable) |
| Search Orchestrator apps |
| Search miniapps |
| Search phone numbers attached to apps |
| Search variable collections |
| Search dialog logs by group / app / date |
Orchestrator apps
Tool | Description |
| Create a new Orchestrator app |
| Fetch an app's canvas |
| Wire a Concierge into an app's canvas |
| Deploy an Orchestrator app |
| Send a message to a deployed app and receive the agent's reply |
Agents (Concierge & Task)
Tool | Description |
| Create a Concierge or Task agent |
| Update an agent's instructions |
| Update the Concierge's sub-agent list |
| Add a sub-agent to a Concierge |
| Add escalation queue(s) to an agent |
WebService miniapps & agents
Tool | Description |
| Create a WebService miniapp (HTTP tool) |
| Fetch a miniapp's configuration |
| Edit a WebService miniapp's request config |
| Set welcome / initial / error prompts on a miniapp |
| Create a Task agent that uses a WebService miniapp |
| Add another WebService tool to a Task agent |
Pathfinder (knowledge)
Tool | Description |
| Create a Pathfinder project |
| Crawl a URL into a Pathfinder FAQ and attach it to an agent |
| Attach an existing knowledge base to an agent |
Variables & dialogs
Tool | Description |
| List variables in a collection |
| Fetch the full dialog log for a dialog ID |
Examples
End-to-end walkthroughs of the canonical journeys (build, deploy, test, extend) live at docs/examples/.
License
MIT. See LICENSE.
Provenance
This repository is auto-generated from an internal source on every
release. Generated from internal commit 333d04b1f44b7f54b0803eba5c1631dd8b101444 on branch
mirror/333d04b1f44b. This release exposes 31 tools
across src/main.py, src/server.py. PRs against this repository cannot be merged
back upstream — open issues for visibility and feedback; bug fixes are
tracked in the internal source.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/omilia/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server