campertunity-mcp-server 0.0.7 → 0.1.0

package/README.md

@@ -6,6 +6,21 @@ This server implements the Model Context Protocol (MCP) for Campertunity, provid
 
 ## MCP Client Config
 
+```
+{
+  "mcpServers": {
+    "campground-search-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "campertunity-mcp-server@latest"]
+    }
+  }
+}
+```
+
+## Setup
+
+No API key is required to get started. To get higher rate limits, get an API key from [https://campertunity.com/mcp](https://campertunity.com/mcp) and set it as an environment variable:
+
 ```
 {
   "mcpServers": {
@@ -20,20 +35,13 @@ This server implements the Model Context Protocol (MCP) for Campertunity, provid
 }
 ```
 
-## Setup
-
-1. Get your API key from [https://campertunity.com/mcp](https://campertunity.com/mcp)
-2. Set the environment variable:
-   ```
-   CAMPERTUNITY_API_KEY=your_api_key_here
-   ```
-
 ## Available Tools
 
-### place-search
-Search for camping places with various filters and criteria.
+### listing-search
+Search for camping listings with various filters and criteria, or browse all listings with cursor pagination.
 - **Parameters:**
   - `limit`: Number of results (default: 50, max: 1000)
+  - `cursor`: Pagination cursor from a previous response (for browsing without search params)
   - `startDate`: Start date for availability (YYYY-MM-DD)
   - `endDate`: End date for availability (YYYY-MM-DD)
   - `adults`: Number of adults (default: 1)
@@ -41,26 +49,30 @@ Search for camping places with various filters and criteria.
   - `latitude`: Center point latitude
   - `longitude`: Center point longitude
   - `radius`: Search radius in kilometers (default: 20)
+  - `region`: Region/state to search in (geocoded if lat/lng not provided)
+  - `city`: City to search in (geocoded if lat/lng not provided)
+  - `country`: Country to search in (geocoded if lat/lng not provided)
+  - `countryCode`: Country code to search in, e.g. "US", "CA" (geocoded if lat/lng not provided)
   - `filters`: Array of tags to filter by (see Tag enum below)
   - `campgroundDescription`: Natural language description of desired campground features
 
-### place-details
-Get detailed information about a specific camping place.
+### listing-details
+Get detailed information about a specific listing.
 - **Parameters:**
-  - `placeId`: ID of the place to get details for
+  - `listingId`: ID of the listing to get details for
 
-### place-availability
-Check availability of camping sites at a specific place.
+### listing-availability
+Check availability of camping sites at a specific listing.
 - **Parameters:**
-  - `placeId`: ID of the place to check
+  - `listingId`: ID of the listing to check
   - `siteIds`: Optional array of specific site IDs to check
   - `startDate`: Start date (YYYY-MM-DD)
   - `endDate`: End date (YYYY-MM-DD)
 
-### place-book
-Book a camping site.
+### listing-book
+Get a booking URL for a listing.
 - **Parameters:**
-  - `placeId`: ID of the place to book
+  - `listingId`: ID of the listing to book
   - `startDate`: Start date (YYYY-MM-DD)
   - `endDate`: End date (YYYY-MM-DD)
   - `adults`: Number of adults (default: 1)

package/dist/campertunity/client.js

@@ -1,15 +1,17 @@
 const CAMPERTUNITY_API_URL = process.env.CAMPERTUNITY_API_URL || "https://campertunity.com/public/api";
 const CAMPERTUNITY_API_KEY = process.env.CAMPERTUNITY_API_KEY;
-if (!CAMPERTUNITY_API_KEY) {
-    throw new Error("CAMPERTUNITY_API_KEY environment variable is required");
-}
 export class CampertunityClient {
+    get headers() {
+        const h = {};
+        if (CAMPERTUNITY_API_KEY) {
+            h["Authorization"] = `Bearer ${CAMPERTUNITY_API_KEY}`;
+        }
+        return h;
+    }
     async get(path) {
         const response = await fetch(`${CAMPERTUNITY_API_URL}${path}`, {
             method: "GET",
-            headers: {
-                Authorization: `Bearer ${CAMPERTUNITY_API_KEY}`,
-            },
+            headers: this.headers,
         });
         if (!response.ok) {
             throw new Error(`Campertunity API error: ${response.statusText}`);
@@ -20,7 +22,7 @@ export class CampertunityClient {
         const response = await fetch(`${CAMPERTUNITY_API_URL}${path}`, {
             method: "POST",
             headers: {
-                Authorization: `Bearer ${CAMPERTUNITY_API_KEY}`,
+                ...this.headers,
                 "Content-Type": "application/json",
             },
             body: JSON.stringify(data),

package/dist/index.js

@@ -2,10 +2,10 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CampertunityClient } from "./campertunity/client.js";
-import { placeAvailabilityTool } from "./tools/place_availability.js";
-import { placeBookTool } from "./tools/place_book.js";
-import { placeDetailsTool } from "./tools/place_details.js";
-import { placeSearchTool } from "./tools/place_search.js";
+import { listingAvailabilityTool } from "./tools/listing_availability.js";
+import { listingBookTool } from "./tools/listing_book.js";
+import { listingDetailsTool } from "./tools/listing_details.js";
+import { listingSearchTool } from "./tools/listing_search.js";
 const campertunityClient = new CampertunityClient();
 const server = new McpServer({
     name: "campertunity-model-context-protocol-server",
@@ -15,10 +15,10 @@ const server = new McpServer({
         tools: {},
     },
 });
-placeAvailabilityTool(server, campertunityClient);
-placeBookTool(server, campertunityClient);
-placeDetailsTool(server, campertunityClient);
-placeSearchTool(server, campertunityClient);
+listingAvailabilityTool(server, campertunityClient);
+listingBookTool(server, campertunityClient);
+listingDetailsTool(server, campertunityClient);
+listingSearchTool(server, campertunityClient);
 async function runServer() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools/{place_availability.js → listing_availability.js}

@@ -1,14 +1,13 @@
 import { z } from 'zod';
-export const placeAvailabilityTool = (server, campertunityClient) => {
-    server.tool('place-availability', {
-        placeId: z.string().describe('The id of the place to check availability for.'),
+export const listingAvailabilityTool = (server, campertunityClient) => {
+    server.tool('listing-availability', 'Check availability for specific campsites at a listing', {
+        listingId: z.string().describe('The id of the listing to check availability for.'),
         siteIds: z.array(z.string()).optional().describe('The ids of the sites to check availability for.'),
         startDate: z.string().describe('The start date to check availability for. Format: YYYY-MM-DD'),
         endDate: z.string().describe('The end date to check availability for. Format: YYYY-MM-DD'),
-    }, async ({ placeId, siteIds, startDate, endDate }) => {
+    }, async ({ listingId, siteIds, startDate, endDate }) => {
         try {
-            const availability = await campertunityClient.post(`/place/availability`, {
-                placeId,
+            const availability = await campertunityClient.post(`/listings/campgrounds/${encodeURIComponent(listingId)}/availability`, {
                 siteIds,
                 startDate,
                 endDate,

package/dist/tools/{place_book.js → listing_book.js}

@@ -1,22 +1,21 @@
 import { z } from 'zod';
-export const placeBookTool = (server, campertunityClient) => {
-    server.tool('place-book', {
-        placeId: z.string().describe('The id of the place to book.'),
+export const listingBookTool = (server, campertunityClient) => {
+    server.tool('listing-book', 'Get a booking URL for a campground or recreation site', {
+        listingId: z.string().describe('The id of the listing 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 }) => {
+    }, async ({ listingId, startDate, endDate, adults, children }) => {
         try {
-            const availability = await campertunityClient.post(`/place/book`, {
-                placeId,
+            const result = await campertunityClient.post(`/listings/campgrounds/${encodeURIComponent(listingId)}/book`, {
                 startDate,
                 endDate,
                 adults,
                 children,
             });
             return {
-                content: [{ type: 'text', text: JSON.stringify(availability), mimeType: 'application/json' }],
+                content: [{ type: 'text', text: JSON.stringify(result), mimeType: 'application/json' }],
             };
         }
         catch (error) {

package/dist/tools/{place_details.js → listing_details.js}

@@ -1,16 +1,15 @@
 import { z } from 'zod';
-// NOTE: This is a tool since tools are more supported by the MCP protocol
-export const placeDetailsTool = (server, campertunityClient) => {
-    server.tool('place-details', {
-        placeId: z.string().describe('The id of the place to get details for.'),
-    }, async ({ placeId }) => {
+export const listingDetailsTool = (server, campertunityClient) => {
+    server.tool('listing-details', 'Get detailed information about a specific listing', {
+        listingId: z.string().describe('The id of the listing to get details for.'),
+    }, async ({ listingId }) => {
         try {
-            const place = await campertunityClient.get(`/place/details?placeId=${placeId}`);
+            const listing = await campertunityClient.get(`/listings/campgrounds/${encodeURIComponent(listingId)}`);
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify(place),
+                        text: JSON.stringify(listing),
                         mimeType: 'application/json',
                     },
                 ],

package/dist/tools/{place_search.js → listing_search.js}

@@ -49,9 +49,10 @@ export var Tag;
     Tag["waterfall"] = "waterfall";
     Tag["creek"] = "creek";
 })(Tag || (Tag = {}));
-export const placeSearchTool = (server, campertunityClient) => {
-    server.tool('place-search', {
-        limit: z.number().default(50).optional().describe('Number of places to return. Default is 50, max is 1000.'),
+export const listingSearchTool = (server, campertunityClient) => {
+    server.tool('listing-search', 'Search for campgrounds and outdoor recreation listings', {
+        limit: z.number().default(50).optional().describe('Number of listings to return. Default is 50, max is 1000.'),
+        cursor: z.string().optional().describe('Pagination cursor from a previous response. Used for browsing all listings without search params.'),
         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.'),
@@ -59,13 +60,19 @@ export const placeSearchTool = (server, campertunityClient) => {
         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))).optional().describe('Filter out places that have specific tags.'),
+        region: z.string().optional().describe('Region/state to search in. Will be geocoded to coordinates if latitude/longitude not provided.'),
+        city: z.string().optional().describe('City to search in. Will be geocoded to coordinates if latitude/longitude not provided.'),
+        country: z.string().optional().describe('Country to search in. Will be geocoded to coordinates if latitude/longitude not provided.'),
+        countryCode: z.string().optional().describe('Country code to search in (e.g. "US", "CA"). Will be geocoded to coordinates if latitude/longitude not provided.'),
+        filters: z.array(z.enum(Object.values(Tag))).optional().describe('Filter out listings 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 }) => {
+    }, async ({ limit, cursor, startDate, endDate, adults, children, latitude, longitude, radius, region, city, country, countryCode, filters, campgroundDescription }) => {
         try {
             const params = new URLSearchParams();
             if (limit)
                 params.set('limit', limit.toString());
+            if (cursor)
+                params.set('cursor', cursor);
             if (startDate)
                 params.set('startDate', startDate);
             if (endDate)
@@ -80,13 +87,21 @@ export const placeSearchTool = (server, campertunityClient) => {
                 params.set('longitude', longitude.toString());
             if (radius)
                 params.set('radius', radius.toString());
+            if (region)
+                params.set('region', region);
+            if (city)
+                params.set('city', city);
+            if (country)
+                params.set('country', country);
+            if (countryCode)
+                params.set('countryCode', countryCode);
             if (filters)
                 params.set('filters', filters.join(','));
             if (campgroundDescription)
                 params.set('campgroundDescription', campgroundDescription);
-            const places = await campertunityClient.get(`/place/search?${params.toString()}`);
+            const listings = await campertunityClient.get(`/listings?${params.toString()}`);
             return {
-                content: [{ type: 'text', text: JSON.stringify(places), mimeType: 'application/json' }],
+                content: [{ type: 'text', text: JSON.stringify(listings), mimeType: 'application/json' }],
             };
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "campertunity-mcp-server",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "MCP Server for Campertunity - A Model Context Protocol server for interacting with camping and outdoor recreation data",
   "type": "module",
   "bin": {