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.
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.AsyncClientwith 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=trueon 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_LOGfile) — 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.
