io.github.socialloopai/socialloop-mcp

Delete a discount profile and resolve its codes — 'detach' (default) keeps each code standalone; 'delete_codes' deletes unused codes but disables any with redemptions. Requires event_id + profile_id; you must be a host.

Permanently delete a ticket tier — only if no tickets were sold (otherwise archive it). Irreversible. Requires event_id + tier_id; you must be a host.

Remove a staff member's role on a live event and demote them back to a guest (they keep their spot). Requires event_id + user_id; you must be a host.

Deny someone on the event WAITLIST / approval queue — releases their held slot back to the tier, frees them to re-register, and emails them. Get request_id from list_guest_requests. Requires event_id + request_id; you must be a host.

Find public upcoming events on SocialLoop — answer "what's on in San Francisco this weekend" or "any free tech meetups next month". Each result carries the event name, start/end time with timezone, city and venue, category, host, ticket price range, and the page to RSVP or buy on. Filters: city, date_from, date_to, free_only, limit. No login or account required. Read-only.

Duplicate an event's setup into a new draft — copies name (+ '(Copy)'), description, category, image, location, visibility, ticket tiers/pricing, and extras (promo codes, discount profiles, forms, immersive page). Does NOT copy guests/RSVPs/sales. Optional new_start_date/new_end_date. Requires source_event_id; you must be a host.

Edit a guest-list entry on a live event you manage — name, email, phone, category, plus-ones, note, tags. Only guest-list entries, never purchased tickets. Requires event_id + guest_id; you must be a host.

End an ACTIVE deal prospectively — sold tickets keep their stamped terms, attached events are untouched, only NEW attachments stop. Terminal for the thread. Requires deal_id.

Export a form's submitted responses as a downloadable CSV — one row per submission, one column per question, plus Submitted At — and return a download link. Requires event_id + form_id; you must be a host. Read-only.

Export a live event's guest list as a downloadable CSV (name, email, phone, category, ticket class, plus-ones, checked-in, note) and return a download link. Optional category filter. Requires event_id; you must be a host. Read-only.

Find open bookable gaps across a community's venue Spaces for a duration (minutes) within a date range (max 31 days) — clears confirmed bookings AND each Space's listed hours. Optional space_id, location_name (narrow to one Location), min_capacity, limit. Truthfully bounded: truncation flags mean UNKNOWN beyond the page. Requires community_id + duration_minutes + date_from + date_to. Read-only.

Generate a brand-new cover image (a finished event flyer) for an event from a TEXT prompt — describe the vibe, palette, imagery, and energy. We render it server-side (no image upload from you needed — works even when you can't pass a file) and set it as the event's cover; the event's name becomes the flyer's hero title by default. Counts against the monthly AI-image limit. Requires event_id; you must be a host.

Get your account status — plan + subscription, Stripe connected + payouts/charges enabled (can you get paid out), weekly-invite add-on, and your plan caps (staff, promo codes, affiliates, tiers, communities, form questions, weekly invites). Requires a connected account. Read-only.

Get a live event's revenue — net actually paid (cents), tickets sold, per-tier breakdown, an unattributed bucket, and each affiliate's reported revenue/commission (the same 'Earned' figure the Revenue & Payouts page shows). Requires event_id; you must be a host. Read-only.

Get the full record for one guest on a live event — identity, tier, plus-ones, check-in status + time, staff role, tags, note, activity log, and plus-ones. Requires event_id + guest_id; you must be a host. Read-only.

Check the status of an invitation send — state, recipient count, invites/emails sent, failures, % complete. Requires event_id + job_id; you must be a host. Read-only.

Get the shareable links for a live event — public URL, immersive-page URL, vanity short link, and every trackable custom link with its source and click count. Requires event_id; you must be a host. Read-only.

Set a member's producer setup in a community you run: submit permission, optionally with split terms (they keep 70% / community 30%). Activates immediately — community-set, the member sees it but doesn't confirm. Omit terms = permission-only. Members only (partners use propose_deal). Requires community_id + member_uid.

Import contacts into one of your distribution lists (your network) — give a list_name (created if new) plus a contacts array ({name,email,phone}) and/or raw csv text (header row auto-mapped). Normalizes + dedupes, skips unreachable/duplicate, respects your plan cap. Requires a connected account.

Bulk-add up to 200 guests to a live event's guest list in one call (parse the CSV / contact list into rows; each needs at least a first name). Counts the whole batch against the weekly invite limit. Requires event_id; you must be a host.

Invite a staff/team member to a live event by email with a role — host (Producer), manager, guest_list, door_person, or promoter (Co-Host). Sends an invite email; they join on accept. Requires a Pro plan. Manage existing staff with list_event_staff / update_staff_role / demote_staff_to_guest. Requires event_id + email + role; you must be a host.

Interconnect production items on a live event — link an item to others across the graph (task→project, project→teams/places/milestones, vendor→projects, programming→talent/places, inventory→team/place/project, receipt/transaction→team/vendor/project, place→parent, cue→place/programming/talent, milestone→projects/tasks, meal→shift, task→place, team→depends_on, buildUnit→unit_lead/unit_team/environments/build_tasks, scholarship→applicant, invitation→nominated_by/applicant, person↔person via modes→roommates/buddy/mentor/significant_other/sharing_vehicle_with/paying_for/ticket_sending_to/ticket_receiving_from). op add/remove/set. Denormalized names + team counters stay in sync automatically. Requires event_id + entity + item_id + relation + target_ids; host.

List the affiliates on a live event — name, email, their promo codes (discount + commission), and sales stats (tickets sold, revenue, commission). Requires event_id; you must be a host. Read-only.

List a community's venue bookings — space (with its Location/floor as booked), slot, status, event, host. Optional space_id / day (UTC YYYY-MM-DD, live bookings only) / status filters; ordered by start time; truthfully truncated at 50. Members only. Requires community_id. Read-only.

Trace the consequential decisions in a community you run — the approval audit log, newest-first. Each entry names WHO acted, WHEN, to WHICH event, and — for approvals — at WHAT deal terms (producer%/community%, or 'distribution only'), plus any Space confirmed; rejects carry the reason; Space assign/reassign/unassign carry the Space + slot. Paginated (limit≤100, cursor) and filterable (action, event_id). Requires community_id. Read-only.

List the active members of a community you run — name, role (creator/admin/member), join date. Optional role filter. Requires community_id; you must be its creator or admin. Read-only.

List your custom email-sending domains — domain, verification status, verified-at, DNS record count. Shows whether you can send from your own domain. Requires a connected account. Read-only.

List your ticket-split deals with an awaiting_your_confirmation flag, or ALL of a community's deals via community_id (admin-only). Optional event_id/status filters. Read-only.

List your saved distribution lists (name + contact count) so you can pick one to invite from with send_invitations. Requires a connected account. Read-only.

List the staff on a live event you manage — each member's role, permissions, name/email, and whether they were promoted from a guest. Requires event_id; you must be a host. Read-only.

List the events you host — name, date, status, visibility, location, capacity, and headcount, plus the total count. See how many events you have, or find an event's id before acting on it. Optional filters: status, upcoming_only, limit. Requires a connected account. Read-only.

Read the responses submitted to a form — each submission's answers and when it arrived, newest first. Requires event_id + form_id; you must be a host. Read-only.

List the forms on a live event — name, status, response count, and every question (with ids). Requires event_id; you must be a host. Read-only.

List the pending WAITLIST / approval requests on a live event you manage — how many are waiting, who asked, which tier, and when (oldest first). This is the event waitlist. Pair with approve_guest_request / deny_guest_request. Requires event_id; you must be a host. Read-only.

List the guests on a live event you manage — name, email, phone, category, plus-ones, check-in status — with totals and checked-in count. Optional category filter. Requires event_id; you must be a host. Read-only.

List the pending requests to join a community you run — who asked and when. Approve/reject with approve_join_request / reject_join_request. Requires community_id; you must be its creator or admin. Read-only.

List the communities you belong to — name, icon, your role, status. owned_only true for just the ones you created. Requires a connected account. Read-only.

List the people in your network — everyone who has attended your events, with how many events each attended and when last seen (most frequent first). Optional name/username search. Requires a connected account. Read-only.

List a community's partner profiles with terms and member counts (admin-only). Requires community_id. Read-only.

List events awaiting approval in a community you run — who submitted, when, whether they asked for your community payout, and any requested venue Space slot with its conflicts (hard = confirmed overlap, approval will fail; soft = competing pending request, first approval wins). Approve with approve_community_event — except payout-routing submissions, which are reviewed in the studio (link returned); decline with reject_community_event. Requires community_id. Read-only.

List production items on a live event — entity is any of milestones, timeline, schedule_items, tasks, projects, vendors, talent, roles, inventory, programming, meals, places, modes, transactions, invoices, teams, receipts — with name, status, and key details. Optional status filter. Requires event_id; host. Read-only.

List the promo codes on a live event — code, discount, usage vs cap, schedule, classes, and whether each is an affiliate/profile code. Requires event_id; you must be a host. Read-only.

List the discount (coupon) profiles on a live event — name, per-tier config, schedule, code count, enabled state. Requires event_id; you must be a host. Read-only.

List events shared with you — where you're added as staff (producer/manager/guest-list/door) or as an affiliate/promoter — with each event's name and your role. Requires a connected account. Read-only.

List a community's bookable venue Spaces (rooms/floors) — name, Location (the named place grouping Spaces, when used), floor, capacity, status, weekly hours, per-booking hour cap, photo count. Sorted Location → floor → name. For members, active-deal partners, or anyone in an open community. Optional include_archived. Requires community_id. Read-only.

List your sponsors — company, tier, total committed ($), deliverables, contact, plus the grand total (highest first). Optional tier filter. Requires a connected account. Read-only.

List the pending team/staff invites on a live event — email, role, and when invited. Accepted staff appear in list_event_staff. Requires event_id; you must be a host. Read-only.

List the paid ticket sales on a live event — buyer name/email, tier, amount paid (cents), discount, promo code, date (newest first). Skips free/guest-list and cancelled tickets. Requires event_id; you must be a host. Read-only.

List the ticket tiers on a live event you manage — name, price, capacity, sold, available — with totals. Requires event_id; you must be a host. Read-only.

Send an announcement to ALL guests of a live event you manage — one message delivered by email (to guests with an address on file, minus unsubscribes) AND as an in-app push notification. Provide subject + message. Use when the host wants to tell their guests something (a time/venue change, a reminder, a thank-you). Outward-facing and can't be unsent — confirm the wording with the host first. Requires event_id; host only.