EventHorizon MCP Server

Instructions

Implementation Reference

• src/index.ts:92-105 (handler)

  The async handler function that executes the 'get_event' tool: fetches the event using apiClient.getEvent, formats it, and returns the response or error.

  async ({ event_id }) => {
    try {
      const apiClient = getClient();
      const event = await apiClient.getEvent(event_id);
      return {
        content: [{ type: 'text', text: formatEvent(event) }]
      };
    } catch (error) {
      return {
        content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
        isError: true
      };
    }
  }

• src/index.ts:89-91 (schema)

  Zod input schema defining the 'event_id' parameter for the 'get_event' tool.

  {
    event_id: z.number().describe('The ID of the event to retrieve')
  },

• src/index.ts:86-106 (registration)

  Registration of the 'get_event' tool on the MCP server using server.tool().

  server.tool(
    'get_event',
    'Get detailed information about a specific event by its ID.',
    {
      event_id: z.number().describe('The ID of the event to retrieve')
    },
    async ({ event_id }) => {
      try {
        const apiClient = getClient();
        const event = await apiClient.getEvent(event_id);
        return {
          content: [{ type: 'text', text: formatEvent(event) }]
        };
      } catch (error) {
        return {
          content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
          isError: true
        };
      }
    }
  );

• src/index.ts:29-38 (helper)

  Helper function used by the handler to format the event data into a readable string.

  function formatEvent(event: Event): string {
    return `Event: ${event.title} (ID: ${event.id})
    Description: ${event.description}
    Location: ${event.location}
    Start: ${event.start_time}
    End: ${event.end_time}
    Capacity: ${event.capacity}
    Organizer: ${event.organizer.username}
    Registered: ${event.is_registered ? 'Yes' : 'No'}`;
  }

• src/api-client.ts:121-128 (helper)

  API client method called by the tool handler to fetch event details via HTTP GET request.

  async getEvent(eventId: number): Promise<Event> {
    try {
      const response: AxiosResponse<Event> = await this.client.get(`/api/events/${eventId}/`);
      return response.data;
    } catch (error) {
      throw new Error(`Failed to get event ${eventId}: ${getErrorMessage(error)}`);
    }
  }