Skip to main content
Glama

Campspot MCP

First MCP server for the Campspot Online Booking API. Talk to your campground's reservations, sites, and rate plans from Claude, Cursor, or any MCP client.

Who is this for?

Campspot is the leading online booking platform for private campgrounds — nearly 2,000 parks and 200,000+ campsites listed on the Campspot Marketplace. Independent campground owners run their day-to-day business in Campspot: setting up sites, adjusting rate plans, watching availability, confirming reservations. This MCP exposes that surface to AI agents so a manager can ask "what's arriving this weekend and what sites are still open for July 4?" and get a real answer instead of a dashboard tour.

Related MCP server: mcp-recreation-gov

Install

pip install -e .

Configure

Request a per-park API key from the Campspot support team (activation is a one-time access fee plus the standard partner authentication flow — see https://support.campspot.com/online-booking-api).

export CAMPSPOT_API_KEY="your-campspot-api-key"
# Optional: override if you are using a sandbox or per-park base URL
# export CAMPSPOT_BASE_URL="https://api.campspot.com"

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "campspot_mcp": {
      "command": "campspot_mcp",
      "env": {
        "CAMPSPOT_API_KEY": "your-campspot-api-key"
      }
    }
  }
}

Use with Claude Code

claude mcp add campspot_mcp -- campspot_mcp --env CAMPSPOT_API_KEY=your-key

Tools

Tool

What it does

health_check

Verifies credentials by hitting /park. If this fails, all other tools will too.

get_park_info

Returns metadata about the configured park (name, timezone, contact, address).

list_sites

Paginated list of campsites at the park. Optional limit and offset.

get_site

Single campsite by id (name, type, capacity, rates).

search_availability

Find sites available across a date range. Optional site_ids to scope.

list_reservations

List reservations filtered by arrival date range and status.

get_reservation

Single reservation by id.

list_rates

List rate plans effective during an optional date range.

Example session

You:    "What's arriving at our park next weekend, and which sites are still open for July 4?"
Claude: *calls list_reservations(start_date="2026-07-04", end_date="2026-07-06") and search_availability(start_date="2026-07-04", end_date="2026-07-07"), summarises the results*

You:    "Pull up reservation 9384."
Claude: *calls get_reservation(9384), shows the guest details*

Engineering

  • Shared httpx.AsyncClient with connection pooling + transport retries (encode/httpx pattern).

  • Typed exception hierarchy (CampspotAuthError, CampspotNotFoundError, CampspotRateLimitError, CampspotAPIError, CampspotConnectionError) with structured fields (http_status, request_id, retry_after).

  • Application-level retry with exponential backoff + full jitter on 429/5xx, honoring Retry-After.

  • isError-compliance: tools raise bare exceptions so FastMCP sets isError=true on the wire. AI agents can distinguish failure from data (Blackwell Systems audit, 54 MCPs / 20 bugs).

  • JSONL audit log per tool call to stderr (or CAMPSPOT_AUDIT_LOG file) — fail-open, secrets redacted, strings truncated to 256 chars.

  • py.typed marker (PEP 561). mypy --strict clean. ruff full rule set clean.

Development

pip install -e ".[dev]"
pytest                       # 23 tests, no live API required (respx mocks)
ruff check src tests         # lint
mypy src                     # strict type-check
CAMPSPOT_API_KEY=... campspot_mcp

License

MIT.

See also

Available Tools

8 tools
get_park_infoA

Get metadata about the configured park (name, timezone, contact info).

Use when: "which park am I configured for?", "what timezone are reservations in?", "show me the address on file".

Inputs: no named parameters. Returns: result

get_reservationA

Get a single reservation by id.

Use when: "pull up reservation 9384", "what's the balance on booking 1102?", "show me the guest details for reservation 445".

Inputs: reservation_id (required). Returns: result

get_siteA

Get details for a single campsite by id.

Use when: "tell me about site 42", "what's the max occupancy of site 17?". Returns the full site record (name, type, capacity, rates).

Inputs: site_id (required). Returns: result

health_checkA

Verify credentials work. If this fails, all other tools will too.

Use when: starting a session, debugging auth, or after rotating CAMPSPOT_API_KEY. Calls GET /park as a lightweight endpoint that exercises the full auth + transport stack.

Inputs: no named parameters. Returns: result

list_ratesA

List rate plans at the park, optionally filtered by effective date.

Use when: "what rate plans are active in July?", "show me all winter rates", "is the weekend plan still configured?".

Args: start_date: ISO date YYYY-MM-DD — only include rate plans effective on or after this date. end_date: ISO date YYYY-MM-DD — only include rate plans effective on or before this date.

Inputs: end_date, start_date. Returns: result

list_reservationsA

List reservations, optionally filtered by arrival date and status.

Use when: "what's arriving this weekend?", "show me pending reservations", "count cancellations last month".

Args: start_date: ISO date YYYY-MM-DD — only include reservations whose arrival is on or after this date. end_date: ISO date YYYY-MM-DD — only include reservations whose arrival is on or before this date. status: one of "confirmed", "pending", "cancelled", or other upstream-defined value. Omit for all statuses. limit: page size (server default applies if omitted). offset: zero-based offset for pagination.

Example: start_date="2026-07-01", end_date="2026-07-31", status="confirmed", limit=25.

Inputs: limit, offset, status, end_date, +1 more. Returns: result

list_sitesA

List campsites at the configured park.

Use when: "what sites do I have?", "show me the first 20 sites", "what's the offset for the next page?". Returns the API's native page shape — dict with items (site records) and pagination metadata.

Example: limit=50, offset=0 — first page of 50 sites.

Inputs: limit, offset. Returns: result

search_availabilityA

Find campsites available across a date range.

Use when: "is there anything open July 4-7?", "what's free next weekend?", "which of these sites is available Aug 1-5?".

Args: start_date: ISO date YYYY-MM-DD (inclusive) end_date: ISO date YYYY-MM-DD (exclusive — night of end_date does not require availability) site_ids: optional comma-separated list of site ids to scope the search. Omit to search the whole park.

Example: start_date="2026-07-04", end_date="2026-07-07".

Inputs: end_date (required), start_date (required), site_ids. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: park info, individual reservation, individual site, health check, rate plans, list reservations, list sites, and availability search. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., get_park_info, list_reservations, search_availability) using lowercase with underscores. No mixed conventions or vague verbs.

    Tool Count5/5

    8 tools is well-scoped for a campsite management server. It covers essential operations without being overly numerous or sparse.

    Completeness4/5

    The tool set covers core read operations and availability search. Missing write operations (e.g., create reservation) but this is likely intentional for a query-focused server.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables restaurant reservation management through SevenRooms API, allowing users to create reservations and query available time slots with guest details and party size information.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI clients to search and browse camping availability across Alberta Parks, BC Parks, and Parks Canada, including front-country and backcountry campgrounds, through a unified set of tools.
      -