# Congressio

> Conference management platform for call for papers, abstract submission, peer review, decisions, program scheduling, attendee registration, ticketing and on-site check-in. Operated by RivTech SAS (Paris, France).

Every page listed below is public — no account is needed to read it. The same URLs also serve Markdown: send `Accept: text/markdown` and you get a markdown body instead of the HTML page.

## When to use Congressio

Reach for Congressio when the task is one of these:

- Running an academic or professional conference's **call for papers**: building the submission form, collecting abstracts/papers with co-authors and file uploads, and enforcing a deadline.
- Organising **peer review**: assigning reviewers (including by bidding or an AI matcher), single- or double-blind rounds, conflict-of-interest detection, rebuttals, and release of accept/reject decisions.
- Publishing a **conference program**: rooms, tracks, sessions, clash detection, an attendee agenda, iCal and PDF export.
- Selling **registrations and tickets**: tiers, discount codes, add-ons, Stripe payments, VAT invoices (incl. Factur-X), refunds and waitlists.
- Running the event **on the day**: QR passes in Apple/Google Wallet, badge scanning, check-in and capacity-gated zones, continuing-education (CPD/CME) credits.
- **Virtual and hybrid** delivery: live or on-demand session streaming, e-poster galleries, live Q&A and polls, and an opt-in attendee directory.
- Looking up **which conferences are currently open** on Congressio, their dates, venue and whether their program is published.

Use something else for:

- Generic event ticketing with no submissions or review (a concert, a meetup).
- Journal or book publishing workflows that are not tied to a conference edition.
- Webinar hosting on its own — streaming here is attached to a conference program.

## How to call Congressio

- [OpenAPI 3.1 specification](https://www.congressio.net/openapi.json): the full machine-readable API surface — load this first and generate tool definitions from it.
- [API reference](https://www.congressio.net/developers): endpoints, authentication, scopes and rate limits in prose.
- `GET https://www.congressio.net/api/v1/public/events`: **no authentication.** The public conference directory as JSON (name, slug, dates, timezone, venue, organizer, whether the program is published). 60 requests/minute per IP.
- `GET https://www.congressio.net/api/v1/public/events/{eventSlug}`: **no authentication.** One public conference, by the slug returned above.
- `GET /api/v1/events`, `/api/v1/events/{eventId}/submissions`, `/api/v1/events/{eventId}/registrations`: an organizer's own data. Requires `Authorization: Bearer cong_live_…` — a scoped key created by an organization admin in *Organization settings → API*. 120 requests/minute per key. An agent cannot mint one itself; ask the user for it.
- `POST /api/v1/events/{eventId}/registrations`: the one write endpoint reachable with an API **key** — registers an attendee and issues their pass. Needs the `registrations:write` scope. It does not take payment. The other writes (create/publish a conference, manage reviewers, release decisions) require an OAuth token rather than a key, because they are attributed to a person; see the connector section below.
- Webhooks (`submission.created`, `review.submitted`, `registration.confirmed`, `decision.released`, `invoice.issued`, …) are HMAC-SHA256 signed; see the API & webhooks guide below.
- [Command-line tool](https://www.congressio.net/cli): the official CLI (`@congressio/cli`). Zero dependencies, no build step, `--json` prints the API payload unchanged. Useful when a shell is cheaper than an HTTP client.
- [API catalog](https://www.congressio.net/.well-known/api-catalog): RFC 9727 linkset, if you would rather discover the above from a well-known URL.

## Connect Congressio to an assistant (MCP)

- **Remote server:** `https://www.congressio.net/api/mcp` — Model Context Protocol over HTTP. Add it as a custom connector in an assistant that supports them (Claude, ChatGPT, Le Chat and others). This is the one to use on the web or a phone, which cannot run a local process.
- **Authentication is OAuth 2.1, and the client sets itself up.** The server supports dynamic client registration (RFC 7591) and advertises itself per RFC 9728, so a connector registers, sends the user through a consent screen, and receives a token. Nothing to paste.
- **Discovery starts here:** `https://www.congressio.net/.well-known/oauth-protected-resource`, which names the authorization server. An unauthenticated call to the endpoint answers 401 with `WWW-Authenticate: Bearer resource_metadata="…"` pointing at the same document.
- **Desktop alternative:** `npx -y @congressio/mcp` speaks the same tools over stdio, for clients that run a local process (Claude Desktop, Claude Code). It takes an API key instead of OAuth.
- **What it can do:** read the public directory, and — once a user authorizes — their own conferences, submissions and attendee lists; create and publish conferences, set the call-for-papers and registration windows, add and assign reviewers, register attendees, and release decisions. Every tool is bounded by that user's real role, so a connector can never do more than the person could in the dashboard.
- **How to set it up:** [https://www.congressio.net/connect](https://www.congressio.net/connect) has the per-assistant steps.

## Rate limits and versioning

- **Pace yourself from the headers, do not guess.** Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (delta-seconds), plus the structured `RateLimit` and `RateLimit-Policy` fields. 60 requests/minute per IP unauthenticated, 120/minute per key.
- **On a 429, obey `Retry-After`.** It is always present on a refusal and says exactly how long to wait.
- **A missing `RateLimit-Remaining` means unknown, not zero.** It is omitted rather than guessed when the counter is briefly unavailable.
- **The major version is in the path** (`/api/v1`). Breaking changes ship as a new prefix; additive changes do not bump it, so ignore response fields you do not recognise.
- **Deprecation is announced in the response**, at least 180 days ahead, via `Deprecation` (RFC 9745) and `Sunset` (RFC 8594) headers plus a `rel="deprecation"` link. Nothing is deprecated today. Policy: https://www.congressio.net/developers#versioning

## Key pages

- [Product overview](https://www.congressio.net/): what the platform does, the eleven feature areas, and the FAQ.
- [Pricing](https://www.congressio.net/pricing): the four plans. Amounts are read live from Stripe in the visitor's currency, so quote this page rather than a cached figure.
- [Public conference directory](https://www.congressio.net/events): every conference currently published on the platform.
- [Documentation index](https://www.congressio.net/docs): 37 guides covering the whole product.
- [Command-line tool](https://www.congressio.net/cli): install and command reference for the official CLI.
- [About](https://www.congressio.net/about): who builds Congressio.
- [Contact](https://www.congressio.net/contact): sales, support and security contacts (hello@congressio.net).
- [Terms of Service](https://www.congressio.net/terms) · [Privacy Policy](https://www.congressio.net/privacy): GDPR roles — the organizer is the controller for participant data, Congressio is the processor.
- [Sitemap](https://www.congressio.net/sitemap.xml): every indexable URL, including each public conference page.

## Getting started

- [What is Congressio?](https://www.congressio.net/docs/welcome): A tour of what Congressio does and how the pieces fit together.
- [The guided setup wizard](https://www.congressio.net/docs/guided-setup): Describe your conference in a sentence and let AI draft the whole setup.
- [Roles, team & access](https://www.congressio.net/docs/roles-and-team): Who can see and do what — organization roles and event roles.
- [Two-factor authentication](https://www.congressio.net/docs/two-factor): Add a second login step with an authenticator app — and where Congressio requires it.

## Setting up your conference

- [Events, settings & publishing](https://www.congressio.net/docs/events-and-publishing): Create an event, set the dates and windows, and take it live.
- [Tracks](https://www.congressio.net/docs/tracks): Organize submissions into tracks, with colors and descriptions.
- [Branding & the public event page](https://www.congressio.net/docs/branding): Logo, colors, and how your public event page is generated.
- [Flyer generator](https://www.congressio.net/docs/flyer): Create social visuals, a poster, and an event image from a template — no design tool needed.

## Call for papers & review

- [Call for papers](https://www.congressio.net/docs/call-for-papers): Build the submission form, set the window, and open for submissions.
- [The form builder](https://www.congressio.net/docs/forms-builder): Build submission, review, decision, and registration forms with 27 field types.
- [Reviewers & the review process](https://www.congressio.net/docs/reviewing): Run a review round with the conductor — configure, assign, collect, decide.
- [Decisions, rebuttals & meta-reviews](https://www.congressio.net/docs/decisions): Turn reviews into decisions, run a rebuttal phase, and notify authors.
- [Camera-ready / final versions](https://www.congressio.net/docs/camera-ready): Collect final versions from accepted authors and (optionally) mint DOIs.

## Registration & attendees

- [Registration, tickets & payments](https://www.congressio.net/docs/registration): Sell tickets with tiers, add-ons, discounts, and group orders.
- [Attendee consent (GDPR)](https://www.congressio.net/docs/consent): Capture structured, auditable consent — and let attendees withdraw it.
- [Check-in, passes & zones](https://www.congressio.net/docs/check-in-passes): Issue QR passes, scan attendees in, and control access by zone.
- [Printing badges](https://www.congressio.net/docs/badges): Print entry badges for attendees, and role badges for the people running the event.
- [CPD / CME credits](https://www.congressio.net/docs/credits): Award continuing-education credits by scanning badges at sessions.
- [Requests & contact](https://www.congressio.net/docs/requests): One inbox for participant requests and public contact messages.

## Program & audience

- [Program, sessions & speakers](https://www.congressio.net/docs/program-speakers): Build the schedule with sessions and speakers — with or without a CFP.
- [Sponsors & exhibitors](https://www.congressio.net/docs/sponsors): Showcase sponsors and capture booth leads.
- [Streaming & recordings](https://www.congressio.net/docs/streaming): Stream sessions live or on demand, gated by ticket tier.
- [Poster gallery](https://www.congressio.net/docs/posters): Turn accepted posters into an interactive public gallery.
- [Live engagement — Q&A, polls, materials](https://www.congressio.net/docs/engagement): Q&A, polls, session materials, and attendee networking.
- [Venue map & floor plans](https://www.congressio.net/docs/venue-map): Upload floor plans and drop labeled pins for attendees.

## Communications & branding

- [Emails, templates & campaigns](https://www.congressio.net/docs/emails): Editable templates, automatic triggers, and one-off campaigns.
- [White-label landing pages](https://www.congressio.net/docs/landing-builder): Build a custom marketing page for your organization (Enterprise).

## AI features

- [AI features & how they're governed](https://www.congressio.net/docs/ai-overview): Everywhere AI helps in Congressio — and the controls that keep it safe.

## Insights & administration

- [Attendee feedback & AI digest](https://www.congressio.net/docs/feedback): See what attendees said and summarize it into action items.
- [Analytics, reports & audit](https://www.congressio.net/docs/analytics-reports): Track decision outcomes, export data, and see who did what.
- [Plans, billing & payouts](https://www.congressio.net/docs/billing): Manage your subscription, get paid for tickets, and issue attendee invoices.
- [API access & webhooks](https://www.congressio.net/docs/api-webhooks): Integrate Congressio with your own systems via API keys and webhooks.
- [Connect an AI assistant](https://www.congressio.net/docs/connect-an-assistant): Add Congressio to Claude, ChatGPT or another assistant so you can ask about your conference in plain language.

## For participants

- [Submitting & tracking a paper (authors)](https://www.congressio.net/docs/author-guide): How authors submit, revise, rebut, and see their decision.
- [Co-authors](https://www.congressio.net/docs/co-authors): See who you share each submission with, who actually has access, and who presents.
- [Reviewing papers (reviewers)](https://www.congressio.net/docs/reviewer-guide): Accept an invitation, bid, work your queue, and submit reviews.
- [Attending the event (attendees)](https://www.congressio.net/docs/attendee-guide): Register, get your pass, build your agenda, and join sessions.