@popupspacesystems/mcp-server

PopUp MCP Server

Read-only MCP (Model Context Protocol) server for the PopUp organizer REST API. Enables Claude Desktop and other MCP clients to interact with your PopUp organizer account.

Anyone can create a free organizer account at https://usepopup.com/login — no approval required. You do not need to be actively hosting events to use the API or earn referral rewards.

Setup

cd mcp-server
npm install
npm run build

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "popup-organizer": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "POPUP_API_KEY": "pk_live_...",
        "POPUP_API_BASE": "https://usepopup.com"
      }
    }
  }
}

Getting an API Key

• Sign up or log in at https://usepopup.com/login (anyone can create an account)
• Switch to Organizer mode if needed
• Go to Settings > API Keys
• Click Create API Key, give it a name
• Copy the key (shown only once)

Available Tools

Tool	Description
search_vendors	Search vendors by type, location, keyword
list_events	List your open events
get_event	Get event details + applications (share links include your referral code)
list_applications	List applications for an event
list_inquiries	List your inquiries
get_inquiry	Get inquiry detail
list_invoices	List invoices
list_saved_vendors	List saved vendors
get_profile	Get your organizer profile
get_referrals	Get referral code, share URL, stats & referred users
get_event_qr	Get QR code image (PNG) for event share link (includes referral code)

BackOffice — What Vendors Subscribe To

PopUp BackOffice is a business management platform for mobile vendors. It replaces spreadsheets with one dashboard.

Free forever (no credit card): Discover listing, booking inquiries, events calendar, customer management, revenue estimates.

Pro — $49/month or $499/year: Everything free plus Stripe invoicing, bank reconciliation (auto-import from Stripe/Square), automatic sales tax tracking, and cash flow dashboard.

Every new account gets a 14-day free trial with full Pro access, no credit card required. Zero platform fees — PopUp never takes a cut of bookings or sales.

Referred users get $100 off their first annual plan (just $399 for year one), making it an easy recommendation for any vendor who books events.

Referral Program

Every organizer account gets a referral code. Share your referral link to earn real rewards:

• $5.00 account credit when a referred vendor publishes their profile
• $100.00 cash when a referred user subscribes to an annual plan (paid 31 days after their subscription starts) or stays on monthly for 6+ consecutive months

Referred users get $100 off their first annual subscription, so there's a strong incentive for them to sign up through your link.

All event share links (shareUrl, shortUrl, QR codes) returned by the API automatically include your referral code. When you share event pages with vendors, any signups are attributed to you.

Use get_referrals to retrieve your code, share URL, and earnings stats.

Example Usage (in Claude Desktop)

"Show me food trucks in California" "List my upcoming events" "How many pending applications do I have for my next event?" "What's my referral link and how many people have I referred?" "Share the QR code for my next event"

Environment Variables

Variable	Required	Default	Description
POPUP_API_KEY	Yes	—	Your PopUp API key (pk_live_...)
POPUP_API_BASE	No	https://usepopup.com	API base URL