chatgenius-mcp 0.2.2 → 0.2.3
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/package.json +10 -3
- package/server.json +2 -2
- package/src/server.js +1 -1
- package/src/tools.js +17 -14
- package/tools.json +21 -19
package/package.json
CHANGED
|
@@ -1,8 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chatgenius-mcp",
|
|
3
|
-
"version": "0.2.
|
|
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.3",
|
|
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.",
|
|
5
5
|
"license": "MIT",
|
|
6
|
+
"homepage": "https://sumgenius.ai/docs/mcp",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/SumCodeAI/chatgenius-mcp.git"
|
|
10
|
+
},
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/SumCodeAI/chatgenius-mcp/issues"
|
|
13
|
+
},
|
|
6
14
|
"type": "module",
|
|
7
15
|
"bin": {
|
|
8
16
|
"chatgenius-mcp": "bin/chatgenius-mcp.js"
|
|
@@ -32,7 +40,6 @@
|
|
|
32
40
|
"sumgenius"
|
|
33
41
|
],
|
|
34
42
|
"author": "SumGeniusAI LLC",
|
|
35
|
-
"homepage": "https://sumgenius.ai/docs/mcp",
|
|
36
43
|
"dependencies": {
|
|
37
44
|
"@modelcontextprotocol/sdk": "^1.30.0"
|
|
38
45
|
},
|
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.2.
|
|
6
|
+
"version": "0.2.3",
|
|
7
7
|
"packages": [
|
|
8
8
|
{
|
|
9
9
|
"registryType": "npm",
|
|
10
10
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
11
11
|
"identifier": "chatgenius-mcp",
|
|
12
|
-
"version": "0.2.
|
|
12
|
+
"version": "0.2.3",
|
|
13
13
|
"runtimeHint": "npx",
|
|
14
14
|
"transport": {
|
|
15
15
|
"type": "stdio"
|
package/src/server.js
CHANGED
|
@@ -16,7 +16,7 @@ const annotations = (t) => ({
|
|
|
16
16
|
readOnlyHint: t.kind === 'read',
|
|
17
17
|
destructiveHint: t.kind === 'destructive',
|
|
18
18
|
idempotentHint: t.method === 'GET' || t.method === 'DELETE',
|
|
19
|
-
openWorldHint: t.kind === 'destructive',
|
|
19
|
+
openWorldHint: t.kind === 'destructive' || t.openWorld === true,
|
|
20
20
|
});
|
|
21
21
|
|
|
22
22
|
const text = (s) => ({ content: [{ type: 'text', text: s }] });
|
package/src/tools.js
CHANGED
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
*
|
|
7
7
|
* kind: read (no side effects) | write (creates or edits) | destructive
|
|
8
8
|
* (sends something to a person, publishes, deletes). Clients use the hints
|
|
9
|
-
* to decide when to ask the person before running a tool.
|
|
9
|
+
* to decide when to ask the person before running a tool. destructive also
|
|
10
|
+
* covers edits that overwrite data with no undo, and pausing a live automation.
|
|
11
|
+
* openWorld: true marks a non-destructive tool that reaches Instagram or another
|
|
12
|
+
* outside service (destructive tools are open world already).
|
|
10
13
|
*/
|
|
11
14
|
export const TOOLS = [
|
|
12
15
|
// Account
|
|
@@ -16,8 +19,8 @@ export const TOOLS = [
|
|
|
16
19
|
// Contacts and tags
|
|
17
20
|
{ name: 'list_contacts', op: 'list_contacts', kind: 'read' },
|
|
18
21
|
{ name: 'get_contact', op: 'get_a_contact', kind: 'read' },
|
|
19
|
-
{ name: 'upsert_contact', op: 'create_or_update_a_contact', kind: '
|
|
20
|
-
{ name: 'update_contact', op: 'update_a_contact', kind: '
|
|
22
|
+
{ name: 'upsert_contact', op: 'create_or_update_a_contact', kind: 'destructive' },
|
|
23
|
+
{ name: 'update_contact', op: 'update_a_contact', kind: 'destructive' },
|
|
21
24
|
{ name: 'list_tags', op: 'list_tags', kind: 'read' },
|
|
22
25
|
{ name: 'create_tag', op: 'create_a_tag', kind: 'write' },
|
|
23
26
|
{ name: 'tag_contact', op: 'attach_a_tag', kind: 'write' },
|
|
@@ -61,12 +64,12 @@ export const TOOLS = [
|
|
|
61
64
|
{ name: 'validate_flow', op: 'validate_a_flow_definition', kind: 'read',
|
|
62
65
|
note: 'Validate a definition without saving it. Loop on errors[] until it is clean, then call create_flow.' },
|
|
63
66
|
{ name: 'create_flow', op: 'create_a_flow', kind: 'write' },
|
|
64
|
-
{ name: 'update_flow', op: 'update_a_flow', kind: '
|
|
67
|
+
{ name: 'update_flow', op: 'update_a_flow', kind: 'destructive' },
|
|
65
68
|
{ name: 'publish_flow', op: 'publish_a_flow_draft', kind: 'destructive' },
|
|
66
69
|
{ name: 'activate_flow', op: 'activate_a_flow', kind: 'destructive' },
|
|
67
|
-
{ name: 'pause_flow', op: 'pause_a_flow', kind: '
|
|
70
|
+
{ name: 'pause_flow', op: 'pause_a_flow', kind: 'destructive' },
|
|
68
71
|
{ name: 'duplicate_flow', op: 'duplicate_a_flow', kind: 'write' },
|
|
69
|
-
{ name: 'discard_flow_draft', op: 'discard_a_flow_draft', kind: '
|
|
72
|
+
{ name: 'discard_flow_draft', op: 'discard_a_flow_draft', kind: 'destructive' },
|
|
70
73
|
{ name: 'delete_flow', op: 'delete_a_flow', kind: 'destructive',
|
|
71
74
|
note: 'Permanent: the flow, its versions, sessions and analytics are gone. Confirm with the user, and prefer pause_flow.' },
|
|
72
75
|
{ name: 'get_flow_analytics', op: 'get_flow_analytics', kind: 'read' },
|
|
@@ -92,17 +95,17 @@ export const TOOLS = [
|
|
|
92
95
|
{ name: 'get_handled_comment', op: 'get_a_handled_comment', kind: 'read' },
|
|
93
96
|
{ name: 'get_comment_manager_stats', op: 'get_comment_manager_stats', kind: 'read' },
|
|
94
97
|
{ name: 'approve_comment_reply', op: 'approve_a_reply', kind: 'destructive' },
|
|
95
|
-
{ name: 'reject_comment_reply', op: 'reject_a_reply', kind: '
|
|
98
|
+
{ name: 'reject_comment_reply', op: 'reject_a_reply', kind: 'destructive' },
|
|
96
99
|
{ name: 'bulk_approve_comment_replies', op: 'bulk_approve_replies', kind: 'destructive',
|
|
97
100
|
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: '
|
|
101
|
+
{ name: 'bulk_reject_comment_replies', op: 'bulk_reject_replies', kind: 'destructive' },
|
|
99
102
|
|
|
100
103
|
// Content Studio
|
|
101
104
|
{ name: 'list_posts', op: 'list_posts', kind: 'read' },
|
|
102
105
|
{ name: 'get_post', op: 'get_a_post', kind: 'read' },
|
|
103
106
|
{ name: 'get_posting_capabilities', op: 'get_posting_capabilities', kind: 'read' },
|
|
104
|
-
{ name: 'create_post', op: 'create_a_post', kind: 'write' },
|
|
105
|
-
{ name: 'update_post', op: 'update_a_post', kind: '
|
|
107
|
+
{ name: 'create_post', op: 'create_a_post', kind: 'write', openWorld: true },
|
|
108
|
+
{ name: 'update_post', op: 'update_a_post', kind: 'destructive' },
|
|
106
109
|
{ name: 'schedule_post', op: 'schedule_a_post', kind: 'destructive' },
|
|
107
110
|
{ name: 'publish_post', op: 'publish_a_post_now', kind: 'destructive' },
|
|
108
111
|
{ name: 'unschedule_post', op: 'unschedule_a_post', kind: 'write' },
|
|
@@ -120,15 +123,15 @@ export const TOOLS = [
|
|
|
120
123
|
note: 'Includes followers online by hour, which is what "when should I post" is answered from.' },
|
|
121
124
|
{ name: 'get_top_posts', op: 'list_your_top_posts', kind: 'read' },
|
|
122
125
|
{ name: 'get_account_insights', op: 'get_account_insights', kind: 'read' },
|
|
123
|
-
{ name: 'add_competitor', op: 'track_a_competitor', kind: 'write' },
|
|
126
|
+
{ name: 'add_competitor', op: 'track_a_competitor', kind: 'write', openWorld: true },
|
|
124
127
|
{ name: 'remove_competitor', op: 'stop_tracking_a_competitor', kind: 'write' },
|
|
125
|
-
{ name: 'refresh_market_intel', op: 'refresh_from_meta', kind: 'write',
|
|
128
|
+
{ name: 'refresh_market_intel', op: 'refresh_from_meta', kind: 'write', openWorld: true,
|
|
126
129
|
note: 'Slow: one Meta call per tracked account. Only call it when the stored snapshot is stale.' },
|
|
127
130
|
|
|
128
131
|
// Knowledge base
|
|
129
132
|
{ name: 'list_faqs', op: 'list_faqs', kind: 'read' },
|
|
130
133
|
{ name: 'create_faq', op: 'create_an_faq', kind: 'write' },
|
|
131
|
-
{ name: 'update_faq', op: 'update_an_faq', kind: '
|
|
134
|
+
{ name: 'update_faq', op: 'update_an_faq', kind: 'destructive' },
|
|
132
135
|
{ name: 'list_services', op: 'list_services', kind: 'read' },
|
|
133
136
|
{ name: 'list_knowledge_gaps', op: 'list_knowledge_gaps', kind: 'read' },
|
|
134
137
|
{ name: 'get_knowledge_usage', op: 'get_knowledge_base_usage', kind: 'read' },
|
|
@@ -136,7 +139,7 @@ export const TOOLS = [
|
|
|
136
139
|
{ name: 'delete_faq', op: 'delete_an_faq', kind: 'destructive' },
|
|
137
140
|
{ name: 'get_service', op: 'get_a_service', kind: 'read' },
|
|
138
141
|
{ name: 'create_service', op: 'create_a_service', kind: 'write' },
|
|
139
|
-
{ name: 'update_service', op: 'update_a_service', kind: '
|
|
142
|
+
{ name: 'update_service', op: 'update_a_service', kind: 'destructive' },
|
|
140
143
|
{ name: 'delete_service', op: 'delete_a_service', kind: 'destructive' },
|
|
141
144
|
{ name: 'list_documents', op: 'list_documents', kind: 'read' },
|
|
142
145
|
{ name: 'get_document', op: 'get_a_document', kind: 'read' },
|
package/tools.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
|
-
"spec_version": "1.18.
|
|
2
|
+
"spec_version": "1.18.1",
|
|
3
3
|
"tools": [
|
|
4
4
|
{
|
|
5
5
|
"name": "get_account",
|
|
6
|
-
"description": "Get the account. Identity, plan, the calling key and its scope, and the configured webhook endpoints.
|
|
6
|
+
"description": "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.",
|
|
7
7
|
"method": "GET",
|
|
8
8
|
"path": "/account",
|
|
9
9
|
"scope": "read",
|
|
@@ -171,7 +171,7 @@
|
|
|
171
171
|
"method": "POST",
|
|
172
172
|
"path": "/contacts",
|
|
173
173
|
"scope": "write",
|
|
174
|
-
"kind": "
|
|
174
|
+
"kind": "destructive",
|
|
175
175
|
"hasBody": true,
|
|
176
176
|
"where": {
|
|
177
177
|
"path": [],
|
|
@@ -256,7 +256,7 @@
|
|
|
256
256
|
"method": "PATCH",
|
|
257
257
|
"path": "/contacts/{id}",
|
|
258
258
|
"scope": "write",
|
|
259
|
-
"kind": "
|
|
259
|
+
"kind": "destructive",
|
|
260
260
|
"hasBody": true,
|
|
261
261
|
"where": {
|
|
262
262
|
"path": [
|
|
@@ -1193,7 +1193,7 @@
|
|
|
1193
1193
|
},
|
|
1194
1194
|
{
|
|
1195
1195
|
"name": "update_appointment",
|
|
1196
|
-
"description": "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. 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.",
|
|
1196
|
+
"description": "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.",
|
|
1197
1197
|
"method": "PATCH",
|
|
1198
1198
|
"path": "/appointments/{id}",
|
|
1199
1199
|
"scope": "write",
|
|
@@ -1317,7 +1317,7 @@
|
|
|
1317
1317
|
},
|
|
1318
1318
|
{
|
|
1319
1319
|
"name": "book_appointment",
|
|
1320
|
-
"description": "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 and free (409 slot_unavailable), the appointment is confirmed at once, synced to Google Calendar and GoHighLevel when connected, and appointment.booked fires. Attach conversation_id to
|
|
1320
|
+
"description": "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).",
|
|
1321
1321
|
"method": "POST",
|
|
1322
1322
|
"path": "/appointments",
|
|
1323
1323
|
"scope": "write",
|
|
@@ -1396,12 +1396,11 @@
|
|
|
1396
1396
|
"integer",
|
|
1397
1397
|
"null"
|
|
1398
1398
|
],
|
|
1399
|
-
"description": "
|
|
1399
|
+
"description": "Link the booking to the person in this conversation; sets the channel. No message is sent."
|
|
1400
1400
|
},
|
|
1401
1401
|
"send_confirmation": {
|
|
1402
1402
|
"type": "boolean",
|
|
1403
|
-
"
|
|
1404
|
-
"description": "With conversation_id: DM the customer the confirmation."
|
|
1403
|
+
"description": "Reserved for booking confirmation emails. Accepted and currently ignored."
|
|
1405
1404
|
},
|
|
1406
1405
|
"location": {
|
|
1407
1406
|
"type": "object",
|
|
@@ -1456,7 +1455,7 @@
|
|
|
1456
1455
|
},
|
|
1457
1456
|
{
|
|
1458
1457
|
"name": "reschedule_appointment",
|
|
1459
|
-
"description": "Reschedule an appointment. Moves a pending or confirmed appointment to a new date and time after checking the slot is free, updates the connected calendars, fires appointment.rescheduled
|
|
1458
|
+
"description": "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.",
|
|
1460
1459
|
"method": "POST",
|
|
1461
1460
|
"path": "/appointments/{id}/reschedule",
|
|
1462
1461
|
"scope": "write",
|
|
@@ -1499,7 +1498,7 @@
|
|
|
1499
1498
|
},
|
|
1500
1499
|
{
|
|
1501
1500
|
"name": "cancel_appointment",
|
|
1502
|
-
"description": "Cancel an appointment. Sets status cancelled, removes the Google Calendar and GoHighLevel events, fires appointment.cancelled. 409 already_cancelled if it already is. Send {} as the body.",
|
|
1501
|
+
"description": "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.",
|
|
1503
1502
|
"method": "POST",
|
|
1504
1503
|
"path": "/appointments/{id}/cancel",
|
|
1505
1504
|
"scope": "write",
|
|
@@ -2085,7 +2084,7 @@
|
|
|
2085
2084
|
"method": "PATCH",
|
|
2086
2085
|
"path": "/flows/{id}",
|
|
2087
2086
|
"scope": "write",
|
|
2088
|
-
"kind": "
|
|
2087
|
+
"kind": "destructive",
|
|
2089
2088
|
"hasBody": true,
|
|
2090
2089
|
"where": {
|
|
2091
2090
|
"path": [
|
|
@@ -2360,7 +2359,7 @@
|
|
|
2360
2359
|
"method": "POST",
|
|
2361
2360
|
"path": "/flows/{id}/pause",
|
|
2362
2361
|
"scope": "write",
|
|
2363
|
-
"kind": "
|
|
2362
|
+
"kind": "destructive",
|
|
2364
2363
|
"hasBody": false,
|
|
2365
2364
|
"where": {
|
|
2366
2365
|
"path": [
|
|
@@ -2418,7 +2417,7 @@
|
|
|
2418
2417
|
"method": "POST",
|
|
2419
2418
|
"path": "/flows/{id}/discard-draft",
|
|
2420
2419
|
"scope": "write",
|
|
2421
|
-
"kind": "
|
|
2420
|
+
"kind": "destructive",
|
|
2422
2421
|
"hasBody": false,
|
|
2423
2422
|
"where": {
|
|
2424
2423
|
"path": [
|
|
@@ -3622,7 +3621,7 @@
|
|
|
3622
3621
|
"method": "POST",
|
|
3623
3622
|
"path": "/comments/{id}/reject",
|
|
3624
3623
|
"scope": "write",
|
|
3625
|
-
"kind": "
|
|
3624
|
+
"kind": "destructive",
|
|
3626
3625
|
"hasBody": false,
|
|
3627
3626
|
"where": {
|
|
3628
3627
|
"path": [
|
|
@@ -3684,7 +3683,7 @@
|
|
|
3684
3683
|
"method": "POST",
|
|
3685
3684
|
"path": "/comments/reject",
|
|
3686
3685
|
"scope": "write",
|
|
3687
|
-
"kind": "
|
|
3686
|
+
"kind": "destructive",
|
|
3688
3687
|
"hasBody": true,
|
|
3689
3688
|
"where": {
|
|
3690
3689
|
"path": [],
|
|
@@ -3838,6 +3837,7 @@
|
|
|
3838
3837
|
"path": "/posts",
|
|
3839
3838
|
"scope": "write",
|
|
3840
3839
|
"kind": "write",
|
|
3840
|
+
"openWorld": true,
|
|
3841
3841
|
"hasBody": true,
|
|
3842
3842
|
"where": {
|
|
3843
3843
|
"path": [],
|
|
@@ -4103,7 +4103,7 @@
|
|
|
4103
4103
|
"method": "PATCH",
|
|
4104
4104
|
"path": "/posts/{id}",
|
|
4105
4105
|
"scope": "write",
|
|
4106
|
-
"kind": "
|
|
4106
|
+
"kind": "destructive",
|
|
4107
4107
|
"hasBody": true,
|
|
4108
4108
|
"where": {
|
|
4109
4109
|
"path": [
|
|
@@ -4742,6 +4742,7 @@
|
|
|
4742
4742
|
"path": "/competitors",
|
|
4743
4743
|
"scope": "write",
|
|
4744
4744
|
"kind": "write",
|
|
4745
|
+
"openWorld": true,
|
|
4745
4746
|
"hasBody": true,
|
|
4746
4747
|
"where": {
|
|
4747
4748
|
"path": [],
|
|
@@ -4801,6 +4802,7 @@
|
|
|
4801
4802
|
"path": "/market-intel/refresh",
|
|
4802
4803
|
"scope": "write",
|
|
4803
4804
|
"kind": "write",
|
|
4805
|
+
"openWorld": true,
|
|
4804
4806
|
"hasBody": false,
|
|
4805
4807
|
"where": {
|
|
4806
4808
|
"path": [],
|
|
@@ -4913,7 +4915,7 @@
|
|
|
4913
4915
|
"method": "PATCH",
|
|
4914
4916
|
"path": "/knowledge/faqs/{id}",
|
|
4915
4917
|
"scope": "write",
|
|
4916
|
-
"kind": "
|
|
4918
|
+
"kind": "destructive",
|
|
4917
4919
|
"hasBody": true,
|
|
4918
4920
|
"where": {
|
|
4919
4921
|
"path": [
|
|
@@ -5282,7 +5284,7 @@
|
|
|
5282
5284
|
"method": "PATCH",
|
|
5283
5285
|
"path": "/knowledge/services/{id}",
|
|
5284
5286
|
"scope": "write",
|
|
5285
|
-
"kind": "
|
|
5287
|
+
"kind": "destructive",
|
|
5286
5288
|
"hasBody": true,
|
|
5287
5289
|
"where": {
|
|
5288
5290
|
"path": [
|