# On The Town

> https://onthe.town

On The Town is a club management platform for in-person (IRL) social clubs. Organizers create clubs, set up recurring events, manage members, and match them into small groups at curated venues. Agents are first-class users — no human login required.

## API Access

Base URL: https://onthe.town/api/
OpenAPI schema: https://onthe.town/openapi.json
Full docs: https://onthe.town/docs
Agent manifest: https://onthe.town/.well-known/agent.json

## Authentication

Register your agent (no auth required):

  POST /api/agents/signup/
  Body: { "agent_name": "Your Agent", "agent_type": "autonomous", "operator": "your-org" }
  Returns: { "agent_id": "agent-your-org-abc123", "api_key": "ott_live_..." }

Authenticate all subsequent requests with:

  Authorization: Bearer ott_live_...

## Key Endpoints

Public (no auth):
  POST /api/agents/signup/              - Register agent, get API key
  GET  /api/public/clubs/{url}/         - Public club details
  GET  /api/public/discover/events/     - Browse upcoming events
  GET  /api/public/stats/               - Platform statistics

Authenticated:
  GET/POST   /api/clubs/                - List or create clubs
  POST       /api/clubs/from-prompt/    - Create club from natural language prompt
  GET/PATCH  /api/clubs/{url}/          - Get or update a club
  GET/POST   /api/clubs/{url}/events/   - List or create events
  GET/PATCH  /api/clubs/{url}/events/{id}/ - Get or update an event
  GET/POST   /api/clubs/{url}/members/  - List or add members
  POST       /api/clubs/{url}/events/{id}/groups/form_groups/ - Auto-match members into groups
  GET/POST   /api/clubs/{url}/events/{id}/venues/ - Manage venues
  POST       /api/clubs/{url}/ai-venue-search/ - AI-powered venue suggestions
  POST       /api/clubs/{url}/generate-event/ - AI event generation
  GET        /api/clubs/{url}/analytics/ - Club analytics
  GET        /api/clubs/{url}/dashboard/ - Club dashboard

## Core Concepts

- Club: Top-level entity with a URL slug, members, events, and a public website.
- Event: A scheduled gathering with date, capacity, venues, and member signups.
- Member: A person belonging to a club. Has name, email, and signup question responses.
- Group: A subset of members matched together for an event at a specific venue.
- Venue: A physical location assigned to a group for an event.

## MCP Server

An MCP (Model Context Protocol) server is available for Claude Desktop and other MCP-compatible agents. See https://onthe.town/docs#mcp for setup instructions.

## Rate Limits

API: 50,000 requests/day per user. AI features: 200/day per user. Agent signups: 500/day global.