@rapay/mcp-server 1.2.2 → 1.2.4

package/dist/handlers.js

@@ -41,6 +41,8 @@ const RATE_LIMITS = {
     ra_balance: { windowMs: 60000, maxCalls: 10 },
     ra_history: { windowMs: 60000, maxCalls: 10 },
     ra_whoami: { windowMs: 60000, maxCalls: 20 },
+    ra_dashboard: { windowMs: 60000, maxCalls: 5 },
+    ra_dispute: { windowMs: 60000, maxCalls: 5 },
 };
 /**
  * In-memory rate limiter
@@ -278,6 +280,12 @@ export async function handleToolCall(toolName, args) {
             case "ra_whoami":
                 result = await executeWhoami();
                 break;
+            case "ra_dashboard":
+                result = await executeDashboard();
+                break;
+            case "ra_dispute":
+                result = await executeDispute();
+                break;
             default:
                 throw new Error(`Unknown tool: ${toolName}`);
         }
@@ -573,4 +581,18 @@ async function executeWhoami() {
     const cliArgs = ["whoami", "--json"];
     return executeCliCommand(cliArgs);
 }
+/**
+ * Execute ra dashboard command (opens Stripe Dashboard in browser)
+ */
+async function executeDashboard() {
+    const cliArgs = ["dashboard"];
+    return executeCliCommand(cliArgs);
+}
+/**
+ * Execute ra dispute command (opens Stripe Disputes page in browser)
+ */
+async function executeDispute() {
+    const cliArgs = ["dispute"];
+    return executeCliCommand(cliArgs);
+}
 //# sourceMappingURL=handlers.js.map

package/dist/index.d.ts

@@ -13,5 +13,5 @@
  * - Privacy preserved (dumb pipe model intact)
  * - No blockers
  */
-export declare const SERVER_VERSION = "1.2.2";
+export declare const SERVER_VERSION = "1.2.4";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -23,7 +23,7 @@ import { checkForUpdates } from "./version-check.js";
  * Server metadata
  */
 const SERVER_NAME = "rapay-mcp";
-export const SERVER_VERSION = "1.2.2";
+export const SERVER_VERSION = "1.2.4";
 /**
  * Initialize MCP server
  */

package/dist/tools.d.ts

@@ -1,9 +1,9 @@
 /**
  * Ra Pay MCP Server - Tool Definitions
  *
- * 5 MVP Tools:
+ * 7 Tools:
  * - 2 Payment Operations (SENSITIVE)
- * - 3 Query Operations (Read-only)
+ * - 5 Query/Navigation Operations (Read-only)
  *
  * Note: ra_subscribe removed in v1.2.0 for compliance (Session 53)
  *
@@ -11,7 +11,7 @@
  */
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
 /**
- * All 5 MVP tools combined
+ * All 7 tools combined
  */
 export declare const TOOLS: Tool[];
 /**
@@ -24,7 +24,7 @@ export declare const SENSITIVE_TOOLS: Set<string>;
 export declare function isSensitiveTool(toolName: string): boolean;
 /**
  * Compute the integrity hash of the tool definitions
- * Hash is based on tool names and their input schemas (deterministic)
+ * Hash is based on tool names, input schemas, and annotations (deterministic)
  */
 export declare function computeToolHash(): string;
 /**

package/dist/tools.js

@@ -1,9 +1,9 @@
 /**
  * Ra Pay MCP Server - Tool Definitions
  *
- * 5 MVP Tools:
+ * 7 Tools:
  * - 2 Payment Operations (SENSITIVE)
- * - 3 Query Operations (Read-only)
+ * - 5 Query/Navigation Operations (Read-only)
  *
  * Note: ra_subscribe removed in v1.2.0 for compliance (Session 53)
  *
@@ -60,6 +60,13 @@ const PAYMENT_TOOLS = [
             },
             required: ["amount", "recipient_id", "business_purpose", "user_confirmed"],
         },
+        annotations: {
+            title: "Send Payment",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: "ra_refund",
@@ -71,6 +78,13 @@ const PAYMENT_TOOLS = [
             properties: {},
             required: [],
         },
+        annotations: {
+            title: "Process Refund",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
 ];
 /**
@@ -86,6 +100,13 @@ const QUERY_TOOLS = [
             properties: {},
             required: [],
         },
+        annotations: {
+            title: "Check Balance",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     },
     {
         name: "ra_history",
@@ -103,6 +124,13 @@ const QUERY_TOOLS = [
             },
             required: [],
         },
+        annotations: {
+            title: "Transaction History",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     },
     {
         name: "ra_whoami",
@@ -113,10 +141,52 @@ const QUERY_TOOLS = [
             properties: {},
             required: [],
         },
+        annotations: {
+            title: "Account Info",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    {
+        name: "ra_dashboard",
+        description: "Open the Stripe Dashboard in the user's browser. " +
+            "Provides access to the full Stripe account overview including payments, payouts, and settings.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: {
+            title: "Open Dashboard",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    {
+        name: "ra_dispute",
+        description: "Open the Stripe Disputes page in the user's browser. " +
+            "Disputes and chargebacks must be managed through the Stripe Dashboard interface. " +
+            "Respond to disputes within the timeframe to avoid auto-loss.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: {
+            title: "Manage Disputes",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     },
 ];
 /**
- * All 5 MVP tools combined
+ * All 7 tools combined
  */
 export const TOOLS = [...PAYMENT_TOOLS, ...QUERY_TOOLS];
 /**
@@ -137,25 +207,26 @@ export function isSensitiveTool(toolName) {
  */
 /**
  * Expected hash of tool definitions (update when tools change)
- * This is the SHA-256 hash of the sorted tool names and their input schemas.
+ * This is the SHA-256 hash of the sorted tool names, input schemas, and annotations.
  *
  * To regenerate after modifying tools:
  * 1. Run: cd mcp-server && npm run build
  * 2. Run: RAPAY_DEBUG=1 node dist/index.js (will log computed hash)
  * 3. Update this constant with the new hash
  *
- * Last updated: 2026-02-01 (Session 53 subscription removal)
+ * Last updated: 2026-02-08 (Session 64 added annotations to hash)
  */
-const EXPECTED_TOOL_HASH = "c5a4650ce2990d65";
+const EXPECTED_TOOL_HASH = "f5d8adb129c9c36d";
 /**
  * Compute the integrity hash of the tool definitions
- * Hash is based on tool names and their input schemas (deterministic)
+ * Hash is based on tool names, input schemas, and annotations (deterministic)
  */
 export function computeToolHash() {
     // Create a deterministic representation of tools
     const toolData = TOOLS.map((tool) => ({
         name: tool.name,
         inputSchema: tool.inputSchema,
+        annotations: tool.annotations ?? null,
     }))
         .sort((a, b) => a.name.localeCompare(b.name))
         .map((t) => JSON.stringify(t))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rapay/mcp-server",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Ra Pay MCP Server for Claude Desktop and Claude Code - AI Agent Payment Infrastructure",
   "type": "module",
   "main": "dist/index.js",
@@ -49,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.11.0",
     "cross-spawn": "^7.0.6"
   },
   "devDependencies": {