Jodie MCP

Jodie MCP overview

Jodie MCP is Jodie's own MCP server. MCP (Model Context Protocol) is an open standard that lets AI apps use tools from other services. When you connect an AI app to Jodie MCP, it can search and read the phone calls, website calls, WhatsApp conversations, emails and website chats Jodie handles for your business.

You ask in plain words, and the app looks up the answer in Jodie. For example:

  • "Which leads called this week, and what did they need?"
  • "Give me a summary of every emergency call from last month."
  • "Find the email or website chat where someone asked about prices."

Jodie MCP is read only. Your AI app can't change, delete or send anything through it, and it never changes your contacts. If you ask your AI app to draft a reply, you send it yourself.

Which plans include Jodie MCP

PlanJodie MCP
Free trialIncluded
BasicNot included. You can open the Jodie MCP page, and turning it on shows an upgrade prompt.
ProfessionalNot included. You can open the Jodie MCP page, and turning it on shows an upgrade prompt.
PremiumIncluded
EnterpriseIncluded

Jodie MCP is Jodie's first premium integration. Unlike the other integrations, it isn't included with Professional, and plans that kept integrations from before they came with Professional don't get it either.

Which AI apps work with it

Jodie MCP supports Claude, ChatGPT, Gemini and Grok. Each has a guide:

Other apps aren't supported. Jodie refuses other web apps when they try to connect. Each AI app has its own plans and admin rules for custom MCP servers; the guides list what we know.

What your AI app can do

Jodie MCP gives your AI app six tools. You don't call them yourself: the app picks the right one for your question.

ToolWhat it does
searchFinds calls, WhatsApp conversations, emails and website chats by the words used, a name, an email address or a phone number. Every keyword must match; if nothing matches them all, it returns results with any keyword. Emails also match on their subject and address, and website chats on the visitor's name and email. Narrow it by type, dates, outcome or phone. Up to 25 results. A search stops after 5 seconds and asks for dates.
list_callsLists phone and website calls for any dates, newest first, with a total so the app can count. Filter by dates, outcome, direction (calls you received, or callbacks Jodie made) or phone. Up to 50 a page.
list_whatsapp_conversationsLists WhatsApp conversations for any dates, newest first, with a total. Filter by the day a conversation started, outcome or phone. Up to 50 a page.
list_emailsLists email conversations for any dates, newest first, with each one's subject and a total. Filter by the day a conversation started or outcome. Up to 50 a page.
list_web_chatsLists the chats visitors had with Jodie on your website, newest first, with a total. Filter by the day a chat started, outcome or phone. Up to 50 a page.
fetchOpens one call, conversation, email or website chat in full. See below for what it returns.

search can look at one type or all of them: call, whatsapp, email, web_chat or all (the default). Emails have no phone number, so a search with a phone number leaves them out, and list_emails has no phone filter.

Dates and times are in your business's time zone, and every answer names the time zone.

Outcomes are how Jodie labelled each call or conversation: lead (a new enquiry), existing (an existing customer), general_enquiry, emergency, unknown, no_conversation, spam or test.

What fetch returns

One call, WhatsApp conversation, email conversation or website chat as a single document. Its id says which: call ids start with call_, WhatsApp with wac_, emails with eco_ and website chats with wcv_.

  • When it happened, which way it went, phone or website, and how long it lasted (for calls) or how many messages (for conversations and chats)
  • An email's subject
  • The outcome, the contact's name, number and email address, and the customer record's name if there is one
  • Jodie's summary
  • Every answer Jodie collected, under your own question labels
  • Your team's note
  • The full transcript, or every message (up to 1,000 lines; longer ones say they were cut). Each email's text is cut at 4,000 characters, as quoted replies make some very long
  • A link that opens it in the Jodie app

What your AI app never gets

  • Call recordings and attachments. It reads the transcript and the text, not the audio or files.
  • Internal scores, costs and label keys.
  • Calls, conversations and emails from any other business. Every request only sees the business of the person who signed in.

Once your AI app has read a call, what happens to it is covered by that app's own privacy terms. Check them before you connect.

Limits

  • Up to 60 requests a minute per person.
  • Up to 2,000 requests a day per business.

One question can use a few requests, for example a list and then a fetch for each call. Requests over the limit are refused until it resets.

A search stops after 5 seconds in total, across every type it looks at. On a busy account, ask about a date range, such as "last week", so it finishes in time.

When access is paused

If a payment is overdue, the subscription ends (including a free trial), or the plan drops below Premium, your AI app stays connected but can't read anything. Each answer from Jodie says why, with a link to fix it, and access comes back as soon as it's fixed. In the meantime, you can still open Jodie MCP in Integrations to disconnect an app or turn Jodie MCP off. See Troubleshooting.

Who can connect

Only business accounts can connect. Partner and admin logins, which can see more than one business, are refused. Anyone at your business with a Jodie login can connect their own AI app, and everyone at the business sees every connected app.

Sign-in and security

AI apps connect with OAuth, the standard sign-in that custom connectors use. There is no API key to paste or keep safe. The app sends you to Jodie, you sign in, and you approve it on a screen that shows:

  • the account it will read,
  • what the app can and can't do,
  • the site that approving returns you to.

Only approve a connection you started yourself, from the app you meant to add. If the site doesn't match that app, choose Cancel.

You can disconnect any app at any time. Turning Jodie MCP off disconnects every app straight away.

Need a hand?

Our team can help you connect Jodie to your systems.

Email [email protected]