@suigar/mcp 0.1.0

package/dist/server.d.mts

@@ -0,0 +1,73 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+//#region src/server.d.ts
+declare const createSuigarMcpServer: () => Server<{
+  method: string;
+  params?: {
+    [x: string]: unknown;
+    _meta?: {
+      [x: string]: unknown;
+      progressToken?: string | number | undefined;
+      "io.modelcontextprotocol/related-task"?: {
+        taskId: string;
+      } | undefined;
+    } | undefined;
+  } | undefined;
+}, {
+  method: string;
+  params?: {
+    [x: string]: unknown;
+    _meta?: {
+      [x: string]: unknown;
+      progressToken?: string | number | undefined;
+      "io.modelcontextprotocol/related-task"?: {
+        taskId: string;
+      } | undefined;
+    } | undefined;
+  } | undefined;
+}, {
+  [x: string]: unknown;
+  _meta?: {
+    [x: string]: unknown;
+    progressToken?: string | number | undefined;
+    "io.modelcontextprotocol/related-task"?: {
+      taskId: string;
+    } | undefined;
+  } | undefined;
+}>;
+declare const startSuigarMcpServer: () => Promise<Server<{
+  method: string;
+  params?: {
+    [x: string]: unknown;
+    _meta?: {
+      [x: string]: unknown;
+      progressToken?: string | number | undefined;
+      "io.modelcontextprotocol/related-task"?: {
+        taskId: string;
+      } | undefined;
+    } | undefined;
+  } | undefined;
+}, {
+  method: string;
+  params?: {
+    [x: string]: unknown;
+    _meta?: {
+      [x: string]: unknown;
+      progressToken?: string | number | undefined;
+      "io.modelcontextprotocol/related-task"?: {
+        taskId: string;
+      } | undefined;
+    } | undefined;
+  } | undefined;
+}, {
+  [x: string]: unknown;
+  _meta?: {
+    [x: string]: unknown;
+    progressToken?: string | number | undefined;
+    "io.modelcontextprotocol/related-task"?: {
+      taskId: string;
+    } | undefined;
+  } | undefined;
+}>>;
+//#endregion
+export { createSuigarMcpServer, startSuigarMcpServer };

package/dist/server.mjs

@@ -0,0 +1,431 @@
+import { buildCoinflipTransactionTool, buildLimboTransactionTool, buildPlinkoTransactionTool, buildPvpCoinflipCancelTransactionTool, buildPvpCoinflipCreateTransactionTool, buildPvpCoinflipJoinTransactionTool, buildRangeTransactionTool, buildWheelTransactionTool, readConfigTool, readGameMetadataTool } from "./tools.mjs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+//#region src/server.ts
+const json = (value) => JSON.stringify(value, null, 2);
+const TOOL_DEFINITIONS = [
+	{
+		name: "read_config",
+		description: "Resolve Suigar config for the target network, defaulting to testnet.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				providerUrl: { type: "string" },
+				graphqlUrl: { type: "string" },
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: readConfigTool
+	},
+	{
+		name: "read_game_metadata",
+		description: "Read Suigar game metadata, on-chain settings metadata, and optional currency metadata.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				game: { type: "string" },
+				coinType: { type: "string" },
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: readGameMetadataTool
+	},
+	{
+		name: "build_coinflip_transaction",
+		description: "Build, dry-run, or inspect a Suigar coinflip transaction on testnet by default.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				cashStake: { type: "number" },
+				betCount: { type: "number" },
+				side: {
+					type: "string",
+					enum: ["heads", "tails"]
+				},
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildCoinflipTransactionTool
+	},
+	{
+		name: "build_limbo_transaction",
+		description: "Build, dry-run, or inspect a Suigar limbo transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				cashStake: { type: "number" },
+				betCount: { type: "number" },
+				targetMultiplier: { type: "number" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildLimboTransactionTool
+	},
+	{
+		name: "build_plinko_transaction",
+		description: "Build, dry-run, or inspect a Suigar plinko transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				cashStake: { type: "number" },
+				betCount: { type: "number" },
+				configId: { type: "number" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildPlinkoTransactionTool
+	},
+	{
+		name: "build_wheel_transaction",
+		description: "Build, dry-run, or inspect a Suigar wheel transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				cashStake: { type: "number" },
+				betCount: { type: "number" },
+				configId: { type: "number" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildWheelTransactionTool
+	},
+	{
+		name: "build_range_transaction",
+		description: "Build, dry-run, or inspect a Suigar range transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				cashStake: { type: "number" },
+				betCount: { type: "number" },
+				leftPoint: { type: "number" },
+				rightPoint: { type: "number" },
+				outOfRange: { type: "boolean" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildRangeTransactionTool
+	},
+	{
+		name: "build_pvp_coinflip_create_transaction",
+		description: "Build, dry-run, or inspect a Suigar PvP coinflip create transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				creatorSide: {
+					type: "string",
+					enum: ["heads", "tails"]
+				},
+				isPrivate: { type: "boolean" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildPvpCoinflipCreateTransactionTool
+	},
+	{
+		name: "build_pvp_coinflip_join_transaction",
+		description: "Build, dry-run, or inspect a Suigar PvP coinflip join transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				gameId: { type: "string" },
+				coinType: { type: "string" },
+				stake: { type: "number" },
+				coinObjectIds: {
+					type: "array",
+					items: { type: "string" }
+				},
+				partner: { type: "string" },
+				metadata: {
+					type: "object",
+					additionalProperties: true
+				},
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildPvpCoinflipJoinTransactionTool
+	},
+	{
+		name: "build_pvp_coinflip_cancel_transaction",
+		description: "Build, dry-run, or inspect a Suigar PvP coinflip cancel transaction.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				mode: {
+					type: "string",
+					enum: [
+						"build",
+						"dry-run",
+						"read-only"
+					],
+					default: "build"
+				},
+				network: {
+					type: "string",
+					default: "testnet"
+				},
+				owner: { type: "string" },
+				gameId: { type: "string" },
+				coinType: { type: "string" },
+				config: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			additionalProperties: true
+		},
+		handler: buildPvpCoinflipCancelTransactionTool
+	}
+];
+const createSuigarMcpServer = () => {
+	const server = new Server({
+		name: "suigar",
+		version: "0.0.0"
+	}, { capabilities: { tools: {} } });
+	server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOL_DEFINITIONS.map(({ name, description, inputSchema }) => ({
+		name,
+		description,
+		inputSchema
+	})) }));
+	server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		const tool = TOOL_DEFINITIONS.find((entry) => entry.name === request.params.name);
+		if (!tool) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Unknown tool: ${request.params.name}`
+			}]
+		};
+		try {
+			return { content: [{
+				type: "text",
+				text: json(await tool.handler(request.params.arguments ?? {}))
+			}] };
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error ?? "Unknown error")
+				}]
+			};
+		}
+	});
+	return server;
+};
+const startSuigarMcpServer = async () => {
+	const server = createSuigarMcpServer();
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	return server;
+};
+//#endregion
+export { createSuigarMcpServer, startSuigarMcpServer };