# Belong CheckIn

> Belong CheckIn is an AI concierge for events and communities. It helps people
> discover public events, multi-day "event weeks", and venues; buy/redeem
> tickets; check in at venues; and manage communities. Both humans and AI agents
> are first-class consumers: discovery is open and there are dedicated agent
> connectors (MCP + OpenAPI).

## Public content (indexable, server-rendered for crawlers)

- [Home / event discovery](https://checkin.belong.net/)
- Event detail pages: `https://checkin.belong.net/events/{id-or-slug}`
- Event week pages: `https://checkin.belong.net/event-weeks/{slug}`
- [Sitemap index](https://checkin.belong.net/sitemap.xml) — links to
  `sitemap-events.xml` and `sitemap-event-weeks.xml`
- [robots.txt](https://checkin.belong.net/robots.txt)

Event and event-week pages are served as real HTML with Open Graph/Twitter tags
and schema.org JSON-LD (`Event`, `ItemList`) to search engines and AI crawlers.

## For AI agents (capabilities & actions)

Belong exposes a Model Context Protocol (MCP) server and an OpenAPI 3.1 schema.
Public discovery tools (e.g. `discover_events`, `discover_hubs`,
`get_event_details`) work without authentication. Account, organizer, venue, and
ticketing tools require the user's Belong account via OAuth2.

- One-line setup for an existing AI agent:
  `Fetch https://checkin.belong.net/agent-setup/prompt.md`
- Portable organizer skill:
  `https://checkin.belong.net/agent-setup/skills/belong-events/v1/SKILL.md`
- MCP (JSON-RPC 2.0, HTTP):
  `https://join.belong.net/functions/v1/belong-agent-mcp/mcp`
- MCP OAuth metadata:
  `https://join.belong.net/functions/v1/belong-agent-mcp/.well-known/oauth-protected-resource`
  and `.../.well-known/oauth-authorization-server`
- OpenAPI 3.1 (GPT Actions compatible):
  `https://join.belong.net/functions/v1/belong-agent-openapi`
- AI plugin manifest:
  [/.well-known/ai-plugin.json](https://checkin.belong.net/.well-known/ai-plugin.json)
- MCP discovery manifest:
  [/.well-known/mcp.json](https://checkin.belong.net/.well-known/mcp.json)

## Docs

- [AI agent discovery guide](https://checkin.belong.net/) — see `docs/ai/AGENT_DISCOVERY.md` in the repository
- AI access surfaces, MCP tool catalog, and integration guides live under `docs/ai/` and `docs/features/`.

## Optional

- The same content and connectors are served on the events domain
  `https://belong.events/` (sitemap at `https://belong.events/sitemap.xml`).