OPENAI

Codex + PitchPace

OpenAI’s coding agent for terminal and IDE. Registers HTTP MCP servers with bearer auth from an environment variable.

TerminalIDE

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

Register the server

Terminal

codex mcp add pitchpace \
  --url https://<tenant>.pitchpace.app/api/agent/mcp \
  --bearer-token-env-var PITCHPACE_AGENT_KEY

2
Export your key
Add it to your shell profile so Codex finds it in every session.
Terminal
```
export PITCHPACE_AGENT_KEY="ppag_<key-id>.<secret>"
```

Or configure by file

The CLI command above writes the same thing here.

~/.codex/config.toml

[mcp_servers.pitchpace]
url = "https://<tenant>.pitchpace.app/api/agent/mcp"
bearer_token_env_var = "PITCHPACE_AGENT_KEY"

VERIFY IT WORKS

`codex mcp list` shows pitchpace. In a Codex session, 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

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

OTHER AGENTS

ANTHROPICClaude Code

TerminalView guide →

ANTHROPICClaude Desktop

Desktop appView guide →