Skip to main content
Glama

Server Details

ChatGenius tools: Instagram, Facebook, WhatsApp and SMS inbox, contacts, bookings, flows, posts.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
ChatGPT
–
Claude
ChatGenius

TDQS

B3.4/5.0

Scored across 105 tools

Disambiguation4/5

Despite 105 tools, most target a distinct resource+action (posts, flows, comment triggers, contacts, appointments, knowledge base, market intel), and descriptions explicitly differentiate near-neighbours like get_flow vs get_flow_definition, list_posts vs list_recent_posts, and cancel_appointment vs reschedule_appointment vs update_appointment. A few clusters still require careful reading (get_overview / get_account_insights / list_post_performance / get_flow_analytics; list_flow_events vs list_flow_session_events), but boundaries are stated rather than implied.

Naming Consistency5/5

Every tool follows a predictable snake_case verb_noun pattern (get_*, list_*, create_*, update_*, delete_*, bulk_*, publish_/schedule_/pause_/activate_*). Antonym pairs are symmetric (block_user/unblock_user, tag_contact/untag_contact, add_competitor/remove_competitor), so the naming is highly predictable.

Tool Count2/5

105 tools is far past the manageable range; even grouped by domain (markets intel, flows, posts, comments, appointments, knowledge, messaging), the surface is large enough to overwhelm discovery and tool selection. Each tool is individually defensible for a full social-marketing suite, but the sheer breadth argues for consolidation (e.g. generic publish/schedule actions, combined post-listing variants).

Completeness4/5

Coverage is unusually thorough: flows have full lifecycle (create/validate/publish/activate/pause/duplicate/discard-draft/delete plus analytics, sessions, events), and posts, comment triggers, appointments, contacts, tags and knowledge items all have create/read/update/delete plus stats. Minor gaps remain — no delete_contact or delete_conversation, no team-member or tag-update operations — which agents can work around.

Publisher details

Operator
SumGeniusAI LLC · Publisher source
Operator website
https://sumgenius.ai
Vendor relationship
First-party
Privacy policy
Not provided
Trust center
Not available
Restrictions
Requires a ChatGenius account (Free plan works). Tools act on the Instagram, Facebook, WhatsApp or SMS channels connected in that account. Plan limits apply. · Publisher source

Available Tools

105 tools
activate_flowA
Destructive
Inspect

Activate a flow. Sets the flow live. Publishes the draft first when there is one, exactly like the builder's toggle. Plans cap live flows (403 plan_limit_reached). Send {} as the body.

Inputs: id (required).

add_competitorAInspect

Track a competitor. Looks the handle up through Meta and starts tracking it. The account must be a public Instagram business or creator account; personal and private accounts cannot be read by anyone through the API (422 invalid_param). At the plan cap this is 403 plan_limit_reached, and an account you already track is 409 conflict. The first snapshot is taken immediately.

Inputs: username (required).

approve_comment_replyA
Destructive
Inspect

Approve a reply. Posts the pending reply publicly under the comment, as the account. Send {"text": "..."} to post an edited reply instead of the AI draft; the draft is kept and edited becomes true. Only a pending comment can be approved (409 not_pending). A successful send counts against the plan's reply cap. Send Content-Type: application/json with an empty object when not editing; the server refuses a bodiless POST.

Inputs: id (required), text.

assign_conversationAInspect

Assign or unassign a conversation. Body {"assigned_to": } to assign, {"assigned_to": null} to unassign. Moves pending or escalated to active and adds a system line to the transcript, exactly like the inbox.

Inputs: id (required), assigned_to (required).

block_userAInspect

Block a user. Send exactly one of ig_username (blocks by Instagram handle, even before they have messaged) or conversation_id (blocks the person behind an existing conversation on any Meta channel).

Inputs: ig_username, conversation_id.

book_appointmentA
Destructive
Inspect

Book an appointment. Books a slot the way the portal calendar does: the account's required customer fields are enforced (422 missing_fields), the time must be in the future (400 invalid_param) and free (409 slot_unavailable), the appointment is confirmed at once, synced to Google Calendar and GoHighLevel when connected, and appointment.booked fires. Business hours are not checked here: call availability first to offer open times. Attach conversation_id to link the booking to a person you are chatting with; no message is sent to them. date and time are the customer's wall-clock time in timezone (the account timezone when omitted).

Inputs: date (required), time (required), customer (required), cost, +8 more.

bulk_approve_comment_repliesA
Destructive
Inspect

Bulk approve replies. Sends the AI draft for each pending id, in order. Ids that are not pending or fail to send are counted in failed with a reason each. Up to 100 per call. Each approved reply is posted publicly under the comment. Confirm with the user.

Inputs: ids (required).

bulk_reject_comment_repliesA
Destructive
Inspect

Bulk reject replies. Drops the pending draft for each id. Ids that are not pending are ignored; rejected says how many changed.

Inputs: ids (required).

cancel_appointmentA
Destructive
Inspect

Cancel an appointment. Sets status cancelled, removes the Google Calendar and GoHighLevel events of a booking made in ChatGenius (an event imported from the owner's own calendar is left alone), fires appointment.cancelled. 409 already_cancelled if it already is. Send {} as the body.

Inputs: id (required).

create_comment_triggerA
Destructive
Inspect

Create a comment trigger. Creates a trigger. It goes live at once unless the plan's live-trigger cap is reached, in which case it is saved paused and created_paused is true (never refused). Buttons are optional, up to three. A reply button is still worth adding: its tap opens the conversation so follow-ups can be sent. Story and Live triggers are Instagram only and never post-scoped. Send draft: true to save an incomplete trigger paused, skipping the template and button requirements. It goes live at once and starts DMing real commenters. Confirm with the user first, or send draft: true to save it paused. A paused trigger stays paused through edits until you send active: true.

Inputs: name (required), keywords (required), draft, tag_id, +15 more.

create_custom_fieldAInspect

Create a custom field. field_key is permanent after creation. Up to 15 active fields.

Inputs: type (required), label (required), field_key (required).

create_faqBInspect

Create an FAQ. Counts against the plan cap. The answer is embedded for retrieval right away; embedding_pending is true if indexing is still catching up.

Inputs: answer (required), question (required), active, keywords, +1 more.

create_flowAInspect

Create a flow. Creates a DRAFT from a definition (see GET /flows/nodes for the catalogue). The definition is validated first: structure, per-node config, the plan's node cap, channel compatibility with the trigger source, keyword collisions with active flows, and references to custom fields, comment triggers and other flows (422 invalid_definition with errors[] and warnings[]). Nothing runs until you publish and activate. The visual builder lays the nodes out the first time the flow is opened.

Inputs: name (required), definition (required), tag_id, channels.

create_postAInspect

Create a post. Creates a draft, or a scheduled post when scheduled_at is set (ISO-8601 with offset; a bare local time is read in the account timezone). Upload media afterwards with POST /posts/{id}/media, then publish or schedule. Rules: TikTok-only posts cannot be a carousel or story and carry no first comment or comment auto-reply; scheduling needs a caption (stories excepted) and a future time; the plan's monthly cap counts scheduled and published posts, a plain draft never holds a slot; a comment auto-reply on a scheduled post needs a free live comment-trigger slot (403 plan_limit_reached). tiktok.privacy_level must be one of the creator's options from GET /posts/capabilities.

Inputs: tiktok, caption, hashtags, platform, +6 more.

create_serviceBInspect

Create a service. Counts against the plan cap. is_virtual is honoured only when Google Calendar is connected and Meet links are on; otherwise it is stored as false. Images are added in the portal.

Inputs: name (required), price, active, currency, +6 more.

create_tagBInspect

Create a tag. Idempotent on name: 201 when created, 200 when it already existed (colour unchanged).

Inputs: name (required), color.

delete_comment_triggerA
DestructiveIdempotent
Inspect

Delete a comment trigger. Soft delete: the trigger stops firing and disappears from lists, its stats are kept, and any linked flows are detached and paused (detached_flows says how many).

Inputs: id (required).

delete_documentB
DestructiveIdempotent
Inspect

Delete a document. Removes the document and its embeddings.

Inputs: id (required).

delete_faqA
DestructiveIdempotent
Inspect

Delete an FAQ. Removes the FAQ and its embeddings.

Inputs: id (required).

delete_flowA
DestructiveIdempotent
Inspect

Delete a flow. Deletes the flow, its versions, sessions and media. A linked comment trigger is detached and paused. Permanent: the flow, its versions, sessions and analytics are gone. Confirm with the user, and prefer pause_flow.

Inputs: id (required).

delete_postA
DestructiveIdempotent
Inspect

Delete a post. Removes the post and its media files. Published posts cannot be deleted (409 not_editable); the live post stays on the platform.

Inputs: id (required).

delete_serviceA
DestructiveIdempotent
Inspect

Delete a service. Removes the service, its embeddings and its image file.

Inputs: id (required).

delete_tagA
DestructiveIdempotent
Inspect

Delete a tag. Removes the definition and detaches it from every contact and conversation.

Inputs: id (required).

discard_flow_draftA
Destructive
Inspect

Discard a flow draft. Throws away the unpublished draft; the live version stands. Send {} as the body.

Inputs: id (required).

duplicate_comment_triggerAInspect

Duplicate a comment trigger. Copies every setting into a new trigger named "(Copy)", paused, with fresh stats. Activate it with PATCH active: true. Send Content-Type: application/json with an empty object body; the server refuses a bodiless POST.

Inputs: id (required).

duplicate_flowBInspect

Duplicate a flow. Copies the flow as a new draft. Send {} as the body.

Inputs: id (required).

get_accountA
Read-onlyIdempotent
Inspect

Get the account. Call this first. Identity, plan, the calling key and its scope, and the configured webhook endpoints. When no Instagram, Facebook or WhatsApp account is connected, setup.channels_connected is false and setup.connect_url is where the owner connects one; until then the inbox, contact, comment and post tools return nothing.

Inputs: no named parameters.

get_account_insightsA
Read-onlyIdempotent
Inspect

Get account insights. Reach, profile views, interactions, saves, shares and follows for your own account over the last 1, 7 or 30 days. This one calls Instagram live, so it takes a moment and counts against Meta's rate limit. 403 permission_required when the account was connected without the insights permission; reconnect it in the portal to fix that.

Inputs: days.

get_ai_channelsA
Read-onlyIdempotent
Inspect

Get the per-channel AI switches. For meta (Facebook + Instagram share one switch), sms, whatsapp and telegram: whether the channel is connected, whether the AI answers on it, and whether automations run on it.

Inputs: no named parameters.

get_ai_configB
Read-onlyIdempotent
Inspect

Get the AI configuration. All nine sections in one call. available on file_handling, followups, csat and comment_ai says whether the plan includes that feature.

Inputs: no named parameters.

get_appointmentC
Read-onlyIdempotent
Inspect

Get an appointment. One appointment by id.

Inputs: id (required).

get_audience_demographicsA
Read-onlyIdempotent
Inspect

Get audience demographics. The latest stored breakdown of your followers: gender and age as percentages, top countries and cities with counts, and followers online by hour when Instagram supplies it. 404 until the first refresh. Instagram withholds all of it for accounts under roughly 100 followers, which comes back as zeros rather than an error. Includes followers online by hour, which is what "when should I post" is answered from.

Inputs: no named parameters.

get_availabilityA
Read-onlyIdempotent
Inspect

Get availability. The open slots for one day, from business hours, the service duration, the buffer, the minimum notice and existing bookings. What the bot and the portal picker offer. Empty on a closed day.

Inputs: date (required), city, state, service_type.

get_comment_manager_statsB
Read-onlyIdempotent
Inspect

Get comment manager stats. How many replies are waiting for approval, and today's and this month's handled, replied and moderated counts against the plan's caps.

Inputs: no named parameters.

get_comment_triggerB
Read-onlyIdempotent
Inspect

Get a comment trigger. One trigger by id with its linked flows.

Inputs: id (required).

get_comment_trigger_statsA
Read-onlyIdempotent
Inspect

Get comment trigger stats. Lifetime counters for one trigger: fires, public replies, DMs (and how many were AI-written), link clicks, unique people, split by channel.

Inputs: id (required).

get_competitorA
Read-onlyIdempotent
Inspect

Compare against one competitor. That competitor and your own account side by side, with the per-metric differences the portal shows. Stored snapshots, no Meta call.

Inputs: id (required).

get_competitor_leaderboardA
Read-onlyIdempotent
Inspect

Get the leaderboard. Your account and every competitor ranked together: followers, engagement rate, posts per week, average likes and comments, follower growth per day and the content mix (reels, photos, carousels). This is the table behind the portal's Market Intel page. Stored snapshots, so it is instant and spends no Meta quota. Your account and every competitor ranked together. Start here for any "how do I compare" question.

Inputs: period.

get_contactC
Read-onlyIdempotent
Inspect

Get a contact. One contact by id.

Inputs: id (required).

get_conversationC
Read-onlyIdempotent
Inspect

Get a conversation. One conversation by id.

Inputs: id (required).

get_documentA
Read-onlyIdempotent
Inspect

Get a document. One document by id, metadata only.

Inputs: id (required).

get_faqC
Read-onlyIdempotent
Inspect

Get an FAQ. One FAQ by id.

Inputs: id (required).

get_flowB
Read-onlyIdempotent
Inspect

Get a flow. One flow by id.

Inputs: id (required).

get_flow_analyticsA
Read-onlyIdempotent
Inspect

Get flow analytics. The builder's Analytics panel for one flow: runs, completions, completion rate and median time for the window, the same numbers for the preceding window (comparison), lifetime totals, outcomes (emails and phones collected, leads marked, bookings, link clicks, handoffs), per-node reach, continue, response and loss rates, and per-port branch splits. Analytics are per published version: version defaults to the current one; versions lists the others. Only sessions with tracking are counted; other_version_runs_excluded says how many ran under another version in the window.

Inputs: id (required), range, channel, version.

get_flow_definitionA
Read-onlyIdempotent
Inspect

Get a flow definition. The definition alone: the draft when one exists, else the published version.

Inputs: id (required).

get_flow_node_catalogueA
Read-onlyIdempotent
Inspect

Get the node catalogue. Everything needed to build a flow: every trigger source (channels it can fire on, whether it needs keywords, its config), every node type (input and output ports, config fields and allowed values, which are terminal), the enums, the placeholders, the structural rules, and this account's live options: custom fields, tags, bookable services, flows (for goto_flow), comment triggers (for linked comment flows), the plan's node and flow caps. Read it before composing a definition. Read this before writing a flow definition. It lists every node type, its config fields and output ports.

Inputs: no named parameters.

get_flow_sessionC
Read-onlyIdempotent
Inspect

Get a flow session. One session by id.

Inputs: id (required).

get_follower_historyA
Read-onlyIdempotent
Inspect

Get follower history. Follower count and engagement rate over the window, one series per account including your own, oldest point first. One point per day that a snapshot was taken, so gaps mean nobody refreshed that day.

Inputs: period.

get_handled_commentB
Read-onlyIdempotent
Inspect

Get a handled comment. One log row by id.

Inputs: id (required).

get_knowledge_usageA
Read-onlyIdempotent
Inspect

Get knowledge base usage. How many items exist against the plan cap, broken down by FAQs, services and documents, plus document storage. Check can_add before creating.

Inputs: no named parameters.

get_overviewA
Read-onlyIdempotent
Inspect

Get the account overview. The numbers behind the portal's Overview page, computed by the same data layer: a rolling window against the same length of time before it (current/previous pairs). Messages per channel, AI vs automation replies, flow entries (with an attached comment trigger's fires on the flow's own row so a comment is never counted twice), standalone comment trigger fires, contacts, appointments with the next few, knowledge gaps by status, what needs a human, API sends, and plan usage for the billing cycle. Usage is always the billing cycle, whatever the range.

Inputs: range.

get_postA
Read-onlyIdempotent
Inspect

Get a post. One post with its media, published ids and any error.

Inputs: id (required).

get_posting_capabilitiesA
Read-onlyIdempotent
Inspect

Get posting capabilities. What to read before building a post: which targets are connected, the TikTok creator's allowed privacy levels and video limit (live from TikTok, with a safe fallback), the post types, and the plan's monthly post cap and storage cap with current usage.

Inputs: no named parameters.

get_serviceC
Read-onlyIdempotent
Inspect

Get a service. One service by id.

Inputs: id (required).

get_wins_and_opportunitiesA
Read-onlyIdempotent
Inspect

Get wins and opportunities. The comparisons already computed against each competitor over the last 30 days: where you are ahead (wins) and where they are (opportunities), each with the metric and the size of the gap. Derived from stored snapshots, no AI involved.

Inputs: no named parameters.

list_appointmentsB
Read-onlyIdempotent
Inspect

List appointments. In-chat bookings, newest first.

Inputs: limit, status, starting_after, conversation_id.

list_blocked_usersA
Read-onlyIdempotent
Inspect

List blocked users. Everyone the AI is currently refusing to answer. Not paginated.

Inputs: no named parameters.

list_comment_triggersA
Read-onlyIdempotent
Inspect

List comment triggers. Standalone comment triggers, newest first, each with the flows linked to it. A flow whose own trigger node carries keywords (native) is not a trigger and appears only on /flows as a comment source with mode native.

Inputs: limit, active, post_id, platform, +2 more.

list_competitorsA
Read-onlyIdempotent
Inspect

List tracked competitors. Every account you track, with the numbers from its latest stored snapshot, plus how many slots your plan allows. Free 1, Creator 3, Pro 5, Business 10. Whole set in one page. last_snapshot_date is null until the first refresh.

Inputs: no named parameters.

list_contactsA
Read-onlyIdempotent
Inspect

List contacts. Cursor-paginated, newest first. Filters combine with AND.

Inputs: tag, name, email, limit, +5 more.

list_conversationsA
Read-onlyIdempotent
Inspect

List conversations. Cursor-paginated, newest first. Deleted conversations are never returned.

Inputs: limit, status, channel, assigned_to, +2 more.

list_custom_fieldsB
Read-onlyIdempotent
Inspect

List custom field definitions. Active fields by default.

Inputs: include_archived.

list_documentsA
Read-onlyIdempotent
Inspect

List documents. Uploaded PDFs and text files. Content is not returned, only metadata and embedding state. Upload happens in the portal.

Inputs: limit, starting_after, include_inactive.

list_faqsA
Read-onlyIdempotent
Inspect

List FAQs. Question and answer pairs the AI answers from. Active only by default.

Inputs: limit, starting_after, include_inactive.

list_flow_eventsA
Read-onlyIdempotent
Inspect

List flow events across sessions. Every session event in one feed, oldest first. Ids only increase, so starting_after is a durable high-water mark for a sync loop. Use flow_session, not session_id, to filter by session.

Inputs: type, limit, since, flow_id, +3 more.

list_flowsA
Read-onlyIdempotent
Inspect

List flows. Automation flows with lifetime stats. The canvas definition is not exposed.

Inputs: limit, status, trigger_type, starting_after.

list_flow_session_eventsB
Read-onlyIdempotent
Inspect

List events for a session. The ordered path one person took through a flow, oldest first.

Inputs: id (required), type, limit, starting_after.

list_flow_sessionsA
Read-onlyIdempotent
Inspect

List flow sessions. One session per person per run of a flow. Attribution carries post_id, comment_id and matched_keyword only, never what anyone typed.

Inputs: limit, status, channel, flow_id, +3 more.

list_handled_commentsA
Read-onlyIdempotent
Inspect

List handled comments. Comments the AI Comment Manager handled, newest first, kept 30 days. Each carries the comment, its sentiment, what moderation did, the AI draft, and what happened to the reply. status=pending is the approval queue.

Inputs: limit, since, status, channel, +2 more.

list_knowledge_gapsA
Read-onlyIdempotent
Inspect

List knowledge gaps. Questions the AI could not answer well, flagged by the gap detector with the customer message, the AI reply, a canonical form of the question, and a suggested answer and target. Open gaps by default; status=all for everything. Read-only: fix a gap with POST /knowledge/faqs or by editing identity.instructions, and dismiss it in the portal.

Inputs: limit, since, status, channel, +2 more.

list_messagesA
Read-onlyIdempotent
Inspect

List messages in a conversation. The transcript, newest first. Purged bodies appear with text null and body_purged true.

Inputs: id (required), limit, starting_after.

list_opt_outsB
Read-onlyIdempotent
Inspect

List opt-outs. Who has opted out, on which channel, when, and how. starting_after is an opaque cursor here, not an id.

Inputs: limit, scope, since, status, +2 more.

list_post_performanceA
Read-onlyIdempotent
Inspect

List post performance. Your own recent posts with their stored performance: reach, impressions, likes, comments, saves, shares, video views, engagement rate and save rate. Newest first. Stored, so refresh first for current numbers.

Inputs: limit.

list_postsA
Read-onlyIdempotent
Inspect

List posts. Content Studio posts, newest first, each with its media. status=scheduled is the queue, status=failed needs attention.

Inputs: limit, status, platform, post_type, +1 more.

list_recent_postsA
Read-onlyIdempotent
Inspect

List recent posts. Recent posts and Reels on the connected Instagram or Facebook account, newest first, straight from Meta. Use an id as post_id when creating a trigger scoped to one post. 409 not_connected when that channel is not connected.

Inputs: limit, platform, starting_after.

list_servicesA
Read-onlyIdempotent
Inspect

List services. Services and pricing the AI can quote and, with booking on, offer. Active only by default.

Inputs: limit, starting_after, include_inactive.

list_tagsA
Read-onlyIdempotent
Inspect

List tags. Every tag definition, ordered by name. Not paginated.

Inputs: no named parameters.

list_team_membersA
Read-onlyIdempotent
Inspect

List team members. Everyone a conversation can be assigned to. Not paginated. channels is null when the member can see every channel. Use it to find the member id for assign_conversation.

Inputs: no named parameters.

pause_flowA
Destructive
Inspect

Pause a flow. Stops the flow and cancels its open sessions. A linked comment trigger is paused with it. Fires flow.paused. Send {} as the body.

Inputs: id (required).

publish_flowA
Destructive
Inspect

Publish a flow draft. Makes the draft the live definition (new version). Runs the full validation and keyword-conflict check (422 invalid_definition). Publishing a flow that was never live also activates it when the plan has a free live-flow slot (403 plan_limit_reached otherwise). Fires flow.published, and flow.activated when it went live. Send {} as the body.

Inputs: id (required).

publish_postA
Destructive
Inspect

Publish a post now. Publishes to every target at once, the portal's Publish Now. Needs a caption (stories excepted), media for any Instagram target, and two or more items for a carousel (400). A draft, scheduled or failed post can be published (409 not_editable otherwise). When a platform rejects it the post becomes failed and the call is 422 publish_failed with the post and per-platform results. post.published or post.failed fires either way. Send {} as the body.

Inputs: id (required).

refresh_market_intelAInspect

Refresh from Meta. Pulls current numbers from Meta for your account and every tracked competitor and writes today's snapshot, exactly like the portal's Refresh button. One Meta call per account, so it takes several seconds; every other Market Intel read serves the snapshots this writes. Five minutes are enforced between refreshes (429 too_soon carries retry_after_seconds). Send {} as the body. Slow: one Meta call per tracked account. Only call it when the stored snapshot is stale.

Inputs: no named parameters.

reject_comment_replyA
Destructive
Inspect

Reject a reply. Drops the pending draft. Nothing is posted. Only a pending comment can be rejected (409 not_pending). Send an empty JSON object as the body.

Inputs: id (required).

remove_competitorA
Idempotent
Inspect

Stop tracking a competitor. Frees the slot. History is kept, so re-adding the same handle picks up where it left off.

Inputs: id (required).

reschedule_appointmentA
Destructive
Inspect

Reschedule an appointment. Moves a pending or confirmed appointment to a new date and time after checking the slot is free (its own current slot does not count as taken), updates the connected calendars, and fires appointment.rescheduled. The customer is not messaged. A booking with no conversation must also fall inside business hours. 400 invalid_param for a time in the past, 404 not_found for an unknown id, 409 slot_unavailable when the slot is taken or outside business hours, 409 not_active when the appointment is not pending or confirmed.

Inputs: id (required), date (required), time (required).

retry_postB
Destructive
Inspect

Retry a failed post. Publishes a failed post again, up to the retry cap. Send {} as the body.

Inputs: id (required).

schedule_postA
Destructive
Inspect

Schedule a post. Sets or moves the publish time of a draft, failed or scheduled post. The scheduler publishes it within a minute of that time. Same rules as scheduling on create. post.scheduled fires.

Inputs: id (required), scheduled_at (required).

send_messageA
Destructive
Inspect

Send a message. Send text, a WhatsApp template, a reaction, or a typing indicator on any channel. Route by conversation_id, by platform plus platform_user_id, or by to_phone for SMS and WhatsApp. SMS, WhatsApp and Telegram can start a conversation cold; Facebook and Instagram need an inbound message first. idempotency_key is required in the body, or send the Idempotency-Key header. This reaches a real person on their phone. Confirm the recipient and the text with the user before calling.

Inputs: action, platform, reaction, to_phone, +8 more.

simulate_commentA
Read-onlyIdempotent
Inspect

Simulate a comment. Dry run: what would happen if this text were commented on this channel and post. Runs the live matcher over every trigger in id order and reports the first that fires, the reason each other one did not, the linked flow that would start, or the native flow that would answer if no trigger fires. Nothing is sent and nothing is recorded. Per-person rules (opt-out, blocklist, once-per-user) are not simulated. Dry run, nothing is sent. Use it to check a trigger matches before and after changing it.

Inputs: text (required), platform (required), post_id, source_type.

tag_contactBInspect

Attach a tag. Attach by name. The tag is created if it does not exist. Re-attaching is a no-op.

Inputs: id (required), name (required).

unblock_userA
Idempotent
Inspect

Unblock a user. The AI answers their next message. The block row is kept for audit, so the id is not reusable.

Inputs: id (required).

unschedule_postBInspect

Unschedule a post. Turns a scheduled post back into a draft. Send {} as the body.

Inputs: id (required).

untag_contactA
Idempotent
Inspect

Detach a tag. Detach by tag id or URL-encoded name. Detaching a tag the contact does not have is a 200.

Inputs: id (required), tag (required).

update_appointmentA
Destructive
Inspect

Update an appointment. Edit details and/or status, the portal's edit form. Send only what changes. Detail edits are pushed to the connected calendars; a status change to cancelled removes the calendar event and fires appointment.cancelled. Events imported from the owner's own Google Calendar are changed in ChatGenius only. To move the time use reschedule, which checks the slot. Edits are pushed to the connected calendar, and a status of cancelled removes the event. To move the time, use reschedule_appointment.

Inputs: id (required), cost, notes, status, +6 more.

update_comment_triggerA
Destructive
Inspect

Update a comment trigger. Send only what should change; the rest is kept and the whole trigger is re-validated. active: true activates (refused with plan_limit_reached at the live cap, or flow_conflict if the linked flows are not ready); active: false pauses and pauses the linked flows. Changing button titles or types on a trigger with linked flows pauses those flows and the trigger for branch review; the response carries flow_impact. Edits a trigger that may be live. The whole trigger is re-validated, so a draft needs its DM text and a button before any edit saves. It never switches a trigger on unless you send active: true; confirm with the user before you do.

Inputs: id (required), name, active, tag_id, +16 more.

update_contactA
Destructive
Inspect

Update a contact. Partial update. Only the fields you send change. An empty string clears name, email, phone or notes. custom_fields merges per key; null clears one value.

Inputs: id (required), name, email, notes, +3 more.

update_conversationAInspect

Update a conversation. Two optional fields. status: active, resolved or archived; resolving or archiving hands the thread back to the AI, like the inbox. ai_paused: true takes the thread away from the AI as the account owner (the inbox Claim button, reopens a resolved thread); false hands it back (the inbox Transfer to AI). Resume is refused with 409 when the pause came from a solicitation pause, a fraud flag or a connected-account pause; those are lifted in the portal. status is applied first, then ai_paused.

Inputs: id (required), status, ai_paused.

update_custom_fieldAInspect

Rename or archive a custom field. Change the label, or archive and unarchive. Archived fields keep their values but stop appearing on contacts.

Inputs: id (required), label, archived.

update_documentBInspect

Rename or toggle a document. Change the name or switch it off without deleting it.

Inputs: id (required), name, active.

update_faqA
Destructive
Inspect

Update an FAQ. Partial update. Changing question, answer or keywords re-embeds it; changing only active does not.

Inputs: id (required), active, answer, keywords, +2 more.

update_flowA
Destructive
Inspect

Update a flow. Rename, retarget channels, set the tag, and/or replace the definition. A new definition is saved as the DRAFT and validated the same way as on create; the live version keeps running until you publish. Positions are dropped when the definition changes (the builder re-lays it out).

Inputs: id (required), name, tag_id, channels, +1 more.

update_postA
Destructive
Inspect

Update a post. Edit a draft, scheduled or failed post (409 not_editable otherwise). Send only what changes; tiktok merges field by field; other arrays and objects replace. scheduled_at set moves or schedules it (post.scheduled fires); scheduled_at null turns a scheduled post back into a draft.

Inputs: id (required), tiktok, caption, hashtags, +7 more.

update_serviceA
Destructive
Inspect

Update a service. Partial update. Any content change re-embeds; changing only active does not. The service image is never touched by the API.

Inputs: id (required), name, price, active, +7 more.

upsert_contactA
Destructive
Inspect

Create or update a contact. Upsert keyed by (channel, platform_user_id). 201 when created, 200 when an existing contact was updated. Fields you omit on an existing contact are left untouched, tags included.

Inputs: channel (required), platform_user_id (required), name, tags, +5 more.

validate_flowA
Read-only
Inspect

Validate a flow definition. Dry run of the same validation create and update apply. Nothing is saved. Validate a definition without saving it. Loop on errors[] until it is clean, then call create_flow.

Inputs: definition (required), channels.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP clients like Claude and Cursor to read and act on Instagram, Facebook, WhatsApp and SMS inboxes, contacts, appointments, flows, comment automation, Content Studio posts, market intel and a knowledge base through the ChatGenius REST API. Exposes 105 scope-capped tools, with destructive actions marked for client approval and idempotency keys guarding every write.
      105
      206 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      WhatsApp, Instagram, Telegram, SMS, Messenger & email in one AI-ready inbox. Manage conversations, send omnichannel messages, run campaigns, sync contacts, and query your knowledge base — 42 tools over a hosted, OAuth-secured MCP server.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI assistants to a business messaging and CRM workspace, enabling management of Instagram, WhatsApp and Telegram inboxes, AI replies and knowledge, workflows, bookings, link-in-bio pages, scheduled publishing and Instagram insights.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading and replying to direct messages, comments, and templates across Instagram, WhatsApp, and Messenger through official Meta Business APIs, with support for human handover and AI assistant controls.
      49 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources