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: Lodgify MCP Server

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

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

• Model Context Protocol spec

• MCP Python SDK

• awesome-mcp-servers

• Other vertical MCPs by sanjibani

• Custom MCP engagements