OpenRouter MCP Multimodal Server

Instructions

Implementation Reference

• src/tool-handlers/validate-model.ts:7-50 (handler)

  The core handler function that implements the validate_model tool logic: checks if the model cache is valid, verifies if the specified model exists using modelCache.hasModel, and returns JSON {valid: boolean} or an error response.
  export async function handleValidateModel( request: { params: { arguments: ValidateModelToolRequest } }, modelCache: ModelCache ) { const args = request.params.arguments; try { if (!modelCache.isCacheValid()) { return { content: [ { type: 'text', text: 'Model cache is empty or expired. Please call search_models first to populate the cache.', }, ], isError: true, }; } const isValid = modelCache.hasModel(args.model); return { content: [ { type: 'text', text: JSON.stringify({ valid: isValid }), }, ], }; } catch (error) { if (error instanceof Error) { return { content: [ { type: 'text', text: `Error validating model: ${error.message}`, }, ], isError: true, }; } throw error; } }
• src/tool-handlers.ts:302-315 (registration)

  Tool registration in the ListToolsRequest handler, defining the tool name, description, and input schema for MCP clients.
  { name: 'validate_model', description: 'Check if a model ID is valid', inputSchema: { type: 'object', properties: { model: { type: 'string', description: 'The model ID to validate', }, }, required: ['model'], }, },
• src/tool-handlers.ts:363-369 (registration)

  Dispatch logic in the CallToolRequest switch statement that invokes the validate_model handler with the request arguments and modelCache instance.
  case 'validate_model': return handleValidateModel({ params: { arguments: request.params.arguments as unknown as ValidateModelToolRequest } }, this.modelCache);
• src/tool-handlers/validate-model.ts:3-5 (schema)

  TypeScript type definition for the tool's input parameters, matching the JSON schema in registration.
  export interface ValidateModelToolRequest { model: string; }
• src/tool-handlers.ts:305-314 (schema)

  JSON Schema for input validation in the MCP tool specification.
  inputSchema: { type: 'object', properties: { model: { type: 'string', description: 'The model ID to validate', }, }, required: ['model'], },