Docs

Developer Integration

Connect todance.today to Telegram, AI tools, and automated workflows.

Telegram Auto-Post

Premium
Automatically post new events to your Telegram channel when you publish them on todance.today. Requires a Premium organizer account.
Step 1 — Create a Telegram Bot
  1. 1. Open Telegram and search for @BotFather.
  2. 2. Send /newbot and follow the prompts.
  3. 3. Copy the Bot Token — it looks like 123456:ABC-DEF...
Step 2 — Add the Bot to Your Channel
  1. 1. Open your Telegram channel → Administrators → Add Administrator.
  2. 2. Search for your bot by username and grant Post Messages permission.
  3. 3. Find your Channel ID: forward any message from the channel to @userinfobot. The ID starts with -100...
Step 3 — Connect in Your Profile
  1. 1. Go to Profile → Social Media & AI Settings.
  2. 2. Paste your Bot Token and Channel ID.
  3. 3. Enable Auto-post to Telegram.
  4. 4. Next time you publish an event, it will be posted automatically.

AI / MCP Integration

Connect todance.today to Claude Desktop, Cursor, or any MCP-compatible AI tool. Create, update, and manage events by simply talking to your AI assistant.
Step 1 — Generate an API Key
  1. 1. Go to your Profile → API Keys.
  2. 2. Click Create new key, give it a label (e.g. "Home MCP").
  3. 3. Copy the key immediately — it is shown only once.
Step 2 — Install Node.jsDownload and install Node.js LTS from nodejs.org (one-time setup, no coding required).
Step 3 — Configure Claude DesktopOpen the Claude Desktop config file in a text editor:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Paste the following (replace tdapi_YOUR_KEY_HERE with your key):
{
  "mcpServers": {
    "todance": {
      "command": "npx",
      "args": ["-y", "todance-mcp"],
      "env": {
        "TODANCE_API_KEY": "tdapi_YOUR_KEY_HERE"
      }
    }
  }
}
Step 4 — Restart Claude Desktop & Start CreatingRestart Claude Desktop completely. In the chat window click the + icon, then under Connectors you will find todance. Click Manage to inspect all available tools.
"Create a weekly Bachata social every Friday in August, 20–23h, at Tanzschule Mitte, Torstraße 20 Berlin"
Available AI Tools
list_eventsList your upcoming events with stats
create_eventCreate a single or recurring event
update_eventUpdate name, description, or URLs
delete_eventDelete an instance or full series
extend_seriesExtend a recurring series by weeks
get_analyticsViews, registrations, interests
upload_flyerUpload a flyer image, returns flyer_url
list_dancesReference: all valid dance codes

API Reference

All v1 endpoints use Authorization: Bearer tdapi_... — no session required.
POST/api/v1/flyerUpload flyer image → returns flyer_url
GET/api/v1/dancesList all dance type codes
GET/api/v1/eventsList own events + instance counts
POST/api/v1/eventsCreate event or series (JSON)
GET/api/v1/events/[id]Event instance detail
PATCH/api/v1/events/[id]Update name / description / URLs
DELETE/api/v1/events/[id]Delete instance (?deleteSeries=true)
POST/api/v1/events/series/[id]/extendExtend series { weeks: 4|8|12|26|52 }
GET/api/v1/analyticsViews, registrations, interests
Back to Home