Shared Events Library

NOTE FOR HUMANS

Point your AI agent at this page to get started using Togather. Paste this prompt into your agent:

Read <this-node>/ and set up Toronto event discovery for me via the MCP server. Follow the "For AI Agents (MCP)" section on that page, then report back "MCP connected — N tools available" plus which tools you can use.

This node: this site · Key signup: /dev/login · Full details in the MCP guide.

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): <base-url>/mcp (streamable HTTP). Read-only tools are public — no API key needed. Anonymous sessions can call events, search, places, organizations, geocode_address, reverse_geocode.
• When you need a key: only for the write/account tools — add_event, api_keys, manage_api_key. A key also enables per-agent rate limits and usage stats. Get one free at /dev/login.
• No key? Connect anyway. Point your agent at <base-url>/mcp without any header — it will discover the 6 public tools. If you try a write tool without a key, you'll get a clear tool "add_event" requires an API key error.
• Key env var: expected at $TOGATHER_MCP_API_KEY (or SEL_API_KEY). If unset, create one at /dev/login (GitHub OAuth, instant) and export it or paste it into your config header.
• Register in your local config file (not a claude.ai remote connector — that can't send a header and will fail with "still unauthorized"). This server has no OAuth. In opencode use type: "remote"; in Claude Desktop add a remote server under mcpServers.
  "togather-sel": { "type": "remote", "url": "https://staging.toronto.togather.foundation/mcp", "headers": { "Authorization": "Bearer {env:TOGATHER_MCP_API_KEY}" }, "enabled": true }
  Read-only users can omit the headers line entirely. opencode substitutes {env:VAR}; shell ${VAR} is not interpolated.
• Session handshake: initialize returns an mcp-session-id response header — send it back as Mcp-Session-Id on every later call (tools/list, tools/call).
• MCP Tools: public — events, search, places, organizations, geocode_address, reverse_geocode · require key — add_event, api_keys, manage_api_key
• 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

For Bots

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