Skip to main content

What Is the MCP Connector?

The Gathering Organiser MCP Server lets you manage gatherings through conversational AI. Instead of clicking through the admin panel, you can ask Claude to check registrations, update checklists, draft communications, and more; all through natural language.

How it works

MCP stands for Model Context Protocol. It's an open standard that lets AI assistants (like Claude) interact with external tools and services. The Gathering Organiser MCP Server wraps the Riverland Faeries REST API into 25 tools that Claude can call on your behalf.

The flow looks like this:

  1. You ask Claude something like "How many people have registered for Beltane?"
  2. Claude calls the registration_stats tool via the MCP server
  3. The MCP server queries the Riverland Faeries API
  4. The results come back to Claude, who presents them in a readable format

What you can do with it

The MCP server covers seven areas of gathering management:

  • Gathering management: create, update, and review gatherings
  • Registrations: list registrations, update statuses, export data, check stats
  • Budget and finance: generate budget calculations and bilingual financial reports
  • Carpooling and logistics: view carpool matches, update match statuses, check pickup runs
  • Communications: draft emails using bilingual templates (English/Dutch)
  • Checklists: check planning progress, update checklist items, view overdue tasks
  • Wiki pages: read and update gathering wiki content

Two ways to connect

The MCP server supports two transport modes:

Mode Best for Authentication
stdio Local development; running the server on your own machine Static API token
HTTP Production use; connecting to the hosted server at mcp-gatherings.junovy.com Keycloak OAuth 2.0 (signs in with your Junovy Account)

For most organisers, the HTTP mode is the simplest option; you just point Claude at the hosted server and sign in with your Junovy Account. The stdio mode is for developers who want to run the MCP server locally.

Who can use it

You need to be a member of the organiser team for a gathering to manage it via the MCP server. The same permissions that apply in the admin panel apply when using Claude; if you can't do something in the UI, you can't do it via MCP either.

Back to top