EventHorizon MCP Server

Instructions

Implementation Reference

• src/index.ts:279-300 (registration)

  MCP tool registration for 'manage_registration', including description, input schema, and inline handler function that delegates to API client.
  server.tool( 'manage_registration', 'Manage a registration (approve, waitlist, or cancel). Only available to the event organizer.', { registration_id: z.number().describe('The ID of the registration to manage'), action: z.enum(['approve', 'waitlist', 'cancel']).describe('Action to take on the registration') }, async ({ registration_id, action }) => { try { const apiClient = getClient(); const registration = await apiClient.manageRegistration(registration_id, action); return { content: [{ type: 'text', text: `Registration ${action}d successfully!\n\n${formatRegistration(registration)}` }] }; } catch (error) { return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } );
• src/api-client.ts:182-189 (handler)

  Core handler logic in API client: performs HTTP POST request to backend API endpoint `/api/registrations/{id}/manage/` with action.
  async manageRegistration(registrationId: number, action: 'approve' | 'waitlist' | 'cancel'): Promise<Registration> { try { const response: AxiosResponse<Registration> = await this.client.post(`/api/registrations/${registrationId}/manage/`, { action }); return response.data; } catch (error) { throw new Error(`Failed to manage registration ${registrationId}: ${getErrorMessage(error)}`); } }
• src/index.ts:282-285 (schema)

  Zod input schema defining parameters for the tool: registration_id (number) and action (enum: approve, waitlist, cancel).
  { registration_id: z.number().describe('The ID of the registration to manage'), action: z.enum(['approve', 'waitlist', 'cancel']).describe('Action to take on the registration') },
• src/index.ts:40-49 (helper)

  Helper function to format registration data for display in tool responses.
  // Helper to format registration for display function formatRegistration(reg: Registration): string { const eventInfo = typeof reg.event === 'object' ? reg.event.title : `Event ID: ${reg.event}`; const userInfo = typeof reg.user === 'object' ? reg.user.username : `User ID: ${reg.user}`; return `Registration (ID: ${reg.id}) Event: ${eventInfo} User: ${userInfo} Status: ${reg.status} Registered at: ${reg.registered_at}`; }