Minestom MCP Server

Instructions

Implementation Reference

• src/minestom/meta.ts:76-105 (handler)

  The implementation of the get_server_info tool handler.

  }).server(async (args) => {
  	const { includeDependencies } = getServerInfoInputSchema.parse(args);
  	const availableTools = getToolNames();
  
  	return getServerInfoOutputSchema.parse({
  		availableTools,
  		dependencies: includeDependencies ? packageJson.dependencies : undefined,
  		description: packageJson.description,
  		knowledgeCatalog: {
  			coveredTopics: knowledgeCatalogMeta.coveredTopics,
  			environmentAwareTools: [
  				"inspect_minestom_environment",
  				"inspect_minestom_build",
  				"suggest_minestom_libraries",
  			],
  			supportsLiveLibraryLookup:
  				knowledgeCatalogMeta.supportsLiveLibraryLookup,
  			updatedOn: knowledgeCatalogMeta.updatedOn,
  			version: knowledgeCatalogMeta.version,
  		},
  		name: packageJson.name,
  		officialSources: knowledgeCatalogMeta.officialSources,
  		runtime: {
  			node: process.version,
  			platform: process.platform,
  		},
  		toolCount: availableTools.length,
  		version: packageJson.version,
  	});
  });

• src/minestom/meta.ts:37-65 (schema)

  Input and output schema definitions for the get_server_info tool.

  const getServerInfoInputSchema = z.object({
  	includeDependencies: z
  		.boolean()
  		.default(false)
  		.describe(
  			"Whether to include runtime dependency versions in the response.",
  		),
  });
  
  const getServerInfoOutputSchema = z.object({
  	availableTools: z.array(z.string()),
  	dependencies: z.record(z.string(), z.string()).optional(),
  	description: z.string(),
  	knowledgeCatalog: z.object({
  		coveredTopics: z.array(minestomTopicSchema),
  		environmentAwareTools: z.array(z.string()),
  		supportsLiveLibraryLookup: z.boolean(),
  		updatedOn: z.string(),
  		version: z.string(),
  	}),
  	name: z.string(),
  	officialSources: z.array(officialLinkSchema),
  	runtime: z.object({
  		node: z.string(),
  		platform: z.string(),
  	}),
  	toolCount: z.number().int(),
  	version: z.string(),
  });

• src/minestom/meta.ts:67-75 (registration)

  The factory function that registers the get_server_info tool definition.

  export function createGetServerInfoTool(
  	getToolNames: () => string[],
  ): TanStackServerTool {
  	return toolDefinition({
  		description:
  			"Use this when you need package metadata, runtime details, tool inventory, or knowledge-catalog coverage for this Minestom MCP server.",
  		inputSchema: getServerInfoInputSchema,
  		name: "get_server_info",
  		outputSchema: getServerInfoOutputSchema,