Campertunity MCP Server

Implementation Reference

• src/tools/place_search.ts:74-98 (handler)

  The handler function that builds query parameters from inputs and fetches search results from the Campertunity API endpoint `/place/search`, returning JSON or error.
  async ({ limit, startDate, endDate, adults, children, latitude, longitude, radius, filters, campgroundDescription }) => { try { const params = new URLSearchParams(); if (limit) params.set('limit', limit.toString()); if (startDate) params.set('startDate', startDate); if (endDate) params.set('endDate', endDate); if (adults) params.set('adults', adults.toString()); if (children) params.set('children', children.toString()); if (latitude) params.set('latitude', latitude.toString()); if (longitude) params.set('longitude', longitude.toString()); if (radius) params.set('radius', radius.toString()); if (filters) params.set('filters', filters.join(',')); if (campgroundDescription) params.set('campgroundDescription', campgroundDescription); const places = await campertunityClient.get(`/place/search?${params.toString()}`); return { content: [{ type: 'text', text: JSON.stringify(places), mimeType: 'application/json' }], }; } catch (error) { return { content: [{ type: 'text', text: 'Error: ' + (error as Error).message }], isError: true, }; } }
• src/tools/place_search.ts:62-73 (schema)

  Zod input schema defining parameters for the place search tool, including limits, dates, location filters, and tags.
  { limit: z.number().default(50).optional().describe('Number of places to return. Default is 50, max is 1000.'), startDate: z.string().optional().describe('Start date for availability search. Format: YYYY-MM-DD'), endDate: z.string().optional().describe('End date for availability search. Format: YYYY-MM-DD'), adults: z.number().optional().describe('Number of adults. Default is 1.'), children: z.number().optional().describe('Number of children. Default is 0.'), latitude: z.number().optional().describe('Latitude to filter by.'), longitude: z.number().optional().describe('Longitude to filter by.'), radius: z.number().optional().default(20).describe('Radius to filter by (in km).'), filters: z.array(z.enum(Object.values(Tag) as [string, ...string[]])).optional().describe('Filter out places that have specific tags.'), campgroundDescription: z.string().optional().describe('Describe the campground you are looking for. Note: not the location, but something about the campground like "has a pool" or "near a lake" or "has a playground"'), },
• src/tools/place_search.ts:60-99 (registration)

  The server.tool call that registers the 'place-search' tool with its schema and handler function.
  server.tool( 'place-search', { limit: z.number().default(50).optional().describe('Number of places to return. Default is 50, max is 1000.'), startDate: z.string().optional().describe('Start date for availability search. Format: YYYY-MM-DD'), endDate: z.string().optional().describe('End date for availability search. Format: YYYY-MM-DD'), adults: z.number().optional().describe('Number of adults. Default is 1.'), children: z.number().optional().describe('Number of children. Default is 0.'), latitude: z.number().optional().describe('Latitude to filter by.'), longitude: z.number().optional().describe('Longitude to filter by.'), radius: z.number().optional().default(20).describe('Radius to filter by (in km).'), filters: z.array(z.enum(Object.values(Tag) as [string, ...string[]])).optional().describe('Filter out places that have specific tags.'), campgroundDescription: z.string().optional().describe('Describe the campground you are looking for. Note: not the location, but something about the campground like "has a pool" or "near a lake" or "has a playground"'), }, async ({ limit, startDate, endDate, adults, children, latitude, longitude, radius, filters, campgroundDescription }) => { try { const params = new URLSearchParams(); if (limit) params.set('limit', limit.toString()); if (startDate) params.set('startDate', startDate); if (endDate) params.set('endDate', endDate); if (adults) params.set('adults', adults.toString()); if (children) params.set('children', children.toString()); if (latitude) params.set('latitude', latitude.toString()); if (longitude) params.set('longitude', longitude.toString()); if (radius) params.set('radius', radius.toString()); if (filters) params.set('filters', filters.join(',')); if (campgroundDescription) params.set('campgroundDescription', campgroundDescription); const places = await campertunityClient.get(`/place/search?${params.toString()}`); return { content: [{ type: 'text', text: JSON.stringify(places), mimeType: 'application/json' }], }; } catch (error) { return { content: [{ type: 'text', text: 'Error: ' + (error as Error).message }], isError: true, }; } } );
• src/index.ts:26-26 (registration)

  Invocation of placeSearchTool to register the tool on the MCP server.
  placeSearchTool(server, campertunityClient);
• src/tools/place_search.ts:5-57 (helper)

  Enum defining all possible tags for filtering places, used in the schema for filters parameter.
  export enum Tag { // SiteType tent = 'tent', rv = 'rv', lodging = 'lodging', glamping = 'glamping', cabin = 'cabin', // AccessType driveIn = 'driveIn', walkIn = 'walkIn', equestrian = 'equestrian', boat = 'boat', // Activities biking = 'biking', boating = 'boating', fishing = 'fishing', hiking = 'hiking', horsebackRiding = 'horsebackRiding', paddling = 'paddling', windSports = 'windSports', surfing = 'surfing', swimming = 'swimming', whitewaterPaddling = 'whitewaterPaddling', wildlifeWatching = 'wildlifeWatching', // Amenities picnicTable = 'picnicTable', fires = 'fires', toilets = 'toilets', outhouse = 'outhouse', potableWater = 'potableWater', petFriendly = 'petFriendly', rvHookup = 'rvHookup', rvSanitation = 'rvSanitation', trash = 'trash', showers = 'showers', wifi = 'wifi', handicap = 'handicap', // Terrain beach = 'beach', cave = 'cave', desert = 'desert', forest = 'forest', hotSpring = 'hotSpring', lake = 'lake', river = 'river', swimmingHole = 'swimmingHole', waterfall = 'waterfall', creek = 'creek', }