ELIA Assistant MCP server

The ELIA Assistant MCP server lets Claude, ChatGPT and other AI assistants read your ELIA Assistant account: the messages your customers send across every channel, the interactions handed over to your team, your customers, your Insights figures and the knowledge base your AI agents answer from. You ask in plain language, and the assistant looks it up.

It is for the businesses that use ELIA Assistant and their teams, not for their customers. Every tool is read-only: the server never answers customers, never claims or closes interactions and never changes anything in your account.

Server address: https://elia-mcp.elia-assistant.com/mcp

What you can ask

Some examples, with what the assistant does:

  • "Which interactions has nobody picked up yet?" Lists the interactions handed over to your team that are still waiting for someone, with the customer, channel and reason for the handover.
  • "What did customers complain about this month?" Searches the month's messages marked as complaints or with negative sentiment and summarises the topics, for example a noisy room or a double charge.
  • "Summarise the conversation with anna.novak@contoso.com." Reads that customer's recent messages and answers, with their labels and the details stored on their profile.
  • "How many conversations did the AI agent resolve without a person in the last 30 days?" Returns the Insights figures for the period: message, customer and interaction counts, the share resolved without a human, handover reasons, and breakdowns by intent, channel, sentiment and day.
  • "What questions could the assistant not answer this week?" Lists the questions that were handed over because the knowledge base had no answer, so you know what to add.
  • "What does our knowledge base say about cancellations?" Reads the knowledge base your AI agent answers from.

Connect

Claude

  1. In Claude, open Settings → Connectors and add ELIA Assistant. If it is not listed yet, choose Add custom connector and enter the server address above.
  2. Claude opens the ELIA Assistant sign-in page. Sign in with your ELIA Assistant account.
  3. The next page shows which ELIA Assistant account Claude asks to read. Click Allow.

This works in Claude on the web, in Claude Desktop and in the mobile apps once connected. In Claude Code, install the plugin:

/plugin marketplace add elia-development/elia-assistant-plugins
/plugin install elia-assistant@elia-assistant

ChatGPT and Codex

In ChatGPT, add the server address as a connector with OAuth sign-in, then sign in and click Allow as above. In Codex, install the plugin:

codex plugin marketplace add elia-development/elia-assistant-plugins
codex plugin add elia-assistant@elia-assistant

Automations

Tools that cannot sign in, such as n8n, connect with an API key instead. An administrator creates one in the dashboard under Configuration → Integrations → API keys and sends it in the X-Api-Key header. Treat the key like a password: anyone who has it can read your account's messages.

Signing in and access

You sign in with the same account you use for the ELIA Assistant dashboard, through OAuth 2.1 with PKCE. Your password is entered only on our sign-in page and never reaches the AI assistant.

  • One account, yours. The server works out which ELIA Assistant account to read from your own membership, on every request. Nothing the AI assistant sends can point it at another account.
  • Read-only. All tools only read. The token given to the AI assistant is accepted only by the MCP server; our dashboard API refuses it, so it cannot be used to change settings or reply to customers.
  • Access ends with your membership. If an administrator removes or disables your user, the MCP server stops answering within 2 minutes.
  • Disconnect at any time. Remove the connector in your AI assistant's settings. To revoke an API key, click Revoke next to it in the API keys card; it stops working within 2 minutes.

Your data

The server reads the same data you see in the dashboard and sends the results to the AI assistant you connected. What that assistant does with them is covered by its provider's terms and privacy policy, for example Anthropic for Claude or OpenAI for ChatGPT.

We do not store the questions you ask or the answers the AI assistant gives. Our servers keep technical logs of requests and errors for security and troubleshooting, without message content. How we process personal data is described in our Privacy policy.

Available tools

Tool What it does
search_messages Searches messages across all channels by text, sender, channel, intent, sentiment, language, date or handover. Returns previews.
get_message Returns one message in full, including the assistant's answer and attachments.
get_messages Returns up to 20 messages in full in one call.
get_recent_messages_by_sender Returns one customer's recent conversation, by time window or message count.
list_filter_values Lists the channels, intents, sentiments and languages your messages actually use.
search_interactions Lists interactions by text, state, channel, sender, date, or only those nobody has picked up.
get_interaction Returns one interaction in full with its messages, assignment and notes.
search_customers Lists customers by name, contact, label or activity in a date range, with their labels and custom data.
get_customer Returns one customer with message count, channels, labels and custom data.
get_insights Returns the Insights figures for a period.
list_ai_agents Lists your AI agents and which one is the default.
get_knowledge_base Returns the knowledge base an AI agent answers from.

Support

Questions or problems: elia-assistant.com/contact.