An AI assistant such as Claude can look at your events and help with the busywork: list who has registered, add a batch of speakers from a document, draft sessions, or check what's on an agenda. You ask in plain words and the assistant does the lookups for you. It connects to Shoal with an API key, the same kind other tools use.
Set it up
- Open the API page from the menu and create a key. Give it a name like "Claude" so you remember what it is for. Copy the key right away, because Shoal shows it only once.
- Add Shoal to your assistant as a remote server using the address below. Your assistant needs to be able to send your key along with each request (it calls this a header named Authorization with the value Bearer followed by a space and your key).
- Ask something simple first, like "List my Shoal events."
The server address is:
https://www.shoalevents.com/api/mcpClaude Code
Run this once in your terminal, replacing YOUR_KEY with your API key:
claude mcp add --transport http shoal https://www.shoalevents.com/api/mcp --header "Authorization: Bearer YOUR_KEY"Claude Desktop and other apps
Any app that lets you add a remote server by address and set a custom header can use Shoal. Enter the address above, add a header named Authorization with the value Bearer YOUR_KEY, and save. Where to find that setting depends on the app, so look for something like Add MCP Server or Custom Connector in its settings.
What the assistant can do
- Read your events, attendees, speakers, sessions, tracks, sponsors, audiences, pages and notifications.
- Create events (always as drafts) and add or update attendees, speakers, sessions, tracks, sponsors, audiences, pages and notifications.
- It can't delete anything, and it never sends emails. Invitations and tickets still go out only when you send them from the Attendees screen. A notification it adds can show in the attendee app and on phones, so check before you let it send one.