get_programs_by_name
Search for travel programs by name to find specific offerings within the LumbreTravel MCP Server. This tool helps users locate programs using exact or partial name matches.
Instructions
Busca programas de viajes por nombre
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Nombre del programa |
Implementation Reference
- src/handlers/tools.handler.ts:1129-1137 (handler)The handler logic in callTool method that executes the tool: extracts the 'name' parameter, calls the ApiService.getProgramsByName method, and returns the result as a text content block with JSON stringified data.
case 'get_programs_by_name': { const { name } = args as { name: string } const program = await this.apiService.getProgramsByName(name) return { content: [{ type: 'text', text: JSON.stringify(program, null, 2) }] } - src/handlers/tools.handler.ts:31-42 (schema)The tool definition including name, description, and input schema (object with required 'name' string property) in the listTools() method.
name: 'get_programs_by_name', description: 'Busca programas de viajes por nombre', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Nombre del programa' } }, required: ['name'] } - src/services/api.service.ts:93-103 (helper)Supporting utility method in ApiService that sends a POST request to the backend API endpoint '/integrations/mcp/programs/get_programs_by_name' with the 'name' parameter, using authentication headers, and handles the response.
async getProgramsByName (name: string) { const headers = await this.getHeaders() const dataToSend = new URLSearchParams({ name }) const response = await fetch(`${API_CONFIG.baseUrl}/integrations/mcp/programs/get_programs_by_name`, { method: 'POST', headers, body: dataToSend }) return await this.handleResponse<any>(response) - src/index.ts:44-47 (registration)Server request handler registration for CallToolRequestSchema, which routes tool calls to toolsHandler.callTool, enabling execution of get_programs_by_name among others. ListToolsRequestSchema is also registered to expose the tool list.
this.server.setRequestHandler( CallToolRequestSchema, async (request) => await this.toolsHandler.callTool(request.params.name, request.params.arguments, this.server) )