Connecting to Greenroom
Connecting to Greenroom
Greenroom API v1
Connect calendars, show advancing, promoter events, invoices, booking calls, introductions, and Greenroom match intelligence.
First request
Keys inherit the role and data access of their account. Store them server-side, send them only over HTTPS, and revoke them when an integration is retired.
curl https://greenroom.dance/api/v1/recommendations?minimum_score=70 \
-H "Authorization: Bearer $GREENROOM_API_KEY"Credentials
Keys act as your account. Keep them server-side and revoke anything you no longer use.
Connected apps
Create OAuth clients for account-approved access and signed webhooks for calendar changes. OAuth access tokens use the same role and ownership checks as API keys.
Resource map
Collections use cursor pagination with a 25-item default and a 100-item maximum. Errors return stable codes. The account limit is 300 requests per minute.
The account and profile behind the key.
/api/v1/meCurrent account/api/v1/profileRead or update owned profileAvailability, shows, production, travel, and promoter events.
/api/v1/calendarCalendar and show desk/api/v1/calendar/{id}One calendar entry/api/v1/eventsPromoter events/api/v1/events/{id}One promoter eventOwned invoices with minor-unit amounts.
/api/v1/invoicesInvoices/api/v1/invoices/{id}Read, send, or voidCalls, introductions, markets, and visible counterparts.
/api/v1/opportunitiesBooking opportunities/api/v1/opportunities/{id}One opportunity/api/v1/introsIntroduction movement/api/v1/intros/{id}One introduction/api/v1/locationsSupported markets/api/v1/networkVisible network profilesGreenroom-native fit scoring and reasoning.
/api/v1/recommendationsRanked promoter matchesPublic venue and DJ discovery, no account key required.
/api/v1/public-directorySearch venues or DJsMCP server
Connect any Streamable HTTP MCP client to the same account-scoped data. Read tools search the network and operations. Write tools create calendar entries, promoter events, invoice drafts, booking calls, and intro responses.
Client configuration
Tell Claude Code: “Install the Greenroom MCP.” It can follow the public installer record below. Set your API key as GREENROOM_API_KEY first.
claude mcp add --transport http --scope user \
greenroom https://greenroom.dance/api/mcp \
--header 'Authorization: Bearer ${GREENROOM_API_KEY}'{
"mcpServers": {
"greenroom": {
"url": "https://greenroom.dance/api/mcp",
"headers": {
"Authorization": "Bearer ${GREENROOM_API_KEY}"
}
}
}
}The server exposes greenroom://api/openapi as a machine-readable resource and checks the key again for every tool call. The installer record lives at /api/mcp/install.
Role scoped
DJ keys reach DJ operations. Promoter keys reach promoter operations. Every owned resource is checked against the key owner.
Contact safe
Network and recommendation responses remove private emails, raw interview answers, and unlisted profiles.
Sync ready
Use updated_after on calendars and invoices, created_after on introductions, and nextCursor for the following page.