Cradle API and CLI
Connecting your AI assistant to Cradle with the Cradle connector (private beta)
Let Claude, ChatGPT or another AI assistant read your Cradle calls, summaries, transcripts and reports, with nothing to install. Private beta: your organisation must be added by Cradle first.
Private beta. The Cradle connector is available only to organisations that Cradle has added to the private beta. If your organisation hasn't been added, the sign-in page will tell you. To join, ask your Cradle contact or email help@cradle.io. Features may change before general release.
What the Cradle connector does
The Cradle connector lets an AI assistant you already use, such as Claude or ChatGPT, read your Cradle calls. Once it's connected you can ask things like:
- "What did I promise on the phone today?"
- "Summarise my calls with Acme this month."
- "How many calls did the Sales team miss last week, and why?" (admins)
It can:
- List your calls for a day or date range, with who was on them and how they went.
- Read a call's AI summary, and the transcript of the parts of the conversation you were on.
- Find calls by phone number, contact, CRM contact or HubSpot record, and see which CRMs a call was logged to.
- Run your call reports, with the same numbers as the Cradle web app.
- For admins: list every call in the organisation, and run organisation, team and number reports, including who was rung and didn't answer, when calls are missed and how calls are routed.
It can't change, delete or send anything in Cradle, and it can't download recording audio.
The connector uses the Model Context Protocol (MCP), the standard most AI assistants use to connect to other services. Nothing is installed on your computer. If you'd rather give an assistant that runs on your own computer or server a command-line tool instead, see Connecting your AI assistant with the Cradle Calls CLI (/knowledge/cradle-calls-cli-private-beta). Both give the same access.
Who can see what
The connector sees exactly what you can see in Cradle, and no more:
- Everyone sees only their own call content: calls you answered or placed, and voicemails left for you. On a transferred call, you only get the parts of the conversation you were on.
- Admins can also list every call in the organisation and run organisation, team and number reports, but don't see the content of calls they weren't on.
- Call transcripts follow your organisation's transcription setting.
Each person connects their own assistant with their own Cradle sign-in. There is no way to connect an assistant on someone else's behalf.
Before you connect: common questions
Does it work with ChatGPT? Yes. ChatGPT, Claude and other assistants that support custom connectors (also called remote MCP servers) can connect. Custom connectors are usually on the assistant's paid plans, so check your plan's features.
Is it included in our Cradle plan, and are there extra fees? There's no charge for the connector, the Cradle Calls CLI or the Cradle API during the private beta, whatever your Cradle plan. Your organisation needs to be added to the beta first. Your AI assistant's own subscription is separate.
What can the assistant find?
- By date: any day or date range, up to 93 days at a time.
- By client: by phone number, contact or company name, or the client's record in a connected CRM (HubSpot, FYI, Karbon, XPM or Xero).
- By staff member: everyone can search their own calls. Admins can also list a colleague's calls and run reports on them, but can't read the summaries or transcripts of calls they weren't on.
- Call history: who was on each call, direction, time, duration, how it went, matched contacts and whether it was logged to your CRM.
- AI summaries and transcripts: for calls you answered or placed, and voicemails left for you.
- Follow-up actions: there's no separate list of actions. Ask the assistant to pick them out of a call's summary or transcript, for example "What did I promise on the phone today?"
- Recordings: the assistant can see that a call was recorded, but it can't download or play the audio. Listen to recordings in the Cradle app.
Can access be limited to each person's own calls? Yes, and it always is. Each person signs in with their own Cradle account, and the assistant only reads the content of that person's calls. See "Who can see what" above.
Does it work with our FYI integration? Yes, for calls Cradle has matched to FYI clients. The assistant can find calls with an FYI client and see whether a call was logged to FYI. It only reads what Cradle holds about your calls; it can't read or change anything in FYI itself, such as jobs or documents.
Are there limits?
- Read-only: it can't change, delete or send anything.
- Up to 93 days per search or report.
- Usage limits that pause a busy assistant for a minute.
- The connection lasts 30 days, then you sign in again.
- No recording audio.
- It can't be used while your organisation restricts CLI access to set IP addresses.
What you need
- Your organisation added to the private beta.
- Your usual Cradle sign-in (Google or Microsoft).
- An AI assistant that supports custom connectors (also called remote MCP servers). Claude and ChatGPT do on their paid plans; check your plan's features.
Connect your assistant
In your assistant, find where connectors are added. In Claude it's under Settings, then Connectors, then Add custom connector. In ChatGPT it's under Settings, then Connectors. Other assistants call it a remote MCP server or an integration.
Paste this address and give it a name such as "Cradle":
https://reporting-api.cradle.io/api/v1/mcpYour assistant opens a Cradle sign-in page. Sign in with your usual Cradle account.
Check the page: it names the assistant that's asking and what it will be able to read. Read and accept the Cradle Calls CLI Private Beta Terms, then choose Allow. If you don't recognise the assistant, choose Cancel and go back.
You're returned to your assistant. Ask it "Who am I in Cradle?" to check it's connected.
Your assistant's provider stores a key to your Cradle calls on your behalf. The key works for 30 days. When it expires, your assistant asks you to sign in again.
Keep your access safe
A connected assistant can read your call summaries and transcripts, and admins' assistants can see the whole organisation's call list and reports. Treat it like any other sign-in.
- Only connect assistants you trust with your calls. Everything you ask about is sent to that assistant's provider. Check that the provider's terms suit how your organisation handles client conversations.
- Disconnect when you stop using it. Remove the connector in your assistant, and revoke its key on the Cradle CLI access page: https://reporting-api.cradle.io/cli/access. Each connection shows there as "MCP" followed by the assistant's name, and admins can see and revoke every connection in the organisation.
- If your organisation restricts CLI access to set IP addresses, the connector can't be used while that restriction is on. Hosted assistants such as Claude and ChatGPT connect from their provider's servers, so the sign-in page refuses them and says why. An admin can clear the restriction on the CLI access page (https://reporting-api.cradle.io/cli/access), or you can use the Cradle Calls CLI from an allowed address.
- Ask for what you need. An assistant with a transcript in front of it may quote it back. Ask for summaries and answers rather than whole transcripts, and don't ask it to copy call content into other tools.
Common questions
| You want to | Ask your assistant |
|---|---|
| Today's calls | "List my Cradle calls today" |
| What was agreed on a call | "What did I agree with Alice Client on our call yesterday?" |
| Calls with one caller | "Find my calls with +64 21 000 0000 in the last month" |
| Calls not yet logged to your CRM | "Which of my calls this week aren't logged to HubSpot?" |
| Your numbers for the week | "How did my calls go this week compared with last week?" |
| Every team's answer rate (admins) | "Compare each team's answer rate over the last 7 days" |
| Why a team misses calls (admins) | "Why is the Sales team missing calls? Look at the last 30 days" |
| How a team's calls are routed (admins) | "How are calls to the Sales team routed right now?" |
Searches and reports cover up to 93 days at a time. Team and organisation questions need an admin.
Troubleshooting
- "Your organisation doesn't have the Cradle connector for AI assistants enabled yet." Your organisation hasn't been added to the beta. Contact help@cradle.io.
- "Not registered" or "return address doesn't match" on the sign-in page: remove the connector from your assistant and add it again from the address above.
- The assistant says it isn't signed in, or asks you to reconnect: the key has expired (after 30 days) or was revoked. Connect again.
- "forbidden": you've asked for something your access doesn't cover, such as a colleague's call content or an organisation report as a non-admin. The assistant can't work around this.
- "ip_not_allowed", or the sign-in page says your organisation restricts CLI access to set IP addresses: the connector can't be used while that restriction is on. An admin can clear it on the CLI access page, or you can use the Cradle Calls CLI from an allowed address.
- "rate_limited": the assistant has asked a lot in a short time. Wait a minute and try again.
Terms
Use of the connector is subject to the Cradle Calls CLI Private Beta Terms (https://reporting-api.cradle.io/cli/terms), which add to Cradle's Terms of Use, Data Processing Agreement and Privacy Policy. You're responsible for the assistant you connect and for revoking its access when you no longer need it.
Questions? Email help@cradle.io, Monday to Friday, 8:30 am to 5:00 pm New Zealand time.