Shared Events Library

Toronto Togather

Togather is a collaboration for the future of events data. We are making a data commons for open events ecosystems.

Getting Started

The SEL API provides read access to public event data without authentication. To submit events, you'll need an API key.

Read Events (No Auth): GET /api/v1/events is publicly accessible
Submit Events (Requires API Key): POST /api/v1/events requires authentication
Get an API Key (Two Options):
- Self-Service: Sign in with GitHub at /dev/login (instant account creation)
- Invitation: Email info@togather.foundation for email/password access
Developer Portal: /dev/login (create and manage API keys)
Comprehensive Guides: Interactive API Docs with authentication details

For AI Agents (MCP)

Connect directly via the Model Context Protocol (MCP) for structured tool access to events, places, and organizations — one call, no scraping, no JSON parsing.

MCP Endpoint (preferred): /mcp (streamable HTTP, API key required — get one free at /dev/login)
MCP Tools: events, add_event, places, organizations, search
No MCP? Use REST directly — filter server-side to avoid large payloads:
GET /api/v1/events?search=open+source&start_date=2026-03-01&limit=10
Full Integration Guide: Interactive API Docs and MCP Server guide
Machine-readable discovery: /llms.txt

Agent Skills (Hermes)

Installable Agent Skills that teach AI assistants how to curate and deliver event picks — no coding required. Compatible with Hermes, Claude Code, Codex, OpenCode, and others.

togather-events-install: Automated daily curation pipeline — polling, cron, chat delivery
togather-events-search: Ad-hoc event queries via REST API and MCP
togather-review: Event review queue triage for server operators
togather-server-ops: Auth, API reference, MCP connectivity reference

Install via Hermes:
hermes skills tap add Togather-Foundation/server
hermes skills install togather-events-install togather-events-search togather-review togather-server-ops

Browse all skills on GitHub

For Coding Agents

Note: Write endpoints require authentication. See Getting Started for API key setup.

GitHub: Togather-Foundation/server
API Endpoints: /api/v1/events, /api/v1/places, /api/v1/organizations
Interactive API Docs: /api/docs (Scalar UI)
OpenAPI Specs: JSON | YAML
Health Check: /health
Version Info: /version

For Humans

About: Togather Foundation
Vision: Explore the Ecosystem
Interactive Docs: Browse the API
Contact: info@togather.foundation

Live Server Stats

Status: Loading...

Version: Loading...

For Bots

Sitemap: /sitemap.xml
Robots: /robots.txt
SEL Profile: /.well-known/sel-profile