@fuul/mcp-server 0.2.0

package/dist/tools/tool-schemas.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const listProjectsInputSchema: any;
+export declare const projectIdParamSchema: any;
+export declare const getIncentiveInputSchema: any;
+export declare const getTriggerInputSchema: any;
+export declare const payoutTermSchema: any;
+/** Body must match server PayoutTermDto (see fuul-server payouts/payout-terms/dto/payout-term.dto). */
+export declare const updatePayoutTermInputSchema: any;
+export type UpdatePayoutTermInput = z.infer<typeof updatePayoutTermInputSchema>;
+/** Registered on MCP tools; use {@link updateProjectTierInputSchema} in handlers for full validation. */
+export declare const updateProjectTierFieldsSchema: any;
+export declare const updateProjectTierInputSchema: any;
+export type UpdateProjectTierInput = z.infer<typeof updateProjectTierInputSchema>;
+/** Registered on MCP tools; use {@link updateAudienceInputSchema} in handlers. */
+export declare const updateAudienceFieldsSchema: any;
+export declare const updateAudienceInputSchema: any;
+export type UpdateAudienceInput = z.infer<typeof updateAudienceInputSchema>;
+/** Registered on MCP tools; use {@link updateTriggerInputSchema} in handlers. */
+export declare const updateTriggerFieldsSchema: any;
+export declare const updateTriggerInputSchema: any;
+export type UpdateTriggerInput = z.infer<typeof updateTriggerInputSchema>;
+export declare const listPayoutsPendingApprovalSchema: any;
+export declare const listRewardsPayoutsSchema: any;
+export declare const payoutBatchActionInputSchema: any;
+export type PayoutBatchActionInput = z.infer<typeof payoutBatchActionInputSchema>;
+/** GET .../affiliate-portal/stats — matches fuul-server GetAffiliateStatsDto query names. */
+export declare const getAffiliatePortalStatsSchema: any;
+export type GetAffiliatePortalStatsInput = z.infer<typeof getAffiliatePortalStatsSchema>;
+/** GET .../affiliate-portal/total-stats — matches GetTotalStatsDto. */
+export declare const getProjectAffiliateTotalStatsSchema: any;
+export type GetProjectAffiliateTotalStatsInput = z.infer<typeof getProjectAffiliateTotalStatsSchema>;
+/** GET .../affiliate-portal/global-breakdown — matches GetProjectAffiliatesBreakdownDto (groupBy required). */
+export declare const getProjectAffiliatesBreakdownSchema: any;
+export type GetProjectAffiliatesBreakdownInput = z.infer<typeof getProjectAffiliatesBreakdownSchema>;
+//# sourceMappingURL=tool-schemas.d.ts.map

package/dist/tools/tool-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB,KAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB,KAE/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,KAGlC,CAAC;AAEH,eAAO,MAAM,qBAAqB,KAGhC,CAAC;AAEH,eAAO,MAAM,gBAAgB,KAAoC,CAAC;AAElE,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,KAKtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,yGAAyG;AACzG,eAAO,MAAM,6BAA6B,KAOxC,CAAC;AAEH,eAAO,MAAM,4BAA4B,KAGxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAOlF,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,KAOrC,CAAC;AAEH,eAAO,MAAM,yBAAyB,KAGrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,KAkBpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,KAkBpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gCAAgC,KAI3C,CAAC;AAEH,eAAO,MAAM,wBAAwB,KAOnC,CAAC;AAEH,eAAO,MAAM,4BAA4B,KAOvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIlF,6FAA6F;AAC7F,eAAO,MAAM,6BAA6B,KAQxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,uEAAuE;AACvE,eAAO,MAAM,mCAAmC,KAS9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAKrG,+GAA+G;AAC/G,eAAO,MAAM,mCAAmC,KAY9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}

package/dist/tools/tool-schemas.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+import { writeConfirmationFieldsSchema } from '../agent/write-confirmation.js';
+const uuid = z.string().uuid();
+export const listProjectsInputSchema = z.object({
+    page: z.coerce.number().int().positive().optional().describe('1-based page index; sent as ?page='),
+    query: z.string().optional().describe('Search string; sent as ?query='),
+});
+export const projectIdParamSchema = z.object({
+    project_id: uuid.describe('Project UUID'),
+});
+export const getIncentiveInputSchema = z.object({
+    project_id: uuid,
+    conversion_id: uuid.describe('Incentive (conversion) UUID'),
+});
+export const getTriggerInputSchema = z.object({
+    project_id: uuid,
+    trigger_id: uuid.describe('Trigger UUID'),
+});
+export const payoutTermSchema = z.record(z.string(), z.unknown());
+/** Body must match server PayoutTermDto (see fuul-server payouts/payout-terms/dto/payout-term.dto). */
+export const updatePayoutTermInputSchema = writeConfirmationFieldsSchema.extend({
+    project_id: uuid,
+    conversion_id: uuid.describe('Incentive (conversion) UUID'),
+    payout_term_id: uuid,
+    payout_term: payoutTermSchema.describe('Full payout term payload as returned by get_incentive / GET payout_term, with edits applied.'),
+});
+/** Registered on MCP tools; use {@link updateProjectTierInputSchema} in handlers for full validation. */
+export const updateProjectTierFieldsSchema = writeConfirmationFieldsSchema.extend({
+    project_id: uuid,
+    tier_id: uuid,
+    name: z.string().min(1).max(100).optional(),
+    description: z.union([z.string().min(1).max(500), z.null()]).optional(),
+    rank: z.coerce.number().int().min(1).optional(),
+    audience_id: z.string().uuid().nullable().optional(),
+});
+export const updateProjectTierInputSchema = updateProjectTierFieldsSchema.refine((v) => v.name != null || v.description !== undefined || v.rank != null || v.audience_id !== undefined, { message: 'Provide at least one of: name, description, rank, audience_id' });
+const audienceConditionSchema = z.object({
+    signature: z.string(),
+    parameters: z.record(z.string(), z.unknown()),
+});
+/** Registered on MCP tools; use {@link updateAudienceInputSchema} in handlers. */
+export const updateAudienceFieldsSchema = writeConfirmationFieldsSchema.extend({
+    project_id: uuid,
+    audience_id: uuid,
+    name: z.string().min(1),
+    conditions: z.array(audienceConditionSchema).optional(),
+    condition_match_mode: z.enum(['any', 'all']).optional().describe('Required when conditions is non-empty.'),
+    contractId: z.string().optional(),
+});
+export const updateAudienceInputSchema = updateAudienceFieldsSchema.refine((v) => !v.conditions || v.conditions.length === 0 || (v.condition_match_mode != null && v.condition_match_mode.length > 0), { message: 'condition_match_mode is required when conditions is non-empty' });
+/** Registered on MCP tools; use {@link updateTriggerInputSchema} in handlers. */
+export const updateTriggerFieldsSchema = writeConfirmationFieldsSchema.extend({
+    project_id: uuid,
+    trigger_id: uuid,
+    name: z.string().optional(),
+    description: z.string().optional(),
+    event_type: z.string().optional(),
+    condition_expression: z.string().optional(),
+    amount_expression: z.string().optional(),
+    volume_expression: z.string().optional(),
+    revenue_expression: z.string().optional(),
+    currency_expression: z.string().optional(),
+    volume_currency_expression: z.string().optional(),
+    revenue_currency_expression: z.string().optional(),
+    end_user_identifier_property: z.string().optional(),
+    end_user_identifier_expression: z.string().optional(),
+    payable: z.boolean().optional(),
+    ref: z.string().optional(),
+    contract_ids: z.array(uuid).length(1).optional().describe('Exactly one contract UUID when updating on-chain contract event triggers.'),
+});
+export const updateTriggerInputSchema = updateTriggerFieldsSchema.refine((v) => v.name !== undefined ||
+    v.description !== undefined ||
+    v.event_type !== undefined ||
+    v.condition_expression !== undefined ||
+    v.amount_expression !== undefined ||
+    v.volume_expression !== undefined ||
+    v.revenue_expression !== undefined ||
+    v.currency_expression !== undefined ||
+    v.volume_currency_expression !== undefined ||
+    v.revenue_currency_expression !== undefined ||
+    v.end_user_identifier_property !== undefined ||
+    v.end_user_identifier_expression !== undefined ||
+    v.payable !== undefined ||
+    v.ref !== undefined ||
+    v.contract_ids !== undefined, { message: 'Provide at least one trigger field to patch (e.g. name, description, event_type, expressions, contract_ids).' });
+export const listPayoutsPendingApprovalSchema = z.object({
+    project_id: uuid,
+    page: z.coerce.number().int().positive().optional().describe('Forwarded as ?page='),
+    page_size: z.coerce.number().int().positive().max(100).optional().describe('Forwarded as ?page_size='),
+});
+export const listRewardsPayoutsSchema = z.object({
+    project_id: uuid,
+    page: z.coerce.number().int().positive().optional(),
+    page_size: z.coerce.number().int().positive().max(100).optional(),
+    status: z.string().optional(),
+    from_date: z.string().optional(),
+    to_date: z.string().optional(),
+});
+export const payoutBatchActionInputSchema = writeConfirmationFieldsSchema.extend({
+    project_id: uuid,
+    payout_ids: z.array(uuid).optional().describe('Mutually exclusive with from_date/to_date filters on server.'),
+    from_date: z.string().optional(),
+    to_date: z.string().optional(),
+    user_address: z.string().optional(),
+    affiliate_address: z.string().optional(),
+});
+const dateRangePresetSchema = z.enum(['7d', '30d', '90d', 'MTD', 'QTD', 'custom', 'all']);
+/** GET .../affiliate-portal/stats — matches fuul-server GetAffiliateStatsDto query names. */
+export const getAffiliatePortalStatsSchema = z.object({
+    project_id: uuid,
+    user_identifier: z.string().min(1).describe('Encoded identifier string (e.g. evm:0x..., solana:...).'),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    this_month: z.string().optional().describe('Use "true" for current month (mutually exclusive with from/to).'),
+    conversion_external_id: z.coerce.number().int().min(0).optional(),
+    conversion_name: z.string().optional(),
+});
+/** GET .../affiliate-portal/total-stats — matches GetTotalStatsDto. */
+export const getProjectAffiliateTotalStatsSchema = z.object({
+    project_id: uuid,
+    statuses: z.array(z.string()).optional(),
+    regions: z.array(z.string()).optional(),
+    audiences: z.array(z.string()).optional(),
+    tiers: z.array(z.string().uuid()).optional(),
+    dateRange: dateRangePresetSchema.optional(),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+});
+const breakdownGroupBySchema = z.enum(['audience', 'tier', 'region', 'status']);
+const breakdownSortBySchema = z.enum(['totalReferralVolume', 'revenueFromReferrals', 'earnings', 'pointsPaid']);
+/** GET .../affiliate-portal/global-breakdown — matches GetProjectAffiliatesBreakdownDto (groupBy required). */
+export const getProjectAffiliatesBreakdownSchema = z.object({
+    project_id: uuid,
+    groupBy: breakdownGroupBySchema,
+    dateRange: dateRangePresetSchema.optional(),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+    sortBy: breakdownSortBySchema.optional(),
+    sortOrder: z.enum(['asc', 'desc']).optional(),
+    statuses: z.array(z.string()).optional(),
+    regions: z.array(z.string()).optional(),
+    audiences: z.array(z.string()).optional(),
+    tiers: z.array(z.string().uuid()).optional(),
+});
+//# sourceMappingURL=tool-schemas.js.map

package/dist/tools/tool-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../../src/tools/tool-schemas.ts"],"names":[],"mappings":"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"}

package/dist/util/compact-query.d.ts

@@ -0,0 +1,3 @@
+/** Drop undefined, null, and empty string from a query param object. */
+export declare function compactQuery(params: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=compact-query.d.ts.map

package/dist/util/compact-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-query.d.ts","sourceRoot":"","sources":["../../src/util/compact-query.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErF"}

package/dist/util/compact-query.js

@@ -0,0 +1,5 @@
+/** Drop undefined, null, and empty string from a query param object. */
+export function compactQuery(params) {
+    return Object.fromEntries(Object.entries(params).filter(([, v]) => v !== undefined && v !== null && v !== ''));
+}
+//# sourceMappingURL=compact-query.js.map

package/dist/util/compact-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-query.js","sourceRoot":"","sources":["../../src/util/compact-query.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACjH,CAAC"}

package/dist/util/with-timeout.d.ts

@@ -0,0 +1,12 @@
+export declare class ToolTimeoutError extends Error {
+    readonly operation: string;
+    readonly timeoutMs: number;
+    readonly code: "TOOL_TIMEOUT";
+    constructor(operation: string, timeoutMs: number);
+}
+/**
+ * Fails fast from the caller's perspective if `promise` never settles (e.g. wedged I/O).
+ * The underlying work may still run until its own abort/timeout, if any.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, operation: string): Promise<T>;
+//# sourceMappingURL=with-timeout.d.ts.map

package/dist/util/with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.d.ts","sourceRoot":"","sources":["../../src/util/with-timeout.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;IAIvC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAJ5B,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;gBAG7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;CAM7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB1G"}

package/dist/util/with-timeout.js

@@ -0,0 +1,35 @@
+export class ToolTimeoutError extends Error {
+    operation;
+    timeoutMs;
+    code = 'TOOL_TIMEOUT';
+    constructor(operation, timeoutMs) {
+        super(`Operation "${operation}" timed out after ${timeoutMs}ms`);
+        this.operation = operation;
+        this.timeoutMs = timeoutMs;
+        this.name = 'ToolTimeoutError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Fails fast from the caller's perspective if `promise` never settles (e.g. wedged I/O).
+ * The underlying work may still run until its own abort/timeout, if any.
+ */
+export async function withTimeout(promise, timeoutMs, operation) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => {
+                    reject(new ToolTimeoutError(operation, timeoutMs));
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=with-timeout.js.map

package/dist/util/with-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-timeout.js","sourceRoot":"","sources":["../../src/util/with-timeout.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAI9B;IACA;IAJF,IAAI,GAAG,cAAuB,CAAC;IAExC,YACW,SAAiB,EACjB,SAAiB;QAE1B,KAAK,CAAC,cAAc,SAAS,qBAAqB,SAAS,IAAI,CAAC,CAAC;QAHxD,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAQ;QAG1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAiB,EAAE,SAAiB;IAC5F,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC3B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,MAAM,CAAC,IAAI,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;gBACrD,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@fuul/mcp-server",
+  "version": "0.2.0",
+  "description": "Fuul MCP server for program management via MCP-compatible clients",
+  "keywords": [
+    "Fuul",
+    "Fuul Protocol",
+    "MCP",
+    "Model Context Protocol",
+    "claude-code",
+    "claude-plugin"
+  ],
+  "author": "Fuul Team",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "fuul-mcp": "./dist/cli.js",
+    "fuul-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "cli": "tsx src/cli.ts",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write 'src/**/*.ts' '*.json' 'eslint.config.js' --config ./.prettierrc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7",
+    "open": "^10.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^22.10.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "minimatch": ">=10.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kuyen-labs/mcp_server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kuyen-labs/mcp_server/issues"
+  },
+  "homepage": "https://github.com/kuyen-labs/mcp_server#readme"
+}