@suigar/mcp 0.1.0

package/dist/metadata.cjs

@@ -0,0 +1,51 @@
+const require_mcp_support = require("./mcp-support.cjs");
+const require_config = require("./config.cjs");
+let _suigar_currency_registry = require("@suigar/currency-registry");
+let _suigar_game_registry = require("@suigar/game-registry");
+//#region src/metadata.ts
+const listSupportedGames = ({ activeOnly = true } = {}) => (activeOnly ? (0, _suigar_game_registry.getActiveGames)() : (0, _suigar_game_registry.getActiveGames)()).map((game) => ({
+	...game,
+	mcpSupport: require_mcp_support.getMcpSupportForGame(game.id)
+}));
+const getGameMetadata = (game, configInput = {}) => {
+	const resolvedGame = (0, _suigar_game_registry.getGameById)(game) ?? (0, _suigar_game_registry.getGameByAlias)(game);
+	if (!resolvedGame) throw new Error(`Unsupported game: ${game}`);
+	const mcpSupport = require_mcp_support.getMcpSupportForGame(resolvedGame.id);
+	const supportedGameId = mcpSupport.toolSupported ? resolvedGame.id : null;
+	const packageId = supportedGameId ? require_config.resolveGamePackageId(supportedGameId, configInput) : null;
+	const settingsDefinition = (0, _suigar_game_registry.getOnchainGameSettingsDefinition)(resolvedGame.id);
+	const settingsId = supportedGameId ? require_config.resolveGameSettingsId(supportedGameId, configInput) : null;
+	return {
+		...resolvedGame,
+		mcpSupport,
+		packageId,
+		settingsId,
+		onchainSettings: packageId && settingsDefinition ? {
+			definition: settingsDefinition,
+			objectType: (0, _suigar_game_registry.buildOnchainGameSettingsObjectType)(packageId, settingsDefinition),
+			parametersTypePrefix: (0, _suigar_game_registry.buildOnchainGameParametersTypePrefix)(packageId, settingsDefinition)
+		} : null
+	};
+};
+const listConfiguredCurrencies = (configInput = {}) => {
+	const inspection = require_config.inspectResolvedConfig(configInput);
+	return (0, _suigar_currency_registry.buildConfiguredCurrencies)({
+		suiCoinType: inspection.config.suiCoinType,
+		usdcCoinType: inspection.config.usdcCoinType
+	});
+};
+const getCurrencyInfo = (coinType, configInput = {}) => {
+	const configuredCurrencies = listConfiguredCurrencies(configInput);
+	return {
+		coinType,
+		configuredCurrencies,
+		metadata: (0, _suigar_currency_registry.resolveCurrencyMetadata)(coinType, configuredCurrencies)
+	};
+};
+const readConfigMetadata = (configInput = {}) => require_config.inspectResolvedConfig(configInput);
+//#endregion
+exports.getCurrencyInfo = getCurrencyInfo;
+exports.getGameMetadata = getGameMetadata;
+exports.listConfiguredCurrencies = listConfiguredCurrencies;
+exports.listSupportedGames = listSupportedGames;
+exports.readConfigMetadata = readConfigMetadata;

package/dist/metadata.d.cts

@@ -0,0 +1,52 @@
+import { GameMcpSupport } from "./mcp-support.cjs";
+import { ConfigInspection, SuigarConfigInput } from "./types.cjs";
+
+//#region src/metadata.d.ts
+declare const listSupportedGames: ({
+  activeOnly
+}?: {
+  activeOnly?: boolean;
+}) => {
+  mcpSupport: GameMcpSupport;
+  id: import("@suigar/game-registry").GameId;
+  name: string;
+  module: import("@suigar/game-registry").GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: import("@suigar/game-registry").GameStatus;
+  updatedAt?: string;
+}[];
+declare const getGameMetadata: (game: string, configInput?: SuigarConfigInput) => {
+  mcpSupport: GameMcpSupport;
+  packageId: string | null;
+  settingsId: string | null;
+  onchainSettings: {
+    definition: import("@suigar/game-registry").OnchainGameSettingsDefinition;
+    objectType: string;
+    parametersTypePrefix: string;
+  } | null;
+  id: import("@suigar/game-registry").GameId;
+  name: string;
+  module: import("@suigar/game-registry").GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: import("@suigar/game-registry").GameStatus;
+  updatedAt?: string;
+};
+declare const listConfiguredCurrencies: (configInput?: SuigarConfigInput) => import("@suigar/currency-registry").ConfiguredCurrencyEntry[];
+declare const getCurrencyInfo: (coinType: string, configInput?: SuigarConfigInput) => {
+  coinType: string;
+  configuredCurrencies: import("@suigar/currency-registry").ConfiguredCurrencyEntry[];
+  metadata: {
+    symbol: string;
+    name: string;
+    decimals: number;
+  };
+};
+declare const readConfigMetadata: (configInput?: SuigarConfigInput) => ConfigInspection;
+//#endregion
+export { getCurrencyInfo, getGameMetadata, listConfiguredCurrencies, listSupportedGames, readConfigMetadata };

package/dist/metadata.d.mts

@@ -0,0 +1,52 @@
+import { GameMcpSupport } from "./mcp-support.mjs";
+import { ConfigInspection, SuigarConfigInput } from "./types.mjs";
+
+//#region src/metadata.d.ts
+declare const listSupportedGames: ({
+  activeOnly
+}?: {
+  activeOnly?: boolean;
+}) => {
+  mcpSupport: GameMcpSupport;
+  id: import("@suigar/game-registry").GameId;
+  name: string;
+  module: import("@suigar/game-registry").GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: import("@suigar/game-registry").GameStatus;
+  updatedAt?: string;
+}[];
+declare const getGameMetadata: (game: string, configInput?: SuigarConfigInput) => {
+  mcpSupport: GameMcpSupport;
+  packageId: string | null;
+  settingsId: string | null;
+  onchainSettings: {
+    definition: import("@suigar/game-registry").OnchainGameSettingsDefinition;
+    objectType: string;
+    parametersTypePrefix: string;
+  } | null;
+  id: import("@suigar/game-registry").GameId;
+  name: string;
+  module: import("@suigar/game-registry").GameModule;
+  eventTypeName: string;
+  description?: string;
+  aliases: string[];
+  tags?: string[];
+  status?: import("@suigar/game-registry").GameStatus;
+  updatedAt?: string;
+};
+declare const listConfiguredCurrencies: (configInput?: SuigarConfigInput) => import("@suigar/currency-registry").ConfiguredCurrencyEntry[];
+declare const getCurrencyInfo: (coinType: string, configInput?: SuigarConfigInput) => {
+  coinType: string;
+  configuredCurrencies: import("@suigar/currency-registry").ConfiguredCurrencyEntry[];
+  metadata: {
+    symbol: string;
+    name: string;
+    decimals: number;
+  };
+};
+declare const readConfigMetadata: (configInput?: SuigarConfigInput) => ConfigInspection;
+//#endregion
+export { getCurrencyInfo, getGameMetadata, listConfiguredCurrencies, listSupportedGames, readConfigMetadata };

package/dist/metadata.mjs

@@ -0,0 +1,47 @@
+import { getMcpSupportForGame } from "./mcp-support.mjs";
+import { inspectResolvedConfig, resolveGamePackageId, resolveGameSettingsId } from "./config.mjs";
+import { buildConfiguredCurrencies, resolveCurrencyMetadata } from "@suigar/currency-registry";
+import { buildOnchainGameParametersTypePrefix, buildOnchainGameSettingsObjectType, getActiveGames, getGameByAlias, getGameById, getOnchainGameSettingsDefinition } from "@suigar/game-registry";
+//#region src/metadata.ts
+const listSupportedGames = ({ activeOnly = true } = {}) => (activeOnly ? getActiveGames() : getActiveGames()).map((game) => ({
+	...game,
+	mcpSupport: getMcpSupportForGame(game.id)
+}));
+const getGameMetadata = (game, configInput = {}) => {
+	const resolvedGame = getGameById(game) ?? getGameByAlias(game);
+	if (!resolvedGame) throw new Error(`Unsupported game: ${game}`);
+	const mcpSupport = getMcpSupportForGame(resolvedGame.id);
+	const supportedGameId = mcpSupport.toolSupported ? resolvedGame.id : null;
+	const packageId = supportedGameId ? resolveGamePackageId(supportedGameId, configInput) : null;
+	const settingsDefinition = getOnchainGameSettingsDefinition(resolvedGame.id);
+	const settingsId = supportedGameId ? resolveGameSettingsId(supportedGameId, configInput) : null;
+	return {
+		...resolvedGame,
+		mcpSupport,
+		packageId,
+		settingsId,
+		onchainSettings: packageId && settingsDefinition ? {
+			definition: settingsDefinition,
+			objectType: buildOnchainGameSettingsObjectType(packageId, settingsDefinition),
+			parametersTypePrefix: buildOnchainGameParametersTypePrefix(packageId, settingsDefinition)
+		} : null
+	};
+};
+const listConfiguredCurrencies = (configInput = {}) => {
+	const inspection = inspectResolvedConfig(configInput);
+	return buildConfiguredCurrencies({
+		suiCoinType: inspection.config.suiCoinType,
+		usdcCoinType: inspection.config.usdcCoinType
+	});
+};
+const getCurrencyInfo = (coinType, configInput = {}) => {
+	const configuredCurrencies = listConfiguredCurrencies(configInput);
+	return {
+		coinType,
+		configuredCurrencies,
+		metadata: resolveCurrencyMetadata(coinType, configuredCurrencies)
+	};
+};
+const readConfigMetadata = (configInput = {}) => inspectResolvedConfig(configInput);
+//#endregion
+export { getCurrencyInfo, getGameMetadata, listConfiguredCurrencies, listSupportedGames, readConfigMetadata };

package/dist/server.cjs

@@ -0,0 +1,433 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_tools = require("./tools.cjs");
+let _modelcontextprotocol_sdk_server_index_js = require("@modelcontextprotocol/sdk/server/index.js");
+let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
+let _modelcontextprotocol_sdk_types_js = require("@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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.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: require_tools.buildPvpCoinflipCancelTransactionTool
+	}
+];
+const createSuigarMcpServer = () => {
+	const server = new _modelcontextprotocol_sdk_server_index_js.Server({
+		name: "suigar",
+		version: "0.0.0"
+	}, { capabilities: { tools: {} } });
+	server.setRequestHandler(_modelcontextprotocol_sdk_types_js.ListToolsRequestSchema, async () => ({ tools: TOOL_DEFINITIONS.map(({ name, description, inputSchema }) => ({
+		name,
+		description,
+		inputSchema
+	})) }));
+	server.setRequestHandler(_modelcontextprotocol_sdk_types_js.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 _modelcontextprotocol_sdk_server_stdio_js.StdioServerTransport();
+	await server.connect(transport);
+	return server;
+};
+//#endregion
+exports.createSuigarMcpServer = createSuigarMcpServer;
+exports.startSuigarMcpServer = startSuigarMcpServer;

package/dist/server.d.cts

@@ -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 };