Roamio MCP Server

Event discovery based on your actual schedule, location, and who's free -- delivered inside iMessage via Poke.

What It Does

• Pulls events from Ticketmaster, Eventbrite, Luma, and ATL Scoop

• Filters them to slots where you're actually free (via your connected calendar)

• Lets you invite friends via a link (no app needed)

• Shows you events where multiple friends are free at the same time

Related MCP server: che-ical-mcp

Setup

1. Install dependencies

pip install -r requirements.txt

2. Add your API keys

cp src/.env.example src/.env
# Fill in TICKETMASTER_API_KEY, EVENTBRITE_API_KEY, LUMA_API_KEY

Get your keys here:

• Ticketmaster: https://developer.ticketmaster.com

• Eventbrite: https://www.eventbrite.com/platform/api

• Luma: https://lu.ma/developers

3. Run the server locally

python src/server.py

Server starts on http://localhost:3000/mcp

4. Connect to Poke via CLI tunnel

npx poke@latest login
npx poke@latest tunnel http://localhost:3000/mcp -n "Roamio" --recipe

This gives you a recipe link + QR code you can share.

5. Deploy to production

Deploy to Railway, Fly.io, or any host that runs Python. Then register the hosted URL directly in Poke Kitchen:

npx poke@latest mcp add https://your-domain.com/mcp -n "Roamio"

Tools Exposed to Poke

Architecture

iMessage / Poke
     |
     v
Poke AI (reads your calendar free slots)
     |
     v
Roamio MCP Server
     |
     +-- Ticketmaster API
     +-- Eventbrite API
     +-- Luma API
     +-- ATL Scoop scraper (AI parser)
     |
     v
Filtered events + friend overlap

Roadmap

• ATL Scoop Instagram scraper + AI caption parser

• Lightweight friend availability web page (roamio.app/avail/:id)

• Persistent DB for friend store (swap out in-memory dict)

• City expansion (swap ATL Scoop for local equivalent per city)

• Poke Kitchen recipe publish + payouts