MCP App Store
by KeenEthics
Ricky icon

Ricky MCP Server for Claude and ChatGPT

By Ricky AI

Overview

Ricky is the shared inbox and CRM where businesses answer customers on WhatsApp, Instagram and Messenger, with AI agents working alongside the team. Connect your Ricky organization to let Claude: - Find contacts, read their details and notes, and list contacts by stage or tag - Add notes, tag contacts and update contact details - Read and search conversations and messages - Report on conversations and response times by channel - Read business hours, locations and quick replies - Answer how-to questions from the Ricky help center You sign in with your Ricky account and choose one organization. Every request stays inside that organization and the permissions of your role, and actions that change data or message a customer ask for your confirmation first.

How to connect

  1. Claude: Open the Ricky listing in the Claude connectors directory and choose Connect. Claude listing Ricky exposes 67 tools here.
  2. ChatGPT: Open the Ricky listing in the ChatGPT app directory and choose Connect. ChatGPT listing Ricky exposes 93 tools here.

Tools

activateWorkflow

ChatGPT
Activa un workflow existente; sus acciones pueden asignar un agente IA, asignar conversaciones a una persona o enviar mensajes automáticamente.

addContactNote

ChatGPT
Appends a note to a CRM contact. Earlier notes are kept.

addConversationNote

ChatGPT
Adds an internal team note to a conversation. It sends nothing to the customer.

archiveAgent

ChatGPT
Archives an AI agent of the organization. An archived agent stops answering the conversations and channels it was assigned to.

assignConversation

ChatGPT
Assigns a conversation to a teammate, who also becomes the contact's owner in the CRM.

assignConversationAgent

ChatGPT
Assigns an AI agent to a conversation, replacing any human assignment, so the agent answers it automatically. A null agentId removes the agent and stops automatic replies. The contact's CRM owner does not change.

assignConversationAgents

ChatGPT
Assigns the same AI agent to up to 100 conversations, replacing human assignments. A null agent removes AI assignment. Returns success or error for each.

assignConversations

ChatGPT
Assigns several conversations to teammates in one call; each row names a conversation and its new owner, who also becomes the contact's owner. Returns success or the error for each conversation.

cancelBroadcast

ChatGPT
Cancels a scheduled broadcast that has not begun. It cannot recall sent messages or stop a broadcast already in progress.

createAgent

ChatGPT
Creates an AI agent with instructions and tools from the organization's catalog. It is not connected to any channel until a workflow or assignment uses it.

createContact

ChatGPT
Creates a CRM contact with personal details, company, stage, owner and custom field values.

createContactField

ChatGPT
Creates a custom CRM field (text, long text, number, date, boolean, select or multi-select). Select fields take their options.

createContactTag

ChatGPT
Creates a CRM tag with a name and color.

createKnowledgeContact

ChatGPT
Adds a contact card (name, company, role, email or phone) to the organization's shareable knowledge, which its AI agents can send to customers.

createKnowledgeLocation

ChatGPT
Adds a location (address, coordinates, hours and contact details) to the organization's shareable knowledge.

createMetaTemplate

ChatGPT
Submits a new WhatsApp message template to Meta for approval on one of the organization's WhatsApp channels.

createQuickReply

ChatGPT
Saves a new quick reply (title and text) for the team.

createWorkflow

ChatGPT
Creates a workflow as an inactive draft. Conversational workflows react to a conversation opening or a first message with steps and branches; scheduled workflows send daily WhatsApp template reminders for Odoo appointments or birthdays.

deleteContactField

ChatGPT
Deletes a custom CRM field definition and the values every contact had in it.

deleteContactTag

ChatGPT
Deletes a CRM tag and removes it from every contact.

deleteConversationNote

ChatGPT
Deletes an internal conversation note authored by the current user.

deleteKnowledgeContact

ChatGPT
Deletes a contact card from the organization's shareable knowledge.

deleteKnowledgeFile

ChatGPT
Removes a knowledge file from the organization, preserving physical media already referenced by a message.

deleteKnowledgeLocation

ChatGPT
Deletes a location from the organization's shareable knowledge.

deleteMetaTemplate

ChatGPT
Deletes a WhatsApp message template from Meta, identified by its id and name.

deleteQuickReply

ChatGPT
Deletes a quick reply.

deleteWorkflow

ChatGPT
Deletes a workflow.

draftConversationReply

ChatGPT
Proposes a reply to a customer conversation as text for the person to review, paste into the reply box or copy. Sends nothing.

editConversationNote

ChatGPT
Edits an internal conversation note authored by the current user. Other notes are preserved.

getAgent

ChatGPT
Returns an AI agent's full configuration: instructions, voice, enabled tools and handoff teammates.

getAgentConfigurationOptions

ChatGPT
Returns the voices and tools that can be enabled on AI agents in this organization. Integration tools appear only when the organization has connected that integration.

getAssistantCapabilities

ChatGPT
Returns the tools available to the signed-in person in this organization, what each is for and whether it changes data.

getBroadcast

ChatGPT
Reads one broadcast of the organization and its delivery counts.

getContact

ChatGPT
Returns a CRM contact's full record: details, notes, tags, channel identities and custom field values.

getConversation

ChatGPT
Returns a conversation and a page of up to 100 of its messages, newest first, with a cursor for older pages. Each message carries its delivery status, failure details when a send failed, and media metadata for attachments. Long messages are truncated to maxCharactersPerMessage.

getConversationMetrics

ChatGPT
Returns the number of people who wrote in, active conversations and inbound messages over the last days, with daily and per-channel series.

getConversationReport

ChatGPT
Counts every conversation and contact matching the filters, grouped by channel, current owner, CRM stage or UTC day of last activity. awaitingResponse counts conversations whose last message is inbound.

getCustomerReport

ChatGPT
Reads one of the organization's Reports pages with the figures the app shows: now (live inbox state), demand (who writes, when, on which channel), service (response and resolution times), team (workload and performance per teammate and AI agent), broadcasts, ads (Meta ad spend next to the conversations each ad brought) or appointments (Odoo agenda, when connected). The period is a preset or from/to dates in America/Panama days; each report includes the previous period. Read-only.

getGoogleAdsCampaignReport

ChatGPT
Returns Google Ads spend, impressions, clicks and conversions, daily trends, equal-length prior-period comparison, cost per click and cost per conversion, and campaign type/status for the organization’s selected advertiser accounts.

getMessageSendStatus

ChatGPT
Returns the status, attempts and error of a queued send by its dispatch id. Provider acceptance is not proof that the customer received or read the message.

getMetaAdsInsights

ChatGPT
Reads live from Meta the performance of the organization's connected ad accounts over a period: spend, impressions, reach, frequency, clicks, CTR, CPC, CPM and Meta's actions with their cost, per account, campaign, ad set or ad, optionally split by age, gender, country, region, platform, placement or device, and per day. Read-only; nothing changes in Meta.

getMetaTemplateStatus

ChatGPT
Returns a WhatsApp message template's approval status, quality rating and rejection reason from Meta.

getOrganizationKnowledge

ChatGPT
Returns the organization's shareable knowledge: locations with hours and contact details, and contact cards. It is separate from the customer CRM.

getOrganizationOverview

ChatGPT
Returns a current summary of the organization: number of contacts, AI agents, connected channels and unread conversations, plus which setup steps are still missing (connecting a channel, describing the business for its AI agent, a first test message) and the address where setup is finished.

getResponseTimeReport

ChatGPT
Returns, per channel, the average time between each inbound message and the first outbound reply after it, human or AI, over the last days. Unanswered messages are excluded from the average. It is not a resolution time.

listAgents

ChatGPT
Lists the organization's active AI agents and their visible configuration.

listBroadcastRecipients

ChatGPT
Lists broadcast recipients with individual delivery statuses and errors, with filters and pagination.

listBroadcasts

ChatGPT
Lists broadcasts with scheduling, status and delivery counts, newest first with pagination.

listChannels

ChatGPT
Lists the organization's connected messaging channels (WhatsApp, Instagram, Messenger).

listContactTags

ChatGPT
Lists the organization's CRM tags.

listContacts

ChatGPT
Lists CRM contacts filtered by owner, stage, tag, channel or text, with the exact total count, a cursor for the next page and the custom field definitions.

listConversations

ChatGPT
Lists conversations by most recent activity, optionally filtered by channel, owner, AI agent, tag, unread, unassigned, awaiting a reply or activity dates, with a cursor for the next page.

listKnowledgeFiles

ChatGPT
Lists knowledge files, extraction state and whether agents may consult or share them.

listMetaAds

ChatGPT
Lists live from Meta the ads of the organization's connected ad accounts with their campaign, ad set, status and creative copy (text, title, call to action, image). Read-only; nothing changes in Meta.

listMetaAdsAdSets

ChatGPT
Lists live from Meta the ad sets of the organization's connected ad accounts with status, optimization goal, budget in the account currency, schedule and targeting. Read-only; nothing changes in Meta.

listMetaAdsCampaigns

ChatGPT
Lists live from Meta the campaigns of the organization's connected ad accounts with objective, status, delivery status, budgets in the account currency and schedule. Read-only; nothing changes in Meta.

listMetaTemplateChannels

ChatGPT
Lists the organization's WhatsApp channels that can own a message template.

listMetaTemplates

ChatGPT
Lists the organization's WhatsApp message templates.

listOrganizationMembers

ChatGPT
Lists the teammates who can own a conversation, with their ids and roles.

listQuickReplies

ChatGPT
Lists the team's saved quick replies with their titles and text.

listRickyDocumentation

ChatGPT
Lists every article of Ricky's public help center and API documentation in Spanish or English, in site order, with its section, title, description and URL.

listWorkflowExecutions

ChatGPT
Lists a workflow's queued executions with their status, attempts and errors, newest first. An execution's status does not confirm delivery of each message it sent.

listWorkflows

ChatGPT
Lists the organization's workflows with their definitions and status.

markConversationRead

ChatGPT
Marks a conversation as read for the whole team.

pauseWorkflow

ChatGPT
Pauses a workflow so it starts no new executions. Sends already queued still go out.

readKnowledgeFile

ChatGPT
Reads previously extracted text of a knowledge file with section and character pagination. It does not generate a new extraction.

readRickyDocumentation

ChatGPT
Returns the text of an article from Ricky's public help center or API documentation, identified by its Spanish (/docs/...) or English (/en/docs/...) URL.

renameWorkflow

ChatGPT
Changes only the name of a workflow, preserving its definition, schedule and status.

reportProductProblem

ChatGPT
Files a problem report with the Ricky team: what was expected, what happened, the steps and severity, and optional conversation or message ids and technical evidence. Names, phone numbers, emails and tokens are redacted before it is stored.

resolveConversationHandoff

ChatGPT
Resolves an active human handoff, either keeping the teammate responsible or returning the conversation to its AI agent.

restartConversationContext

ChatGPT
Restarts the AI context from now while preserving the team history and current assignment.

searchContacts

ChatGPT
Searches CRM contacts by name, phone, email or company and returns their CRM data and most recent conversation.

searchConversations

ChatGPT
Searches conversations by contact, phone, teammate, last message or message text and returns their ids and summaries.

searchMessages

ChatGPT
Searches the text of every message in the organization, including text transcribed from audio and other media, and returns the matching messages with their conversations.

searchRickyDocumentation

ChatGPT
Searches Ricky's public help center and API documentation for how the product works, in Spanish, English or both, and returns matching articles with their language, link and the link to the same article in the other language.

sendConversationMessage

ChatGPT
Sends a text message to the customer in a conversation on WhatsApp, Instagram or Messenger. The channel's messaging window applies. Returns the queued send, not proof of delivery.

sendConversationTemplate

ChatGPT
Sends an approved WhatsApp message template to a conversation, with its variables and any header media, currency, date or button parameters. Returns the queued send id, not proof of delivery.

setAgentAccountGrants

ChatGPT
Replaces the connected accounts an AI agent may use. Only accounts of the active organization are accepted; an empty list revokes the selections.

setConversationLifecycle

ChatGPT
Closes or reopens a conversation. A closed conversation is marked resolved in the inbox and reopens automatically when the customer writes again.

setConversationsLifecycle

ChatGPT
Closes or reopens up to 100 explicitly selected conversations. Returns changed and unchanged IDs; future messages reopen closed conversations.

setConversationsReadState

ChatGPT
Marks up to 100 conversations read or unread for the whole team and returns success or error for each.

updateAgent

ChatGPT
Changes the given fields of an AI agent's configuration and instructions. enabled_tools and handoff_user_ids replace the whole selection.

updateContact

ChatGPT
Changes the given CRM fields of a contact: personal details, company, stage, owner and custom fields. Other fields and tags are kept; null clears a field, and notes replaces all notes.

updateContactTag

ChatGPT
Renames a CRM tag or changes its color.

updateContactsTags

ChatGPT
Adds or removes existing tags on up to 100 contacts at once. Other tags are kept; returns the result for each contact.

updateConversationTags

ChatGPT
Adds or removes existing tags on the contact of a conversation. Other tags are kept.

updateKnowledgeContact

ChatGPT
Changes the given fields of a contact card in the shareable knowledge.

updateKnowledgeFile

ChatGPT
Updates the title, description or consultation/sharing permissions of a knowledge file. Omitted fields are preserved.

updateKnowledgeLocation

ChatGPT
Changes the name, address, coordinates, hours or contact details of a location in the shareable knowledge.

updateMetaTemplate

ChatGPT
Replaces a WhatsApp message template's category and content and submits the change to Meta.

updateQuickReply

ChatGPT
Replaces a quick reply's title and text.

updateWorkflow

ChatGPT
Reemplaza nombre y definición del workflow. Lee listWorkflows antes; conserva su estado, por lo que editar uno activo afecta sus próximas ejecuciones.

validateMetaTemplateDraft

ChatGPT
Validates a WhatsApp message template draft and returns it normalized to Meta components. Nothing is created or changed.

activateWorkflow

Claude

addContactNote

Claude

archiveAgent

Claude

assignConversation

Claude

assignConversationAgent

Claude

assignConversations

Claude

createAgent

Claude

createContact

Claude

createContactField

Claude

createContactTag

Claude

createKnowledgeContact

Claude

createKnowledgeLocation

Claude

createMetaTemplate

Claude

createQuickReply

Claude

createWorkflow

Claude

deleteContactField

Claude

deleteContactTag

Claude

deleteKnowledgeContact

Claude

deleteKnowledgeLocation

Claude

deleteMetaTemplate

Claude

deleteQuickReply

Claude

deleteWorkflow

Claude

getAgent

Claude

getAgentConfigurationOptions

Claude

getAssistantCapabilities

Claude

getContact

Claude

getConversation

Claude

getConversationMetrics

Claude

getConversationReport

Claude

getMessageSendStatus

Claude

getMetaTemplateStatus

Claude

getOrganizationKnowledge

Claude

getOrganizationOverview

Claude

getResponseTimeReport

Claude

listAgents

Claude

listChannels

Claude

listContactTags

Claude

listContacts

Claude

listConversations

Claude

listMetaTemplateChannels

Claude

listMetaTemplates

Claude

listOrganizationMembers

Claude

listQuickReplies

Claude

listWorkflowExecutions

Claude

listWorkflows

Claude

markConversationRead

Claude

pauseWorkflow

Claude

readRickyDocumentation

Claude

reportProductProblem

Claude

searchContacts

Claude

searchConversations

Claude

searchMessages

Claude

searchRickyDocumentation

Claude

sendConversationMessage

Claude

sendConversationTemplate

Claude

setConversationLifecycle

Claude

updateAgent

Claude

updateContact

Claude

updateContactTag

Claude

updateContactsTags

Claude

updateConversationTags

Claude

updateKnowledgeContact

Claude

updateKnowledgeLocation

Claude

updateMetaTemplate

Claude

updateQuickReply

Claude

updateWorkflow

Claude

validateMetaTemplateDraft

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/ricky"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/ricky)