@pushizo/mcp-server 0.2.0 → 0.3.0
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 +5 -3
- package/dist/kit.d.ts +6 -0
- package/dist/kit.d.ts.map +1 -1
- package/dist/kit.js +21 -15
- package/dist/kit.js.map +1 -1
- package/dist/server.d.ts +4 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +37 -29
- package/dist/server.js.map +1 -1
- package/dist/stdio.js +3 -3
- package/dist/stdio.js.map +1 -1
- package/dist/tools-data.d.ts +13 -0
- package/dist/tools-data.d.ts.map +1 -0
- package/dist/tools-data.js +223 -0
- package/dist/tools-data.js.map +1 -0
- package/dist/tools-engage.d.ts +11 -0
- package/dist/tools-engage.d.ts.map +1 -0
- package/dist/tools-engage.js +226 -0
- package/dist/tools-engage.js.map +1 -0
- package/dist/tools-insights.js +62 -62
- package/dist/tools-insights.js.map +1 -1
- package/dist/tools-ops.d.ts +11 -0
- package/dist/tools-ops.d.ts.map +1 -0
- package/dist/tools-ops.js +96 -0
- package/dist/tools-ops.js.map +1 -0
- package/dist/tools-read.d.ts.map +1 -1
- package/dist/tools-read.js +59 -64
- package/dist/tools-read.js.map +1 -1
- package/dist/tools-write.d.ts +3 -3
- package/dist/tools-write.d.ts.map +1 -1
- package/dist/tools-write.js +101 -24
- package/dist/tools-write.js.map +1 -1
- package/package.json +2 -2
- package/server.json +3 -3
package/README.md
CHANGED
|
@@ -119,7 +119,8 @@ geçersizse süreç 1 koduyla çıkar.
|
|
|
119
119
|
|
|
120
120
|
## Araçlar
|
|
121
121
|
|
|
122
|
-
|
|
122
|
+
228 araç (218 okuma, 9 taslak, test gönderimi); public API'deki her okuma ucunun bir aracı vardır. Ayrıntılı liste
|
|
123
|
+
`docs/guides/mcp.md` içindedir. Özet:
|
|
123
124
|
|
|
124
125
|
| Araç | Tür | Gerekli kapsam |
|
|
125
126
|
|---|---|---|
|
|
@@ -128,10 +129,11 @@ geçersizse süreç 1 koduyla çıkar.
|
|
|
128
129
|
| RFM, öngörü, karar ajanı, kanal skoru, özellik bayrağı, rapor, yol analizi, katalog ve öneri, bölge araçları | okuma | `analytics:read` |
|
|
129
130
|
| `list_messages`, `get_message` | okuma | `analytics:read` veya `notifications:write` |
|
|
130
131
|
| `get_app`, `search_users`, `get_user`, `get_user_journeys`, `get_user_preferences`, `list_categories`, `list_rfm_users`, `list_prediction_users`, `list_wallet_templates` | okuma | `users:read` |
|
|
131
|
-
|
|
|
132
|
+
| Şirket, ilgi etiketleri, SQL sorgu (`run_sql_query`, yalnız SELECT), veri boru hattı, ambar segmenti, konuşma ve AI ajanı, özel AI ajanları, web kişiselleştirme, site içi arama, reklam, kaldırma ve Android teslimat raporu okuma araçları | okuma | `users:read`, `analytics:read`, `segments:read` veya `admin` (araca göre) |
|
|
133
|
+
| `create_campaign_draft`, `create_segment_draft`, `create_template_draft`, `create_journey_draft`, `create_in_app_draft`, `create_web_campaign_draft`, `create_web_personalization_draft`, `create_survey_draft`, `create_landing_page_draft` | onaylı mod — taslak | `mcp:write` |
|
|
132
134
|
| `send_test_notification` | onaylı mod — yalnız test cihazı | `mcp:write` |
|
|
133
135
|
|
|
134
|
-
`admin` kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya
|
|
136
|
+
`admin` kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya, journey, in-app, web kampanyası, web kişiselleştirme, anket ve landing
|
|
135
137
|
`draft`, şablon ve kampanyaya `mcp` etiketi, segment dinamik). `send_test_notification` gerçek kitleye gidemez.
|
|
136
138
|
Asistandan çağırmadan önce kullanıcının açık onayı istenir.
|
|
137
139
|
|
package/dist/kit.d.ts
CHANGED
|
@@ -12,6 +12,12 @@ export declare const cursorArg: z.ZodOptional<z.ZodString>;
|
|
|
12
12
|
export declare const idArg: (what: string) => z.ZodString;
|
|
13
13
|
export declare const fromArg: z.ZodOptional<z.ZodString>;
|
|
14
14
|
export declare const toArg: z.ZodOptional<z.ZodString>;
|
|
15
|
+
/** Kullanıcıyı kimlik etiketiyle seçen ortak argümanlar (`/users/by/{label}/{value}` uçları). */
|
|
16
|
+
export declare const aliasArgs: {
|
|
17
|
+
label: z.ZodString;
|
|
18
|
+
value: z.ZodString;
|
|
19
|
+
};
|
|
20
|
+
export declare const compareArg: z.ZodOptional<z.ZodBoolean>;
|
|
15
21
|
/** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
|
|
16
22
|
export declare const definitionArg: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
17
23
|
export declare function query(params: Record<string, string | number | boolean | undefined>): string;
|
package/dist/kit.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,eAA4G,CAAC;AAChI,4GAA4G;AAC5G,eAAO,MAAM,KAAK,EAAE,eAA8G,CAAC;AAEnI,eAAO,MAAM,UAAU,
|
|
1
|
+
{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,eAA4G,CAAC;AAChI,4GAA4G;AAC5G,eAAO,MAAM,KAAK,EAAE,eAA8G,CAAC;AAEnI,eAAO,MAAM,UAAU,QAE4E,CAAC;AASpG,eAAO,MAAM,QAAQ,4BAAwK,CAAC;AAC9L,eAAO,MAAM,QAAQ,4BAAkF,CAAC;AACxG,eAAO,MAAM,SAAS,4BAAiG,CAAC;AACxH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,gBAAmF,CAAC;AACtH,eAAO,MAAM,OAAO,4BAAwH,CAAC;AAC7I,eAAO,MAAM,KAAK,4BAA0D,CAAC;AAC7E,iGAAiG;AACjG,eAAO,MAAM,SAAS;;;CAGrB,CAAC;AACF,eAAO,MAAM,UAAU,6BAAuG,CAAC;AAC/H,yFAAyF;AACzF,eAAO,MAAM,aAAa,wCAEiI,CAAC;AAE5J,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,MAAM,CAK3F;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAEhD;AAQD,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAUjD;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,mEAAmE;IACnE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzC"}
|
package/dist/kit.js
CHANGED
|
@@ -4,24 +4,30 @@ import { PushizoApiError } from './api.js';
|
|
|
4
4
|
export const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
|
|
5
5
|
/** Yazma araçları: yalnızca taslak oluşturur (gönderim/silme yok), sunucuda `mcp:write` kapsamı zorunlu. */
|
|
6
6
|
export const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
|
|
7
|
-
export const WRITE_NOTE = '[
|
|
8
|
-
'API
|
|
7
|
+
export const WRITE_NOTE = '[Approved mode — write] This tool creates a record in Pushizo. It only creates a DRAFT and never sends or schedules a message; ' +
|
|
8
|
+
'the API key needs the `mcp:write` scope. Get explicit approval from the user before calling it.';
|
|
9
9
|
/**
|
|
10
10
|
* Kimlikler URL yoluna yazılır: `.` ve `..` WHATWG URL çözümlemesinde başka uca kayar, `/` yolu böler. Desen bunları
|
|
11
11
|
* dışarıda bırakır (ADR-0076 §5).
|
|
12
12
|
*/
|
|
13
13
|
const ID_PATTERN = /^(?!\.{1,2}$)[A-Za-z0-9_.:-]+$/;
|
|
14
|
-
const ID_MESSAGE = '
|
|
15
|
-
export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App
|
|
16
|
-
export const limitArg = z.number().int().min(1).max(100).optional().describe('
|
|
17
|
-
export const cursorArg = z.string().max(500).optional().describe('
|
|
18
|
-
export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what}
|
|
19
|
-
export const fromArg = z.string().max(40).optional().describe('ISO-8601
|
|
20
|
-
export const toArg = z.string().max(40).optional().describe('ISO-8601
|
|
14
|
+
const ID_MESSAGE = 'ID may only contain letters, digits, `_`, `-`, `.` and `:`.';
|
|
15
|
+
export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App ID (app_…). Not needed with an app-scoped key or when a default app is configured.');
|
|
16
|
+
export const limitArg = z.number().int().min(1).max(100).optional().describe('Page size (default 20).');
|
|
17
|
+
export const cursorArg = z.string().max(500).optional().describe('The `next_cursor` value from the previous response.');
|
|
18
|
+
export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what} ID`);
|
|
19
|
+
export const fromArg = z.string().max(40).optional().describe('ISO-8601 start (e.g. 2026-10-01T00:00:00Z); defaults to the report default.');
|
|
20
|
+
export const toArg = z.string().max(40).optional().describe('ISO-8601 end.');
|
|
21
|
+
/** Kullanıcıyı kimlik etiketiyle seçen ortak argümanlar (`/users/by/{label}/{value}` uçları). */
|
|
22
|
+
export const aliasArgs = {
|
|
23
|
+
label: z.string().min(1).max(64).describe('Identity label: `external_id`, `pushizo_id` or a defined alias (e.g. `crm_id`).'),
|
|
24
|
+
value: z.string().min(1).max(255).describe('Value for the label (e.g. the external_id value).'),
|
|
25
|
+
};
|
|
26
|
+
export const compareArg = z.boolean().optional().describe('true: adds a comparison with the previous period of equal length.');
|
|
21
27
|
/** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
|
|
22
28
|
export const definitionArg = z
|
|
23
29
|
.record(z.string(), z.unknown())
|
|
24
|
-
.describe('
|
|
30
|
+
.describe('Condition definition, e.g. {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.');
|
|
25
31
|
export function query(params) {
|
|
26
32
|
const q = new URLSearchParams();
|
|
27
33
|
for (const [k, v] of Object.entries(params))
|
|
@@ -35,15 +41,15 @@ export function ok(data) {
|
|
|
35
41
|
}
|
|
36
42
|
/** Sık görülen durum kodları için modelin sonraki adımını belirleyen ipucu. */
|
|
37
43
|
const HTTP_HINTS = {
|
|
38
|
-
403: ' —
|
|
39
|
-
429: ' —
|
|
44
|
+
403: ' — Check the API key scopes.',
|
|
45
|
+
429: ' — Rate limited; wait a few seconds and retry, and reduce back-to-back calls.',
|
|
40
46
|
};
|
|
41
47
|
export function fail(err) {
|
|
42
48
|
const text = err instanceof PushizoApiError
|
|
43
49
|
? `${err.code} (HTTP ${err.status}): ${err.message}${HTTP_HINTS[err.status] ?? ''}`
|
|
44
50
|
: err instanceof Error
|
|
45
51
|
? err.name === 'TimeoutError' || err.name === 'AbortError'
|
|
46
|
-
? '
|
|
52
|
+
? 'Request timed out; retry with a narrower date range or a smaller `limit`.'
|
|
47
53
|
: err.message
|
|
48
54
|
: String(err);
|
|
49
55
|
return { isError: true, content: [{ type: 'text', text }] };
|
|
@@ -52,7 +58,7 @@ export function createToolKit(api, defaultAppId) {
|
|
|
52
58
|
function app(appId) {
|
|
53
59
|
const id = appId ?? defaultAppId;
|
|
54
60
|
if (!id)
|
|
55
|
-
throw new Error('app_id
|
|
61
|
+
throw new Error('app_id is required (pass app_id in the tool call when the key is organization-wide).');
|
|
56
62
|
return seg(id);
|
|
57
63
|
}
|
|
58
64
|
async function run(fn) {
|
|
@@ -71,7 +77,7 @@ export function createToolKit(api, defaultAppId) {
|
|
|
71
77
|
*/
|
|
72
78
|
export function seg(value) {
|
|
73
79
|
if (value === '.' || value === '..')
|
|
74
|
-
throw new Error('
|
|
80
|
+
throw new Error('Invalid value: `.` and `..` cannot be used as path segments.');
|
|
75
81
|
return encodeURIComponent(value);
|
|
76
82
|
}
|
|
77
83
|
//# sourceMappingURL=kit.js.map
|
package/dist/kit.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAChI,4GAA4G;AAC5G,MAAM,CAAC,MAAM,KAAK,GAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEnI,MAAM,CAAC,MAAM,UAAU,GACrB,
|
|
1
|
+
{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
|
2
2
|
import type { PushizoApi } from './api.js';
|
|
3
3
|
export declare const MCP_SERVER_NAME = "pushizo";
|
|
4
4
|
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
5
|
-
export declare const MCP_SERVER_VERSION = "0.
|
|
5
|
+
export declare const MCP_SERVER_VERSION = "0.3.0";
|
|
6
6
|
export interface PushizoMcpOptions {
|
|
7
7
|
api: PushizoApi;
|
|
8
8
|
/** Araçta `app_id` verilmezse kullanılan app (app'e bağlı anahtarda anahtarın app'i). */
|
|
@@ -17,7 +17,9 @@ export interface PushizoMcpOptions {
|
|
|
17
17
|
export declare function canListWriteTools(scopes: readonly string[] | undefined): boolean;
|
|
18
18
|
/**
|
|
19
19
|
* Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
|
|
20
|
-
* in-app ve web büyüme okuma araçları;
|
|
20
|
+
* in-app ve web büyüme okuma araçları; veri (şirket, SQL, boru hattı, ambar) ve etkileşim (konuşma, AI ajanı, site
|
|
21
|
+
* araması, reklam) okuma araçları; kampanya/segment/şablon/journey/in-app/web kampanyası/web kişiselleştirme/anket/
|
|
22
|
+
* landing taslağı ve test cihazlarına test gönderimi.
|
|
21
23
|
* Taşıma bağımsızdır (stdio, Streamable HTTP, testte in-memory).
|
|
22
24
|
*/
|
|
23
25
|
export declare function createPushizoMcpServer(options: PushizoMcpOptions): McpServer;
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAS3C,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAiK5E"}
|
package/dist/server.js
CHANGED
|
@@ -1,34 +1,39 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
import { z } from 'zod';
|
|
3
3
|
import { READ, WRITE, WRITE_NOTE, appIdArg, createToolKit, cursorArg, idArg, limitArg, query, seg } from './kit.js';
|
|
4
|
+
import { registerDataTools } from './tools-data.js';
|
|
5
|
+
import { registerEngageTools } from './tools-engage.js';
|
|
4
6
|
import { registerInsightTools } from './tools-insights.js';
|
|
7
|
+
import { registerOpsTools } from './tools-ops.js';
|
|
5
8
|
import { registerReadTools } from './tools-read.js';
|
|
6
9
|
import { registerWriteTools } from './tools-write.js';
|
|
7
10
|
export const MCP_SERVER_NAME = 'pushizo';
|
|
8
11
|
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
9
|
-
export const MCP_SERVER_VERSION = '0.
|
|
12
|
+
export const MCP_SERVER_VERSION = '0.3.0';
|
|
10
13
|
/** Yazma araçları listelensin mi: kapsam bilinmiyorsa evet, biliniyorsa `mcp:write` veya `admin` gerekir. */
|
|
11
14
|
export function canListWriteTools(scopes) {
|
|
12
15
|
return !scopes || scopes.includes('admin') || scopes.includes('mcp:write');
|
|
13
16
|
}
|
|
14
17
|
/**
|
|
15
18
|
* Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
|
|
16
|
-
* in-app ve web büyüme okuma araçları;
|
|
19
|
+
* in-app ve web büyüme okuma araçları; veri (şirket, SQL, boru hattı, ambar) ve etkileşim (konuşma, AI ajanı, site
|
|
20
|
+
* araması, reklam) okuma araçları; kampanya/segment/şablon/journey/in-app/web kampanyası/web kişiselleştirme/anket/
|
|
21
|
+
* landing taslağı ve test cihazlarına test gönderimi.
|
|
17
22
|
* Taşıma bağımsızdır (stdio, Streamable HTTP, testte in-memory).
|
|
18
23
|
*/
|
|
19
24
|
export function createPushizoMcpServer(options) {
|
|
20
25
|
const server = new McpServer({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION, title: 'Pushizo' }, {
|
|
21
|
-
instructions: 'Pushizo
|
|
22
|
-
'test
|
|
23
|
-
'
|
|
26
|
+
instructions: 'Tools for the Pushizo messaging platform (push, email, SMS, in-app, journeys). Read tools are side-effect free. create_* tools only create drafts and ' +
|
|
27
|
+
'send_test_notification only sends to test devices; call either only after the user explicitly approves. This server cannot send to real audiences, ' +
|
|
28
|
+
'schedule, publish or delete; drafts are reviewed and sent from the Pushizo dashboard. For analysis, first find IDs with list_* tools, then use get_* and report tools.',
|
|
24
29
|
});
|
|
25
30
|
const kit = createToolKit(options.api, options.defaultAppId);
|
|
26
31
|
const { api, app, run } = kit;
|
|
27
|
-
server.registerTool('list_segments', { title: '
|
|
28
|
-
server.registerTool('get_segment', { title: '
|
|
32
|
+
server.registerTool('list_segments', { title: 'List segments', description: 'Lists the app’s segments (name search, pagination). Required scope: segments:read.', inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), limit: limitArg, cursor: cursorArg }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments${query({ q: a.q, limit: a.limit, cursor: a.cursor })}`)));
|
|
33
|
+
server.registerTool('get_segment', { title: 'Get segment', description: 'Segment definition and estimated audience size. Required scope: segments:read.', inputSchema: { app_id: appIdArg, segment_id: idArg('Segment') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments/${seg(a.segment_id)}`)));
|
|
29
34
|
server.registerTool('list_campaigns', {
|
|
30
|
-
title: '
|
|
31
|
-
description: '
|
|
35
|
+
title: 'List campaigns',
|
|
36
|
+
description: 'Lists campaigns (filter by status, type or name). Required scope: analytics:read.',
|
|
32
37
|
inputSchema: {
|
|
33
38
|
app_id: appIdArg,
|
|
34
39
|
q: z.string().max(100).optional(),
|
|
@@ -38,45 +43,45 @@ export function createPushizoMcpServer(options) {
|
|
|
38
43
|
},
|
|
39
44
|
annotations: READ,
|
|
40
45
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns${query({ q: a.q, status: a.status, limit: a.limit, cursor: a.cursor })}`)));
|
|
41
|
-
server.registerTool('get_campaign', { title: '
|
|
42
|
-
server.registerTool('list_campaign_messages', { title: '
|
|
46
|
+
server.registerTool('get_campaign', { title: 'Get campaign', description: 'Campaign details (audience, content, approval status, stats). Required scope: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Campaign') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}`)));
|
|
47
|
+
server.registerTool('list_campaign_messages', { title: 'Campaign runs', description: 'Messages of a campaign (one message per run) with their counters. Required scope: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Campaign') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}/messages`)));
|
|
43
48
|
server.registerTool('list_messages', {
|
|
44
|
-
title: '
|
|
45
|
-
description: '
|
|
49
|
+
title: 'List messages',
|
|
50
|
+
description: 'Sent messages (API, campaign, journey) with delivery counters. Required scope: analytics:read or notifications:write.',
|
|
46
51
|
inputSchema: { app_id: appIdArg, limit: limitArg, cursor: cursorArg },
|
|
47
52
|
annotations: READ,
|
|
48
53
|
}, async (a) => run(() => api.request('GET', `/v1/notifications${query({ app_id: decodeURIComponent(app(a.app_id)), limit: a.limit, cursor: a.cursor })}`)));
|
|
49
|
-
server.registerTool('get_message', { title: '
|
|
54
|
+
server.registerTool('get_message', { title: 'Get message', description: 'Message status and counters. Required scope: analytics:read or notifications:write.', inputSchema: { app_id: appIdArg, message_id: idArg('Message') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/notifications/${seg(a.message_id)}${query({ app_id: decodeURIComponent(app(a.app_id)) })}`)));
|
|
50
55
|
server.registerTool('get_analytics_summary', {
|
|
51
|
-
title: '
|
|
52
|
-
description: '
|
|
56
|
+
title: 'Analytics summary',
|
|
57
|
+
description: 'Overview KPIs: sends, deliveries, open/click rates, subscription growth (last 7/30 days or a custom range). Required scope: analytics:read.',
|
|
53
58
|
inputSchema: {
|
|
54
59
|
app_id: appIdArg,
|
|
55
60
|
range: z.enum(['7d', '30d']).optional(),
|
|
56
|
-
from: z.string().max(40).optional().describe('ISO-8601
|
|
57
|
-
to: z.string().max(40).optional().describe('ISO-8601
|
|
61
|
+
from: z.string().max(40).optional().describe('ISO-8601 start (use together with to)'),
|
|
62
|
+
to: z.string().max(40).optional().describe('ISO-8601 end'),
|
|
58
63
|
},
|
|
59
64
|
annotations: READ,
|
|
60
65
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/analytics/overview${query({ range: a.range, from: a.from, to: a.to })}`)));
|
|
61
66
|
server.registerTool('list_templates', {
|
|
62
|
-
title: '
|
|
63
|
-
description: '
|
|
67
|
+
title: 'List templates',
|
|
68
|
+
description: 'Message templates (filter by channel or name). Required scope: analytics:read.',
|
|
64
69
|
inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), channel: z.string().max(32).optional(), limit: limitArg, cursor: cursorArg },
|
|
65
70
|
annotations: READ,
|
|
66
71
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/templates${query({ q: a.q, channel: a.channel, limit: a.limit, cursor: a.cursor })}`)));
|
|
67
72
|
const writable = canListWriteTools(options.scopes);
|
|
68
73
|
if (writable) {
|
|
69
74
|
server.registerTool('create_campaign_draft', {
|
|
70
|
-
title: '
|
|
71
|
-
description: `${WRITE_NOTE}
|
|
72
|
-
'
|
|
75
|
+
title: 'Create campaign draft',
|
|
76
|
+
description: `${WRITE_NOTE} Creates a campaign in \`draft\` status. Audience is given as segment IDs; content inline or via template_id. ` +
|
|
77
|
+
'Example content: {"headings":{"en":"Title"},"contents":{"en":"Body"}}. Run run_campaign_preflight on the draft to audit it before a person sends it.',
|
|
73
78
|
inputSchema: {
|
|
74
79
|
app_id: appIdArg,
|
|
75
80
|
name: z.string().min(2).max(120),
|
|
76
|
-
included_segments: z.array(z.string().min(1).max(64)).max(20).optional().describe('
|
|
81
|
+
included_segments: z.array(z.string().min(1).max(64)).max(20).optional().describe('Included segments; empty means all subscribers.'),
|
|
77
82
|
excluded_segments: z.array(z.string().min(1).max(64)).max(20).optional(),
|
|
78
|
-
channels: z.array(z.string().max(32)).max(10).optional().describe('
|
|
79
|
-
content: z.record(z.string(), z.unknown()).optional().describe('
|
|
83
|
+
channels: z.array(z.string().max(32)).max(10).optional().describe('e.g. ["web_push","android_push","ios_push","email","sms"]'),
|
|
84
|
+
content: z.record(z.string(), z.unknown()).optional().describe('Message content (headings/contents/email_subject…).'),
|
|
80
85
|
template_id: z.string().max(64).optional(),
|
|
81
86
|
labels: z.array(z.string().min(1).max(40)).max(9).optional(),
|
|
82
87
|
},
|
|
@@ -93,20 +98,23 @@ export function createPushizoMcpServer(options) {
|
|
|
93
98
|
...(a.labels ? { labels: a.labels } : {}),
|
|
94
99
|
})));
|
|
95
100
|
server.registerTool('create_segment_draft', {
|
|
96
|
-
title: '
|
|
97
|
-
description: `${WRITE_NOTE}
|
|
101
|
+
title: 'Create segment draft',
|
|
102
|
+
description: `${WRITE_NOTE} Creates a dynamic segment (no effect until used in a campaign). Definition format: ` +
|
|
98
103
|
'{"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.',
|
|
99
104
|
inputSchema: {
|
|
100
105
|
app_id: appIdArg,
|
|
101
106
|
name: z.string().min(1).max(200),
|
|
102
107
|
description: z.string().max(500).optional(),
|
|
103
|
-
definition: z.record(z.string(), z.unknown()).describe('Segment
|
|
108
|
+
definition: z.record(z.string(), z.unknown()).describe('Segment definition (all/any/none condition groups).'),
|
|
104
109
|
},
|
|
105
110
|
annotations: WRITE,
|
|
106
111
|
}, async (a) => run(() => api.request('POST', `/v1/apps/${app(a.app_id)}/mcp/segment-drafts`, { name: a.name, ...(a.description ? { description: a.description } : {}), definition: a.definition })));
|
|
107
112
|
}
|
|
108
113
|
registerReadTools(server, kit);
|
|
109
114
|
registerInsightTools(server, kit);
|
|
115
|
+
registerDataTools(server, kit);
|
|
116
|
+
registerEngageTools(server, kit);
|
|
117
|
+
registerOpsTools(server, kit);
|
|
110
118
|
if (writable)
|
|
111
119
|
registerWriteTools(server, kit);
|
|
112
120
|
return server;
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAa1C,6GAA6G;AAC7G,MAAM,UAAU,iBAAiB,CAAC,MAAqC;IACrE,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/stdio.js
CHANGED
|
@@ -11,12 +11,12 @@ import { createPushizoMcpServer } from './server.js';
|
|
|
11
11
|
*/
|
|
12
12
|
const apiKey = process.env.PUSHIZO_API_KEY?.trim();
|
|
13
13
|
if (!apiKey) {
|
|
14
|
-
console.error('PUSHIZO_API_KEY
|
|
14
|
+
console.error('PUSHIZO_API_KEY is not set.');
|
|
15
15
|
process.exit(1);
|
|
16
16
|
}
|
|
17
17
|
const baseUrl = process.env.PUSHIZO_API_URL?.trim() || 'https://api.pushizo.com';
|
|
18
18
|
if (!/^https:\/\//.test(baseUrl) && !/^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?(\/|$)/.test(baseUrl)) {
|
|
19
|
-
console.error('PUSHIZO_API_URL https
|
|
19
|
+
console.error('PUSHIZO_API_URL must use https (http://localhost is accepted for local development).');
|
|
20
20
|
process.exit(1);
|
|
21
21
|
}
|
|
22
22
|
const server = createPushizoMcpServer({
|
|
@@ -24,5 +24,5 @@ const server = createPushizoMcpServer({
|
|
|
24
24
|
defaultAppId: process.env.PUSHIZO_APP_ID?.trim() || undefined,
|
|
25
25
|
});
|
|
26
26
|
await server.connect(new StdioServerTransport());
|
|
27
|
-
console.error(`Pushizo MCP
|
|
27
|
+
console.error(`Pushizo MCP server (stdio) ready: ${baseUrl}`);
|
|
28
28
|
//# sourceMappingURL=stdio.js.map
|
package/dist/stdio.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;AACnD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,
|
|
1
|
+
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;AACnD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,yBAAyB,CAAC;AACjF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACrG,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,sBAAsB,CAAC;IACpC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACxE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS;CAC9D,CAAC,CAAC;AACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
import { type ToolKit } from './kit.js';
|
|
3
|
+
/**
|
|
4
|
+
* Veri ve yapılandırma okuma araçları (public API ↔ MCP eşitliği): organizasyon ve app'ler, kullanıcı listesi, şirketler
|
|
5
|
+
* (ADR-0090), ilgi etiketleri ve kişi başına sıklık (ADR-0081), SQL sorgu ve SQL segment (ADR-0087), veri boru hattı
|
|
6
|
+
* (ADR-0088), ambar segmenti (ADR-0091), ambar dışa aktarımı, reverse ETL, dinamik içerik ve webhook'lar. Hepsi mevcut
|
|
7
|
+
* public API uçlarını çağırır; yetki her çağrıda sunucuda denetlenir. Kimlik bilgisi yöneten (API anahtarı, kimlik
|
|
8
|
+
* anahtarı), indirme bağlantısı taşıyan (dışa aktarım, Wallet kartı, kişi verisi dışa aktarımı) uçlar bilerek yoktur.
|
|
9
|
+
* `run_sql_query` yalnız SELECT çalıştırır (sunucu doğrular, salt okunur transaction); `preview_data_transform` kuru
|
|
10
|
+
* çalıştırmadır, kayıt yazmaz.
|
|
11
|
+
*/
|
|
12
|
+
export declare function registerDataTools(server: McpServer, kit: ToolKit): void;
|
|
13
|
+
//# sourceMappingURL=tools-data.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools-data.d.ts","sourceRoot":"","sources":["../src/tools-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAqF,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAE3H;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAsevE"}
|