Docs

Authentication

Agents are first-class users. Register via the signup endpoint and receive an API key. No browser login required.

Agent Signup

{
  "agent_name": "string",
  "agent_type": "autonomous | assisted | tool",
  "operator": "string",
  "callback_url": "string (optional)"
}

{
  "agent_id": "agent-mycompany-a1b2c3",
  "api_key": "ott_live_... (only shown once)"
}

Agent Profile

API Key Management

Create additional keys or revoke existing ones.

Agents start on the free plan (1 club, 1 city). Upgrade via the subscription endpoints for more capacity.

Core Concepts

Club

— The top-level entity. Identified by a URL slug. Has members, events, a website, and settings.

Event

— A scheduled gathering within a club. Has date, time, capacity, venues, and signups.

Member

— A person who belongs to a club. Separate from agent/organizer accounts.

Venue

— A location for an event. Each event can have multiple venues.

Group

— A subset of members assigned together for an event. Formed via sequential, random, or AI matching.

Signup Question

— Custom questions asked when members join a club. Answers can drive intelligent matching.

Clubs

{
  "name": "Boston Dinner Club",
  "url": "boston-dinner-club",
  "description": "Weekly dinners for young professionals"
}

Club Cities

Events

{
  "name": "Friday Night Dinner",
  "date": "2025-03-14",
  "time": "19:00",
  "capacity": 24,
  "group_size": 6,
  "description": "Join us for dinner at a local restaurant",
  "status": "upcoming"
}

Signup Questions

{
  "question": "What neighborhood do you live in?",
  "question_type": "text",
  "is_required": true,
  "order": 1
}

Members

{
  "name": "Jane Doe",
  "email": "jane@example.com"
}

Venues

Venue Collections

Save reusable sets of venues for quick event setup.

Groups & Matching

Matching Configuration

Matching modes: sequential (default), random, or intelligent (AI-powered based on signup answers).

AI Features

These endpoints use AI to generate content. Rate-limited to 200 calls/day per user.

Create Club from Prompt

{
  "prompt": "A monthly book club for sci-fi lovers in Brooklyn",
  "city": "New York",
  "website_type": "community"
}

Generate Event

Generate Event Description

AI Venue Search

{
  "description": "A cozy Italian restaurant with private dining"
}

Analytics & Dashboard

Range: 30d, 90d, all

Common Workflows

POST /api/agents/signup/                          → get API key
POST /api/clubs/from-prompt/                      → creates club + website + event plan
GET  /api/clubs/my-club/events/                   → see generated events
PATCH /api/clubs/my-club/events/1/                → customize event details

POST /api/clubs/my-club/events/                   → create event
POST /api/clubs/my-club/events/1/venues/           → add venue(s)
PATCH /api/clubs/my-club/events/1/                 → set status to "upcoming"

POST /api/clubs/my-club/events/1/matching-config/  → set matching mode
POST /api/clubs/my-club/events/1/groups/form_groups/ → auto-assign members
GET  /api/clubs/my-club/events/1/groups/           → view formed groups

Error Handling

Standard HTTP status codes.

{ "detail": "Not found." }

{ "error": "Club not found" }

{ "name": ["This field is required."],
  "email": ["Enter a valid email address."] }

Rate Limits

MCP Server

We provide an MCP (Model Context Protocol) server that exposes platform actions as tools. Compatible with Claude, OpenClaw, and other MCP-enabled agent frameworks.

Available Tools

Configuration

export OTT_API_KEY="ott_live_..."
python -m mcp_server

OpenAPI Schema

A machine-readable OpenAPI 3.0 schema is available for automated discovery and client generation.