place-book

Implementation Reference

• src/tools/place_book.ts:15-33 (handler)

  The main handler logic for the 'place-book' tool. It makes a POST request to the Campertunity API's /place/book endpoint with booking details and returns the response as JSON or an error.

  async ({ placeId, startDate, endDate, adults, children }) => {
    try {
      const availability = await campertunityClient.post(`/place/book`, {
        placeId,
        startDate,
        endDate,
        adults,
        children,
      });
      return {
        content: [{ type: 'text', text: JSON.stringify(availability), mimeType: 'application/json' }],
      };
    } catch (error) {
      return {
        content: [{ type: 'text', text: 'Error: ' + (error as Error).message }],
        isError: true,
      };
    }
  }

• src/tools/place_book.ts:8-14 (schema)

  Zod schema defining the input parameters for the 'place-book' tool: placeId (required), startDate/endDate (optional), adults/children (with defaults).

  {
    placeId: z.string().describe('The id of the place to book.'),
    startDate: z.string().optional().describe('The start date of the booking. Format: YYYY-MM-DD'),
    endDate: z.string().optional().describe('The end date of the booking. Format: YYYY-MM-DD'),
    adults: z.number().default(1).describe('Number of adults. Default is 1.'),
    children: z.number().default(0).describe('Number of children. Default is 0.'),
  },

• src/tools/place_book.ts:5-35 (registration)

  The placeBookTool function that registers the 'place-book' tool on the MCP server using server.tool(), including the tool name, input schema, and handler.

  export const placeBookTool = (server: McpServer, campertunityClient: CampertunityClient) => {
    server.tool(
      'place-book',
      {
        placeId: z.string().describe('The id of the place to book.'),
        startDate: z.string().optional().describe('The start date of the booking. Format: YYYY-MM-DD'),
        endDate: z.string().optional().describe('The end date of the booking. Format: YYYY-MM-DD'),
        adults: z.number().default(1).describe('Number of adults. Default is 1.'),
        children: z.number().default(0).describe('Number of children. Default is 0.'),
      },
      async ({ placeId, startDate, endDate, adults, children }) => {
        try {
          const availability = await campertunityClient.post(`/place/book`, {
            placeId,
            startDate,
            endDate,
            adults,
            children,
          });
          return {
            content: [{ type: 'text', text: JSON.stringify(availability), mimeType: 'application/json' }],
          };
        } catch (error) {
          return {
            content: [{ type: 'text', text: 'Error: ' + (error as Error).message }],
            isError: true,
          };
        }
      }
    );
  };

• src/index.ts:24-24 (registration)

  Invocation of placeBookTool in the main server file, which triggers the registration of the 'place-book' tool.

  placeBookTool(server, campertunityClient);