io.github.socialloopai/socialloop-mcp

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.

Manage a recurring series — action 'extend' (add additional_count more occurrences), 'end' (cancel upcoming; mode 'pause' to suspend, optional from_date), or 'resume' (restart a paused series). Requires series_id + action; you must be a host of the series.

Promote a guest (who has a SocialLoop account) to staff on a live event — role doorPerson, guestList, manager, promoter, host, or custom. Grants real permissions. Requires event_id + guest_id + user_id + role; you must be a host.

Record agreed ticket-split terms as a deal proposal (the receipt of an agreement already reached). community_standing: community_id + producer_id + both legs' % terms. event_coproduction: event_id + party_ids + producer/venue/sponsor % legs (the organizer must be a party). The other side confirms with accept_deal. Recording auto-accepts YOUR side of the terms (one counterparty confirm then activates a 2-party deal), so this is consent to a revenue split — hence the one-tap confirm.

Record an expense (receipt) against a live event's budget — item, cost ($), amount paid, status, type, optional linked vendor/project. Editable via update_production_item (entity 'receipts'). Requires event_id + item + cost; you must be a host.

Record a bank-side ledger row — actual money moving (income/expense/transfer): name, amount ($), optional fee, category, phase, date, banking references, and links to a receipt/project/vendor/place/team. Requires event_id + name + impact + amount; you must be a host.

Refine the event's CURRENT cover with a short instruction ('make it warmer', 'swap the background', 'bigger title') — we re-render from the existing cover, keep the composition, and set the new one. The event must already have a cover (generate_event_cover first). Counts against the monthly AI-image limit. Requires event_id; you must be a host.

Reject an event's request to be listed in a community you run (optional reason). Denies any Space booking request riding it — optionally suggest up to 5 alternative slots, each vetted against confirmed bookings (taken/invalid ones dropped + reported, never suggested). Restores the host's own payout if your community was the payout destination (unless tickets already sold). Requires community_id + event_id; you must be its creator/admin/moderator.

Reject a pending request to join a community you run. Requires community_id + user_id; you must be its creator or admin.

Release a venue booking — frees the Space's slot. Community creator/admin/moderator releases any booking; the booking's own host withdraws their slot (listing kept). Terminal; a re-request is a new booking. Optional reason recorded for audit. Requires community_id + booking_id.

Remove a ticket tier from an affiliate (disables their code if it was the last tier). Requires event_id + affiliate_id + ticket_class_id; you must be a host.

Remove promo codes from a discount profile — 'detach' (default) keeps each code standalone; 'delete' removes unused codes but disables any with redemptions. Requires event_id + profile_id + code_ids; you must be a host.

Remove a member from a community you run (tears down their membership and cancels any paid membership subscription they hold there immediately). The creator cannot be removed. Requires community_id + user_id; you must be its creator or admin.

Remove a guest-list entry from a live event you manage — deletes the entry and cleans up its counters. Only guest-list entries, never purchased tickets. Requires event_id + guest_id; you must be a host.

End a member's producer setup in one tap (prospective — sold tickets and attached events keep their terms; its event exceptions end with it). Requires deal_id.

Remove a member from a partner profile — ends their terms prospectively. Requires community_id + profile_id + member_uid.

Reorder the active ticket tiers' display order. Pass ALL active tier ids in the desired order. Requires event_id; you must be a host.

Remove an affiliate from a live event — disables their promo codes (keeps redemption history) and revokes access. Requires event_id + affiliate_id; you must be a host.

Send invitations to a live event — app, email, or both — to people (recipient_uids), saved lists (distribution_list_ids), and/or manual contacts (external_contacts). Optionally attach a promo code, add a custom message, send as a linked community, or schedule. Counts against the weekly invite limit; sends real emails/push. Requires event_id; host only.

Replace a community's signup form — questions, live or not, optional name. A live form is required before joining. Pass question ids to keep answers mapped. Requires community_id + questions + enabled; creator or admin.

Set or change a live event's address/location. Provide `address` (the text shown on the event page); optionally `venue_name` and `latitude`+`longitude` to also move the map pin. Use this to fix or update where an event is held. Requires event_id; you must be a host.

Set or replace a live event's cover image. Provide ONE of: image_base64 (the raw image bytes — use this to set an image attached or generated in the chat, passing its FULL bytes) OR image_url (a public https link, fetched + re-hosted durably). png/jpeg/webp/gif, ≤10 MB, complete image only (truncated payloads rejected). If your runtime can't move the full bytes into the call, host the image at a public URL and use image_url. Requires event_id; you must be a host.

Adjust the split for ONE event only (setup 80/20, this event 90/10). Re-stamps the attached event immediately; sold tickets keep their terms; the standing setup is untouched; expires with the event. Community-set setups only. Requires community_id + member_uid + event_id + terms.

Set a custom vanity URL for a live event you manage (e.g. socialloop.ai/go/sundown-sessions). 3–30 lowercase letters, numbers, and hyphens; must be unique. Requires event_id; you must be a host.

Activate or deactivate a form on a live event (activating makes it the event's live form, deactivating any other). Requires event_id + form_id + active; you must be a host.

Show or hide a host on a live event's public page without changing their permissions (visible=false hides, true shows). host_id defaults to you. Requires event_id; you must be a host.

Set a place's build status (not_started → surveyed → staged → built → systemized → designed → complete, or null to clear) — the build axis, separate from lifecycle status. Requires event_id + place_id + build_status; you must be a host.

Set a community's standing ticket-split offer per member role (e.g. staff events run 70/30; "__member__" = the member's leg). Becomes a real deal only when a member confirms the shown terms at event submission. Admin-only. Requires community_id + by_role.

Archive or re-activate a venue Space. Archiving hides it from pickers and fails future booking confirms closed; existing confirmed bookings are honored, but pending requests will strand. Admin-only. Requires community_id + space_id + status.

Submit an event you host to a community's calendar, optionally requesting a venue Space slot in the same motion (booking: space_id + ISO times — find one via find_open_slots). Consents to the community's standing deal terms for you; booking-carrying submissions await approval unless you manage the community. Member or active-deal partner. Requires event_id + community_id.

Restore an archived ticket tier to active (back on sale). Requires event_id + tier_id; you must be a host.

As a community you run, UNASSIGN an event from its venue Space here — frees the Space's calendar slot (recorded admin_released) and clears the event's venue link; the event keeps its listing and venue text. Idempotent — an event with no active booking here changes nothing. Creator/admin/moderator. Requires community_id + event_id.

Change an affiliate's commission rates on a live event (map of promo_code_id → commission). Affects future sales only. Requires event_id + affiliate_id; you must be a host.

Edit a community you own — name, description, category, privacy, tags, icon, cover. Requires community_id; you must be its creator.

Edit a live event you manage: name, description (with links), category, start/end time, cover image, turn public discovery on/off, show or hide the guest list, visibility, and capacity. Approval is set per ticket tier — use update_ticket_tier for it. Requires event_id; you must be a host (connected via 'Connect with SocialLoop').

Refine an event draft you previously created (title, time, location, tickets, etc.) using its edit token, against the same claim link. Use to iterate with the user before they publish.

Edit a form on a live event — rename and/or replace its questions. Pass questions with their ids (from list_forms) to keep responses mapped. Requires event_id + form_id; you must be a host.

Set an inventory item's typed details — kind vehicle/housing/bike/structure/power + that variant's fields (vehicle: plate/makeModel/vin/fuelType; housing: sleepCapacity/powerNeeds; power: rating/phase/voltage). Requires event_id + item_id + kind + details; host.

Set an invoice's line items — array of {description, amount} (dollars). Recomputes the invoice total. Replaces the whole list. Requires event_id + item_id; host.

Set a meal's menu — array of {name, servings?, description?, dietary_tags?, tags? (allergens)}. Replaces the whole list. Requires event_id + item_id (the meal); host.

Edit a member setup's split terms (terms: null = permission-only). Prospective — future attaches use the new terms, attached events keep theirs. Requires deal_id.

Reconfigure an affiliate open link (anyone-can-claim) — set each tier's discount + commission, the profile name, and the affiliate cap. Re-stamps EVERY existing affiliate on the link (large blast radius). Requires event_id + invite_id + tiers; you must be a host.

Rename a partner profile or set new terms — new terms roll to ALL members' future events (past sales unchanged). Requires community_id + profile_id.

Update a production item in ANY area of a live event (entity: milestones, timeline, schedule_items, tasks, projects, vendors, talent, roles, inventory, programming, meals, places, modes, transactions, invoices, teams, receipts) — change status, rename, edit notes, archive/restore (active), or set details via a `fields` object. Requires event_id + entity + item_id; you must be a host.

Edit a promo code on a live event — code, discount, max uses, start/expiry, applicable classes, or enable/disable. Requires event_id + promo_code_id; you must be a host.

Edit a discount profile — change tiers, name, max uses, schedule, or enabled state. When a discount-config field changes, every linked promo code is re-stamped to match. Requires event_id + profile_id + at least one field; you must be a host.

Edit a venue Space's fields (name, location_name, floor, capacity, photos, rules, hours, address, hour cap, timezone; null clears). Renames fan out to future bookings automatically; status changes go through set_space_status. Admin-only. Requires community_id + space_id.

Change an existing staff member's role and/or permissions on a live event (doorPerson, guestList, manager, promoter, host, or custom). Requires event_id + user_id and a role and/or permissions; you must be a host.