place-book
Book campsites and outdoor accommodations by specifying place ID, dates, and number of guests for camping reservations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| placeId | Yes | The id of the place to book. | |
| startDate | No | The start date of the booking. Format: YYYY-MM-DD | |
| endDate | No | The end date of the booking. Format: YYYY-MM-DD | |
| adults | No | Number of adults. Default is 1. | |
| children | No | Number of children. Default is 0. |
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);