COGNITION

Windsurf + PitchPace

Agentic IDE with Cascade. Remote MCP servers are configured with serverUrl in mcp_config.json.

IDE

Before you start

A PitchPace tenant — your park on <tenant>.pitchpace.app. Replace <tenant> everywhere below.
An agent key (ppag_…) with the scopes you need — request one if you don’t have it yet. It is a secret: keep it out of repos and URLs.

QUICK START

1
Add the server config
Note the field name: serverUrl, not url. Windsurf also supports ${env:PITCHPACE_AGENT_KEY} interpolation if you prefer the key in your environment.
~/.codeium/windsurf/mcp_config.json
```
{
  "mcpServers": {
    "pitchpace": {
      "serverUrl": "https://<tenant>.pitchpace.app/api/agent/mcp",
      "headers": { "Authorization": "Bearer ppag_<key-id>.<secret>" }
    }
  }
}
```
2
Refresh Cascade
Windsurf Settings → Cascade → MCP servers → Refresh.

VERIFY IT WORKS

Cascade’s MCP panel shows pitchpace with its tools after a refresh. Try the first prompt below.

“List my PitchPace unit types and this week’s per-day occupancy.”

Writes are opt-in: set_occupancy exists only on keys with occupancy:write, and what it writes lowers your public availability immediately — start read-only if you are unsure.

EXAMPLE PROMPTS

List my unit types and this week’s occupancy per day.

Sync my PMS export: set 14 of my 20 pitches occupied for 1–15 August, note "OTA sales".

Which days in August still have at least 5 pitches available?

Read my price grid and list every band with a minimum stay under 3 nights.

REFERENCE

Windsurf MCP docs ↗skill.md — full tool contract prompt.md — agent-executable setup

OTHER AGENTS

ANTHROPICClaude Code

TerminalView guide →

ANTHROPICClaude Desktop

Desktop appView guide →