@withpica/mcp-server 2.1.0

package/dist/utils/credit-gate.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Error handling utilities for MCP server
+ */
+export declare class McpServerError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+export declare class AuthenticationError extends McpServerError {
+    constructor(message?: string, details?: any);
+}
+export declare class ToolExecutionError extends McpServerError {
+    constructor(message: string, details?: any);
+}
+export declare class ResourceError extends McpServerError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Format error for MCP response
+ */
+export declare function formatError(error: any): {
+    type: string;
+    text: string;
+};
+/**
+ * Log error with structured context (JSON to stderr for machine parsing)
+ */
+export declare function logError(context: string, error: any): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,GAAG;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,GAAG,YAAA;CAMvB;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAAgC,EAAE,OAAO,CAAC,EAAE,GAAG;CAIrE;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6FtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAc1D"}

package/dist/utils/errors.js

@@ -0,0 +1,114 @@
+/**
+ * Error handling utilities for MCP server
+ */
+export class McpServerError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "McpServerError";
+        Object.setPrototypeOf(this, McpServerError.prototype);
+    }
+}
+export class AuthenticationError extends McpServerError {
+    constructor(message = "Authentication failed", details) {
+        super(message, "AUTHENTICATION_ERROR", details);
+        this.name = "AuthenticationError";
+    }
+}
+export class ToolExecutionError extends McpServerError {
+    constructor(message, details) {
+        super(message, "TOOL_EXECUTION_ERROR", details);
+        this.name = "ToolExecutionError";
+    }
+}
+export class ResourceError extends McpServerError {
+    constructor(message, details) {
+        super(message, "RESOURCE_ERROR", details);
+        this.name = "ResourceError";
+    }
+}
+/**
+ * Format error for MCP response
+ */
+export function formatError(error) {
+    if (error instanceof McpServerError) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: error.code,
+                message: error.message,
+                details: error.details,
+            }, null, 2),
+        };
+    }
+    // Classify ApiError from SDK layer
+    const status = error?.status;
+    if (status === 0 ||
+        (error instanceof Error && error.message?.includes("timed out"))) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "REQUEST_TIMEOUT",
+                message: "API request timed out after retries. The server may be slow or unreachable.",
+            }, null, 2),
+        };
+    }
+    if (status === 401 || status === 403) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "AUTHENTICATION_ERROR",
+                message: "API authentication failed. Check your PICA_API_KEY is valid.",
+                status,
+            }, null, 2),
+        };
+    }
+    if (status === 429) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "RATE_LIMITED",
+                message: "API rate limit exceeded after retries. Try again in a moment.",
+                status,
+            }, null, 2),
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            type: "text",
+            text: JSON.stringify({
+                error: "UNKNOWN_ERROR",
+                message: error.message,
+            }, null, 2),
+        };
+    }
+    return {
+        type: "text",
+        text: JSON.stringify({
+            error: "UNKNOWN_ERROR",
+            message: String(error),
+        }, null, 2),
+    };
+}
+/**
+ * Log error with structured context (JSON to stderr for machine parsing)
+ */
+export function logError(context, error) {
+    const entry = {
+        level: "error",
+        context,
+        message: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString(),
+    };
+    if (error?.status)
+        entry.status = error.status;
+    if (error?.retryable !== undefined)
+        entry.retryable = error.retryable;
+    if (error instanceof Error && error.stack)
+        entry.stack = error.stack;
+    console.error(JSON.stringify(entry));
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/formatting.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Response formatting utilities
+ *
+ * All formatters return FormattedResult — both human-readable text content
+ * AND a structuredContent object for machine parsing (ADR-104 §1.2).
+ */
+export interface FormattedResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+}
+/**
+ * Format data as JSON text for MCP response
+ */
+export declare function formatAsText(data: any): FormattedResult;
+/**
+ * Completion hint — tells the LLM what's missing on entities just touched.
+ * The LLM decides whether and how to surface these to the user.
+ */
+export interface CompletionHint {
+    gap: string;
+    suggestion: string;
+    count?: number;
+    severity?: "critical" | "important" | "nice_to_have";
+}
+/**
+ * Format success message, with optional completion hints for the guided loop.
+ *
+ * Completion hints are structured data appended to the response so the LLM
+ * can naturally suggest the next step without PICA dictating the conversation.
+ * If no hints are provided, the response is identical to the old format.
+ */
+export declare function formatSuccess(message: string, data?: any, completionHints?: CompletionHint[]): FormattedResult;
+/**
+ * Map raw gap objects from the completeness API into CompletionHints.
+ * The API response shape varies — this handles the known field names.
+ */
+export declare function mapGapsToHints(gaps: any[], limit?: number): CompletionHint[];
+/**
+ * Format array of items with count
+ */
+export declare function formatList<T>(items: T[], metadata?: Record<string, any>): FormattedResult;
+/**
+ * Truncate text to max length
+ */
+export declare function truncate(text: string, maxLength?: number): string;
+/**
+ * Format validation error
+ */
+export declare function formatValidationError(fields: Record<string, string>): FormattedResult;
+/**
+ * Format structured response with dual content blocks:
+ * - Human-readable text (includes full JSON so all MCP clients can read it)
+ * - Machine-parseable structuredContent object
+ */
+export declare function formatStructured(data: any, summary?: string): FormattedResult;
+/**
+ * Format a list with both human summary and structured JSON
+ */
+export declare function formatStructuredList<T>(items: T[], entityName: string, metadata?: Record<string, any>): FormattedResult;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAKvD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,GAAG,EACV,eAAe,CAAC,EAAE,cAAc,EAAE,GACjC,eAAe,CA0BjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,GAAE,MAAU,GAChB,cAAc,EAAE,CAOlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,eAAe,CAsBjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,eAAe,CAWjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAW7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,eAAe,CAOjB"}

package/dist/utils/formatting.js

@@ -0,0 +1,130 @@
+/**
+ * Response formatting utilities
+ *
+ * All formatters return FormattedResult — both human-readable text content
+ * AND a structuredContent object for machine parsing (ADR-104 §1.2).
+ */
+/**
+ * Format data as JSON text for MCP response
+ */
+export function formatAsText(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+/**
+ * Format success message, with optional completion hints for the guided loop.
+ *
+ * Completion hints are structured data appended to the response so the LLM
+ * can naturally suggest the next step without PICA dictating the conversation.
+ * If no hints are provided, the response is identical to the old format.
+ */
+export function formatSuccess(message, data, completionHints) {
+    const response = {
+        success: true,
+        message,
+    };
+    if (data !== undefined) {
+        response.data = data;
+    }
+    if (completionHints && completionHints.length > 0) {
+        response.completion_hints = completionHints;
+        // Append a human-readable summary so all LLMs can see the hints
+        const hintLines = completionHints
+            .map((h) => `- ${h.suggestion}${h.count ? ` (${h.count} works)` : ""}`)
+            .join("\n");
+        message += `\n\nNext steps you could take:\n${hintLines}`;
+        response.message = message; // Keep structuredContent in sync with text
+    }
+    const jsonText = JSON.stringify(response, null, 2);
+    return {
+        content: [{ type: "text", text: `${message}\n\n${jsonText}` }],
+        structuredContent: response,
+    };
+}
+/**
+ * Map raw gap objects from the completeness API into CompletionHints.
+ * The API response shape varies — this handles the known field names.
+ */
+export function mapGapsToHints(gaps, limit = 5) {
+    if (!Array.isArray(gaps))
+        return [];
+    return gaps.slice(0, limit).map((g) => ({
+        gap: g.key || g.field || g.type || "unknown",
+        suggestion: g.suggestion || g.label || g.description || "",
+        severity: g.severity || "important",
+    }));
+}
+/**
+ * Format array of items with count
+ */
+export function formatList(items, metadata) {
+    const response = {
+        count: items.length,
+        items,
+    };
+    if (metadata) {
+        response.metadata = metadata;
+    }
+    const summary = `Found ${items.length} item${items.length !== 1 ? "s" : ""}.`;
+    const jsonText = JSON.stringify(response, null, 2);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${summary}\n\n${jsonText}`,
+            },
+        ],
+        structuredContent: response,
+    };
+}
+/**
+ * Truncate text to max length
+ */
+export function truncate(text, maxLength = 1000) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.substring(0, maxLength) + "... (truncated)";
+}
+/**
+ * Format validation error
+ */
+export function formatValidationError(fields) {
+    const structured = {
+        error: "VALIDATION_ERROR",
+        message: "Validation failed",
+        fields,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(structured, null, 2) }],
+        structuredContent: structured,
+    };
+}
+/**
+ * Format structured response with dual content blocks:
+ * - Human-readable text (includes full JSON so all MCP clients can read it)
+ * - Machine-parseable structuredContent object
+ */
+export function formatStructured(data, summary) {
+    const jsonText = JSON.stringify(data, null, 2);
+    return {
+        content: [
+            {
+                type: "text",
+                text: summary ? `${summary}\n\n${jsonText}` : jsonText,
+            },
+        ],
+        structuredContent: data,
+    };
+}
+/**
+ * Format a list with both human summary and structured JSON
+ */
+export function formatStructuredList(items, entityName, metadata) {
+    const count = items.length;
+    const summary = `Found ${count} ${entityName}${count !== 1 ? "s" : ""}${metadata?.query ? ` matching "${metadata.query}"` : ""}.`;
+    return formatStructured({ count, items, ...metadata }, summary);
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

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

package/dist/utils/mpp.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MPP (Machine Payments Protocol) inline payment helper.
+ *
+ * Wraps mppx to provide per-credit charging for credit-gated MCP operations.
+ * Same pricing as credit packs (pica_25 best-value rate per credit).
+ *
+ * Environment variables:
+ *   MPP_SECRET_KEY          — HMAC key for challenge binding (required for MPP)
+ *   MPP_STRIPE_NETWORK_ID   — Stripe Business Network Profile ID (required for MPP)
+ *   MPP_TESTNET             — set "true" for staging/dev
+ *   STRIPE_SECRET_KEY       — already exists, used by mppx for payment settlement
+ *
+ * If MPP_SECRET_KEY or MPP_STRIPE_NETWORK_ID are not set, MPP is disabled
+ * and the gate falls through to the existing insufficient_credits error.
+ */
+import type { CallToolResult, McpError } from "@modelcontextprotocol/sdk/types.js";
+export declare const MPP_PER_CREDIT_PRICES: Record<string, number>;
+/** Default currency for MPP charges */
+export declare const MPP_DEFAULT_CURRENCY = "usd";
+/** All supported MPP currencies */
+export declare const MPP_SUPPORTED_CURRENCIES: string[];
+/**
+ * Get per-credit amount in minor units for a currency.
+ * Falls back to USD if currency not supported.
+ */
+export declare function getMppPerCreditAmount(currency: string): number;
+/**
+ * Calculate total charge amount for a number of credits.
+ */
+export declare function getMppChargeAmount(creditCost: number, currency: string): {
+    amount: string;
+    currency: string;
+};
+/**
+ * Check if MPP is configured (env vars present).
+ */
+export declare function isMppConfigured(): boolean;
+/**
+ * Get or create the MPP instance. Returns null if not configured.
+ */
+export declare function getMppInstance(): any | null;
+/**
+ * Reset the MPP instance (for testing).
+ */
+export declare function resetMppInstance(): void;
+/**
+ * Extra metadata from the MCP CallToolRequest.
+ * Contains MPP credentials when an agent retries after a 402.
+ */
+export type McpExtra = {
+    _meta?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+/**
+ * Result of an MPP charge attempt.
+ */
+export type MppChargeResult = {
+    status: 402;
+    challenge: McpError;
+} | {
+    status: 200;
+    withReceipt: (result: CallToolResult) => CallToolResult;
+};
+/**
+ * Attempt to charge via MPP for a credit-gated operation.
+ *
+ * @param creditCost  Number of credits the operation costs
+ * @param operationName  Human-readable operation name for the charge description
+ * @param currency  Currency to charge in (default: usd)
+ * @param extra  The MCP request extra/meta (contains credential on retry)
+ * @returns Charge result, or null if MPP is not configured
+ */
+export declare function chargeMpp(creditCost: number, operationName: string, currency?: string, extra?: McpExtra): Promise<MppChargeResult | null>;
+/**
+ * Format a human-readable price for a number of credits in a currency.
+ */
+export declare function formatMppPrice(creditCost: number, currency?: string): string;
+//# sourceMappingURL=mpp.d.ts.map

package/dist/utils/mpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.d.ts","sourceRoot":"","sources":["../../src/utils/mpp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACT,MAAM,oCAAoC,CAAC;AAO5C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWxD,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,mCAAmC;AACnC,eAAO,MAAM,wBAAwB,UAAqC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOtC;AAaD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,GAAG,GAAG,IAAI,CAsB3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAMD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,cAAc,CAAA;CAAE,CAAC;AAE7E;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,MAA6B,EACvC,KAAK,GAAE,QAAa,GACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiBjC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAA6B,GACtC,MAAM,CAKR"}

package/dist/utils/mpp.js

@@ -0,0 +1,136 @@
+/**
+ * MPP (Machine Payments Protocol) inline payment helper.
+ *
+ * Wraps mppx to provide per-credit charging for credit-gated MCP operations.
+ * Same pricing as credit packs (pica_25 best-value rate per credit).
+ *
+ * Environment variables:
+ *   MPP_SECRET_KEY          — HMAC key for challenge binding (required for MPP)
+ *   MPP_STRIPE_NETWORK_ID   — Stripe Business Network Profile ID (required for MPP)
+ *   MPP_TESTNET             — set "true" for staging/dev
+ *   STRIPE_SECRET_KEY       — already exists, used by mppx for payment settlement
+ *
+ * If MPP_SECRET_KEY or MPP_STRIPE_NETWORK_ID are not set, MPP is disabled
+ * and the gate falls through to the existing insufficient_credits error.
+ */
+import { Mppx, stripe } from "mppx/server";
+import { Transport as McpTransport } from "mppx/mcp-sdk/server";
+// ---------------------------------------------------------------------------
+// Per-credit pricing in minor units (pica_25 pack / 25 credits)
+// Verified against live Stripe prices 2026-03-31
+// ---------------------------------------------------------------------------
+export const MPP_PER_CREDIT_PRICES = {
+    gbp: 40, // £0.40
+    usd: 48, // $0.48
+    eur: 44, // €0.44
+    cad: 64, // CA$0.64
+    aud: 72, // A$0.72
+    zar: 396, // R4
+    ngn: 20000, // ₦200
+    kes: 3196, // KSh32
+    brl: 160, // R$1.60
+    mxn: 636, // MX$6
+};
+/** Default currency for MPP charges */
+export const MPP_DEFAULT_CURRENCY = "usd";
+/** All supported MPP currencies */
+export const MPP_SUPPORTED_CURRENCIES = Object.keys(MPP_PER_CREDIT_PRICES);
+/**
+ * Get per-credit amount in minor units for a currency.
+ * Falls back to USD if currency not supported.
+ */
+export function getMppPerCreditAmount(currency) {
+    const key = currency.toLowerCase();
+    return (MPP_PER_CREDIT_PRICES[key] ?? MPP_PER_CREDIT_PRICES[MPP_DEFAULT_CURRENCY]);
+}
+/**
+ * Calculate total charge amount for a number of credits.
+ */
+export function getMppChargeAmount(creditCost, currency) {
+    const perCredit = getMppPerCreditAmount(currency);
+    const total = perCredit * creditCost;
+    return {
+        amount: String(total),
+        currency: currency.toLowerCase(),
+    };
+}
+// ---------------------------------------------------------------------------
+// MPP instance (lazy singleton)
+// ---------------------------------------------------------------------------
+// Use `any` for the instance type — mppx generics are deeply nested and
+// cause "two different types with this name exist" errors with explicit annotations.
+// The runtime behavior is fully type-safe via mppx's internal validation.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let mppInstance = null;
+let mppChecked = false;
+/**
+ * Check if MPP is configured (env vars present).
+ */
+export function isMppConfigured() {
+    return !!(process.env.MPP_SECRET_KEY &&
+        process.env.MPP_STRIPE_NETWORK_ID &&
+        process.env.STRIPE_SECRET_KEY);
+}
+/**
+ * Get or create the MPP instance. Returns null if not configured.
+ */
+export function getMppInstance() {
+    if (mppChecked)
+        return mppInstance;
+    mppChecked = true;
+    if (!isMppConfigured()) {
+        return null;
+    }
+    mppInstance = Mppx.create({
+        methods: [
+            stripe.charge({
+                secretKey: process.env.STRIPE_SECRET_KEY,
+                networkId: process.env.MPP_STRIPE_NETWORK_ID,
+                paymentMethodTypes: ["card", "link"],
+            }),
+        ],
+        secretKey: process.env.MPP_SECRET_KEY,
+        realm: "withpica.com",
+        transport: McpTransport.mcpSdk(),
+    });
+    return mppInstance;
+}
+/**
+ * Reset the MPP instance (for testing).
+ */
+export function resetMppInstance() {
+    mppInstance = null;
+    mppChecked = false;
+}
+/**
+ * Attempt to charge via MPP for a credit-gated operation.
+ *
+ * @param creditCost  Number of credits the operation costs
+ * @param operationName  Human-readable operation name for the charge description
+ * @param currency  Currency to charge in (default: usd)
+ * @param extra  The MCP request extra/meta (contains credential on retry)
+ * @returns Charge result, or null if MPP is not configured
+ */
+export async function chargeMpp(creditCost, operationName, currency = MPP_DEFAULT_CURRENCY, extra = {}) {
+    const mpp = getMppInstance();
+    if (!mpp)
+        return null;
+    const { amount, currency: chargeCurrency } = getMppChargeAmount(creditCost, currency);
+    const handler = mpp.charge({
+        amount,
+        currency: chargeCurrency,
+        description: `${operationName} (${creditCost} pica credit${creditCost !== 1 ? "s" : ""})`,
+    });
+    const result = await handler(extra);
+    return result;
+}
+/**
+ * Format a human-readable price for a number of credits in a currency.
+ */
+export function formatMppPrice(creditCost, currency = MPP_DEFAULT_CURRENCY) {
+    const perCredit = getMppPerCreditAmount(currency);
+    const total = (perCredit * creditCost) / 100;
+    const cur = currency.toUpperCase();
+    return `${total.toFixed(2)} ${cur}`;
+}
+//# sourceMappingURL=mpp.js.map

package/dist/utils/mpp.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@withpica/mcp-server",
+  "version": "2.1.0",
+  "description": "MCP Server for PICA Platform - enables AI assistants to interact with PICA",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "pica-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "pica",
+    "ai",
+    "assistant",
+    "claude",
+    "chatgpt"
+  ],
+  "author": "PICA Platform",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "mppx": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.10.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}