chatgenius-mcp 0.1.7 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -9
- package/package.json +2 -2
- package/server.json +2 -2
- package/src/tools.js +53 -0
- package/tools.json +3642 -1528
package/README.md
CHANGED
|
@@ -43,19 +43,20 @@ claude plugin install chatgenius@sumgenius
|
|
|
43
43
|
|
|
44
44
|
## What it can do
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
105 tools in ten groups. Read tools are safe to run freely. Write tools create or edit records. Destructive tools reach a real person, publish content or change what runs live, and are marked so the client asks you first.
|
|
47
47
|
|
|
48
48
|
| Group | Tools |
|
|
49
49
|
|---|---|
|
|
50
50
|
| Account | `get_account`, `get_overview` |
|
|
51
|
-
| Contacts | `list_contacts`, `get_contact`, `upsert_contact`, `update_contact`, `list_tags`, `create_tag`, `tag_contact`, `untag_contact` |
|
|
52
|
-
| Inbox | `list_conversations`, `get_conversation`, `list_messages`, `update_conversation`, `send_message` |
|
|
53
|
-
| Appointments | `list_appointments`, `get_availability`, `book_appointment`, `reschedule_appointment`, `cancel_appointment` |
|
|
54
|
-
| Flows | `list_flows`, `get_flow`, `get_flow_definition`, `get_flow_node_catalogue`, `validate_flow`, `create_flow`, `update_flow`, `publish_flow`, `activate_flow`, `pause_flow`, `get_flow_analytics`, `list_flow_sessions` |
|
|
55
|
-
| Comments | `list_comment_triggers`, `get_comment_trigger_stats`, `list_recent_posts`, `list_handled_comments`, `approve_comment_reply`, `reject_comment_reply` |
|
|
56
|
-
| Content Studio | `list_posts`, `get_post`, `get_posting_capabilities`, `create_post`, `update_post`, `schedule_post`, `publish_post` |
|
|
51
|
+
| Contacts | `list_contacts`, `get_contact`, `upsert_contact`, `update_contact`, `list_tags`, `create_tag`, `tag_contact`, `untag_contact`, `delete_tag`, `list_custom_fields`, `create_custom_field`, `update_custom_field` |
|
|
52
|
+
| Inbox | `list_conversations`, `get_conversation`, `list_messages`, `update_conversation`, `send_message`, `assign_conversation`, `list_team_members`, `list_blocked_users`, `block_user`, `unblock_user`, `list_opt_outs` |
|
|
53
|
+
| Appointments | `list_appointments`, `get_availability`, `get_appointment`, `update_appointment`, `book_appointment`, `reschedule_appointment`, `cancel_appointment` |
|
|
54
|
+
| Flows | `list_flows`, `get_flow`, `get_flow_definition`, `get_flow_node_catalogue`, `validate_flow`, `create_flow`, `update_flow`, `publish_flow`, `activate_flow`, `pause_flow`, `duplicate_flow`, `discard_flow_draft`, `delete_flow`, `get_flow_analytics`, `list_flow_sessions`, `get_flow_session`, `list_flow_session_events`, `list_flow_events` |
|
|
55
|
+
| Comments | `list_comment_triggers`, `get_comment_trigger`, `simulate_comment`, `create_comment_trigger`, `update_comment_trigger`, `duplicate_comment_trigger`, `delete_comment_trigger`, `get_comment_trigger_stats`, `list_recent_posts`, `list_handled_comments`, `get_handled_comment`, `get_comment_manager_stats`, `approve_comment_reply`, `reject_comment_reply`, `bulk_approve_comment_replies`, `bulk_reject_comment_replies` |
|
|
56
|
+
| Content Studio | `list_posts`, `get_post`, `get_posting_capabilities`, `create_post`, `update_post`, `schedule_post`, `publish_post`, `unschedule_post`, `retry_post`, `delete_post` |
|
|
57
57
|
| Market Intel | `list_competitors`, `get_competitor`, `get_competitor_leaderboard`, `get_follower_history`, `get_wins_and_opportunities`, `get_audience_demographics`, `get_top_posts`, `get_account_insights`, `add_competitor`, `remove_competitor`, `refresh_market_intel` |
|
|
58
|
-
| Knowledge base | `list_faqs`, `create_faq`, `update_faq`, `list_services`, `list_knowledge_gaps` |
|
|
58
|
+
| Knowledge base | `list_faqs`, `create_faq`, `update_faq`, `list_services`, `list_knowledge_gaps`, `get_knowledge_usage`, `get_faq`, `delete_faq`, `get_service`, `create_service`, `update_service`, `delete_service`, `list_documents`, `get_document`, `update_document`, `delete_document` |
|
|
59
|
+
| AI settings | `get_ai_config`, `get_ai_channels` |
|
|
59
60
|
|
|
60
61
|
Things to try:
|
|
61
62
|
|
|
@@ -72,7 +73,7 @@ Building a flow works the way a developer would do it: the assistant reads the n
|
|
|
72
73
|
- Every write carries an `Idempotency-Key`, so a retried tool call cannot double-send.
|
|
73
74
|
- The API enforces the key's scope server-side. `CHATGENIUS_MAX_SCOPE` is a second, local cap.
|
|
74
75
|
- Message and comment text in results was written by your customers. The server tells the model to treat it as data, not instructions. Keep destructive tools behind your client's approval prompt.
|
|
75
|
-
- Team, webhook endpoint and API key management are not exposed. Use the portal.
|
|
76
|
+
- Team, webhook endpoint and API key management, and switching the AI on or off, are not exposed. Use the portal.
|
|
76
77
|
|
|
77
78
|
## Development
|
|
78
79
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chatgenius-mcp",
|
|
3
|
-
"version": "0.1
|
|
4
|
-
"description": "MCP server for ChatGenius: give Claude, Cursor, Gemini CLI or any MCP client tools over your Instagram, Facebook, WhatsApp and SMS inbox, contacts, appointments, flows, posts and knowledge base.",
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "MCP server for ChatGenius: give Claude, Cursor, Gemini CLI or any MCP client tools over your Instagram, Facebook, WhatsApp and SMS inbox, contacts, appointments, flows, posts and knowledge base. mcprush.com-claim-chatgenius-mcp-9c350531077363b4ce7537cb",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
package/server.json
CHANGED
|
@@ -3,13 +3,13 @@
|
|
|
3
3
|
"name": "io.github.SumCodeAI/chatgenius",
|
|
4
4
|
"description": "ChatGenius tools: Instagram, Facebook, WhatsApp and SMS inbox, contacts, bookings, flows, posts.",
|
|
5
5
|
"websiteUrl": "https://sumgenius.ai/docs/mcp",
|
|
6
|
-
"version": "0.1
|
|
6
|
+
"version": "0.2.1",
|
|
7
7
|
"packages": [
|
|
8
8
|
{
|
|
9
9
|
"registryType": "npm",
|
|
10
10
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
11
11
|
"identifier": "chatgenius-mcp",
|
|
12
|
-
"version": "0.1
|
|
12
|
+
"version": "0.2.1",
|
|
13
13
|
"runtimeHint": "npx",
|
|
14
14
|
"transport": {
|
|
15
15
|
"type": "stdio"
|
package/src/tools.js
CHANGED
|
@@ -22,6 +22,10 @@ export const TOOLS = [
|
|
|
22
22
|
{ name: 'create_tag', op: 'create_a_tag', kind: 'write' },
|
|
23
23
|
{ name: 'tag_contact', op: 'attach_a_tag', kind: 'write' },
|
|
24
24
|
{ name: 'untag_contact', op: 'detach_a_tag', kind: 'write' },
|
|
25
|
+
{ name: 'delete_tag', op: 'delete_a_tag', kind: 'destructive' },
|
|
26
|
+
{ name: 'list_custom_fields', op: 'list_custom_field_definitions', kind: 'read' },
|
|
27
|
+
{ name: 'create_custom_field', op: 'create_a_custom_field', kind: 'write' },
|
|
28
|
+
{ name: 'update_custom_field', op: 'rename_or_archive_a_custom_field', kind: 'write' },
|
|
25
29
|
|
|
26
30
|
// Inbox
|
|
27
31
|
{ name: 'list_conversations', op: 'list_conversations', kind: 'read' },
|
|
@@ -30,10 +34,20 @@ export const TOOLS = [
|
|
|
30
34
|
{ name: 'update_conversation', op: 'update_a_conversation', kind: 'write' },
|
|
31
35
|
{ name: 'send_message', op: 'send_a_message', kind: 'destructive',
|
|
32
36
|
note: 'This reaches a real person on their phone. Confirm the recipient and the text with the user before calling.' },
|
|
37
|
+
{ name: 'assign_conversation', op: 'assign_or_unassign_a_conversation', kind: 'write' },
|
|
38
|
+
{ name: 'list_team_members', op: 'list_team_members', kind: 'read',
|
|
39
|
+
note: 'Use it to find the member id for assign_conversation.' },
|
|
40
|
+
{ name: 'list_blocked_users', op: 'list_blocked_users', kind: 'read' },
|
|
41
|
+
{ name: 'block_user', op: 'block_a_user', kind: 'write' },
|
|
42
|
+
{ name: 'unblock_user', op: 'unblock_a_user', kind: 'write' },
|
|
43
|
+
{ name: 'list_opt_outs', op: 'list_opt_outs', kind: 'read' },
|
|
33
44
|
|
|
34
45
|
// Appointments
|
|
35
46
|
{ name: 'list_appointments', op: 'list_appointments', kind: 'read' },
|
|
36
47
|
{ name: 'get_availability', op: 'get_availability', kind: 'read' },
|
|
48
|
+
{ name: 'get_appointment', op: 'get_an_appointment', kind: 'read' },
|
|
49
|
+
{ name: 'update_appointment', op: 'update_an_appointment', kind: 'destructive',
|
|
50
|
+
note: 'Edits are pushed to the connected calendar, and a status of cancelled removes the event. To move the time, use reschedule_appointment.' },
|
|
37
51
|
{ name: 'book_appointment', op: 'book_an_appointment', kind: 'destructive' },
|
|
38
52
|
{ name: 'reschedule_appointment', op: 'reschedule_an_appointment', kind: 'destructive' },
|
|
39
53
|
{ name: 'cancel_appointment', op: 'cancel_an_appointment', kind: 'destructive' },
|
|
@@ -51,16 +65,37 @@ export const TOOLS = [
|
|
|
51
65
|
{ name: 'publish_flow', op: 'publish_a_flow_draft', kind: 'destructive' },
|
|
52
66
|
{ name: 'activate_flow', op: 'activate_a_flow', kind: 'destructive' },
|
|
53
67
|
{ name: 'pause_flow', op: 'pause_a_flow', kind: 'write' },
|
|
68
|
+
{ name: 'duplicate_flow', op: 'duplicate_a_flow', kind: 'write' },
|
|
69
|
+
{ name: 'discard_flow_draft', op: 'discard_a_flow_draft', kind: 'write' },
|
|
70
|
+
{ name: 'delete_flow', op: 'delete_a_flow', kind: 'destructive',
|
|
71
|
+
note: 'Permanent: the flow, its versions, sessions and analytics are gone. Confirm with the user, and prefer pause_flow.' },
|
|
54
72
|
{ name: 'get_flow_analytics', op: 'get_flow_analytics', kind: 'read' },
|
|
55
73
|
{ name: 'list_flow_sessions', op: 'list_flow_sessions', kind: 'read' },
|
|
74
|
+
{ name: 'get_flow_session', op: 'get_a_flow_session', kind: 'read' },
|
|
75
|
+
{ name: 'list_flow_session_events', op: 'list_events_for_a_session', kind: 'read' },
|
|
76
|
+
{ name: 'list_flow_events', op: 'list_flow_events_across_sessions', kind: 'read' },
|
|
56
77
|
|
|
57
78
|
// Comment triggers and the AI Comment Manager
|
|
58
79
|
{ name: 'list_comment_triggers', op: 'list_comment_triggers', kind: 'read' },
|
|
80
|
+
{ name: 'get_comment_trigger', op: 'get_a_comment_trigger', kind: 'read' },
|
|
81
|
+
{ name: 'simulate_comment', op: 'simulate_a_comment', kind: 'read',
|
|
82
|
+
note: 'Dry run, nothing is sent. Use it to check a trigger matches before and after changing it.' },
|
|
83
|
+
{ name: 'create_comment_trigger', op: 'create_a_comment_trigger', kind: 'destructive',
|
|
84
|
+
note: '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.' },
|
|
85
|
+
{ name: 'update_comment_trigger', op: 'update_a_comment_trigger', kind: 'destructive',
|
|
86
|
+
note: '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.' },
|
|
87
|
+
{ name: 'duplicate_comment_trigger', op: 'duplicate_a_comment_trigger', kind: 'write' },
|
|
88
|
+
{ name: 'delete_comment_trigger', op: 'delete_a_comment_trigger', kind: 'destructive' },
|
|
59
89
|
{ name: 'get_comment_trigger_stats', op: 'get_comment_trigger_stats', kind: 'read' },
|
|
60
90
|
{ name: 'list_recent_posts', op: 'list_recent_posts', kind: 'read' },
|
|
61
91
|
{ name: 'list_handled_comments', op: 'list_handled_comments', kind: 'read' },
|
|
92
|
+
{ name: 'get_handled_comment', op: 'get_a_handled_comment', kind: 'read' },
|
|
93
|
+
{ name: 'get_comment_manager_stats', op: 'get_comment_manager_stats', kind: 'read' },
|
|
62
94
|
{ name: 'approve_comment_reply', op: 'approve_a_reply', kind: 'destructive' },
|
|
63
95
|
{ name: 'reject_comment_reply', op: 'reject_a_reply', kind: 'write' },
|
|
96
|
+
{ name: 'bulk_approve_comment_replies', op: 'bulk_approve_replies', kind: 'destructive',
|
|
97
|
+
note: 'Each approved reply is posted publicly under the comment. Confirm with the user.' },
|
|
98
|
+
{ name: 'bulk_reject_comment_replies', op: 'bulk_reject_replies', kind: 'write' },
|
|
64
99
|
|
|
65
100
|
// Content Studio
|
|
66
101
|
{ name: 'list_posts', op: 'list_posts', kind: 'read' },
|
|
@@ -70,6 +105,9 @@ export const TOOLS = [
|
|
|
70
105
|
{ name: 'update_post', op: 'update_a_post', kind: 'write' },
|
|
71
106
|
{ name: 'schedule_post', op: 'schedule_a_post', kind: 'destructive' },
|
|
72
107
|
{ name: 'publish_post', op: 'publish_a_post_now', kind: 'destructive' },
|
|
108
|
+
{ name: 'unschedule_post', op: 'unschedule_a_post', kind: 'write' },
|
|
109
|
+
{ name: 'retry_post', op: 'retry_a_failed_post', kind: 'destructive' },
|
|
110
|
+
{ name: 'delete_post', op: 'delete_a_post', kind: 'destructive' },
|
|
73
111
|
|
|
74
112
|
// Market Intel (competitors and Instagram insights)
|
|
75
113
|
{ name: 'list_competitors', op: 'list_tracked_competitors', kind: 'read' },
|
|
@@ -93,4 +131,19 @@ export const TOOLS = [
|
|
|
93
131
|
{ name: 'update_faq', op: 'update_an_faq', kind: 'write' },
|
|
94
132
|
{ name: 'list_services', op: 'list_services', kind: 'read' },
|
|
95
133
|
{ name: 'list_knowledge_gaps', op: 'list_knowledge_gaps', kind: 'read' },
|
|
134
|
+
{ name: 'get_knowledge_usage', op: 'get_knowledge_base_usage', kind: 'read' },
|
|
135
|
+
{ name: 'get_faq', op: 'get_an_faq', kind: 'read' },
|
|
136
|
+
{ name: 'delete_faq', op: 'delete_an_faq', kind: 'destructive' },
|
|
137
|
+
{ name: 'get_service', op: 'get_a_service', kind: 'read' },
|
|
138
|
+
{ name: 'create_service', op: 'create_a_service', kind: 'write' },
|
|
139
|
+
{ name: 'update_service', op: 'update_a_service', kind: 'write' },
|
|
140
|
+
{ name: 'delete_service', op: 'delete_a_service', kind: 'destructive' },
|
|
141
|
+
{ name: 'list_documents', op: 'list_documents', kind: 'read' },
|
|
142
|
+
{ name: 'get_document', op: 'get_a_document', kind: 'read' },
|
|
143
|
+
{ name: 'update_document', op: 'rename_or_toggle_a_document', kind: 'write' },
|
|
144
|
+
{ name: 'delete_document', op: 'delete_a_document', kind: 'destructive' },
|
|
145
|
+
|
|
146
|
+
// AI settings (read only here; switching the AI needs the admin scope, which assistants never get)
|
|
147
|
+
{ name: 'get_ai_config', op: 'get_the_ai_configuration', kind: 'read' },
|
|
148
|
+
{ name: 'get_ai_channels', op: 'get_the_per_channel_ai_switches', kind: 'read' },
|
|
96
149
|
];
|