io.github.socialloopai/socialloop-mcp

Confirm a recorded deal's pending terms as a party (or community admin). Activates on unanimity — an ACTIVE deal auto-stamps its ticket split when the event attaches (deal = pre-approval), so this is the money-consequential confirm. Requires deal_id.

Invite an affiliate/promoter to a live event by email with their discount and optional commission. Sends an invite email; they get a tracked code on accept. Counts against the affiliate plan cap. Requires event_id + email; you must be a host.

Extend an affiliate to another ticket tier — adds the tier to their promo code with its own discount and optional commission. Requires event_id + affiliate_id + ticket_class_id + discount; you must be a host.

Attach or auto-generate promo codes under a discount profile — each code inherits the profile's discount and becomes immediately redeemable. Give explicit codes and/or auto_generate a count (optional code_prefix); max 500/call, duplicates skipped with a suggestion. Requires event_id + profile_id; you must be a host.

Invite a co-host to a live event by email. role 'producer' = full permissions; role 'co_host' = display + invite-from-own-list. They get an email and join on accept. Requires event_id; you must be a host.

Add a guest to a live event's guest list — name, optional email, phone, category (e.g. vip/press), plus-ones, note, tags, and an optional ticket tier. Counts against the weekly invite limit. Requires event_id; you must be a host.

Add a physical asset / gear item to a live event's inventory — name, category, status (wish_list … in_use), priority, quantity + quantity needed, unit cost ($), location, project/place links. Requires event_id + name; you must be a host.

Add a meal to a live event's culinary plan — kind (breakfast/lunch/dinner/snack/special), serve time (required), title, status (planning … served), expected diners, stations, shopping list, estimated cost ($). Requires event_id + kind + serve_at; you must be a host.

Add a place / location to a live event — a build site, zone, or venue area (name, structure, sector, lifecycle + build status, parent place, budgets, start date). Requires event_id + name; you must be a host.

Add a community member to a partner profile — its split terms apply to them immediately (community-set, no confirmation step). Refuses over existing terms unless replace_existing: true. Requires community_id + profile_id + member_uid.

Add a programming item (curated experience — workshop, performance, DJ set, ritual) to a live event — title, status (ideation … ready), types, duration, start time, linked talent/places, rider, production needs. Requires event_id + title; you must be a host.

Create a production project on a live event — the container for tasks, roles, vendors, and budget. Name, description, category, priority, status, deliverable, dates. Requires event_id + name; you must be a host.

Add a production role to a live event — an accountable role (Stage Manager, Catering Lead) that tasks/vendors/receipts reference. Name, description, category, notes. Requires event_id + name; you must be a host.

Add a run-of-show cue / schedule item to a live event — a time-blocked moment (lighting/sound/performance/transition/safety/…) with start (and optional end), lane, cue number, project, talent. Requires event_id + title + start_at; you must be a host.

Add a bookable venue Space (room/floor) to a community you run — name, optional location_name (the Location grouping Spaces: campus building, city site, festival zone; skip for a single place), floor, capacity, photos, house rules, weekly hours (soft policy), building address (stamped onto events at booking confirm), per-booking hour cap. Admin-only. Requires community_id + name.

Add a sponsor to your sponsor book — company, tier (platinum/gold/silver/bronze), total committed ($), deliverables, optional contact. Spans all your events. Requires a connected account.

Add talent (performer, artist, DJ, speaker) to a live event's roster — name, bio, booking status, categories, act title, duration, contact, rider. Requires event_id + name; you must be a host.

Add a production task to a live event — title, priority, and phase (pre_production/build/event/strike/post). Requires event_id + title; you must be a host.

Add a ticket tier to a live event you manage — free RSVP (price 0) or paid, with capacity, optional approval, or a secret unlock code. Paid tiers need Stripe connected. Requires event_id; you must be a host.

Add a vendor (supplier) to a live event's production graph — name, service, pipeline status, contact info, itemized list, notes, tags, linked projects. Requires event_id + name; you must be a host.

Reassign existing standalone promo codes into a discount profile — each adopted code takes the profile's discount but keeps its prior usage count. Codes already in a profile or linked to an affiliate are skipped. Max 100/call. Requires event_id + profile_id + code_ids; you must be a host.

Approve a pending event submission in a community you run — listing, pre-consented deal terms, and any venue Space booking confirm in ONE atomic action. REFUSES payout-routing submissions (money approvals happen in the studio — link provided). A slot taken meanwhile aborts the whole approval with the conflict named. Requires community_id + event_id; creator/admin/moderator.

Approve someone on the event WAITLIST / approval queue — issues them a capacity-limited comp ticket and notifies them. Get request_id + user_id + ticket_class_id from list_guest_requests. Requires event_id + those ids; you must be a host.

Approve a pending request to join a community you run (adds them as a member). Requires community_id + user_id; you must be its creator or admin.

Archive a partner profile — ends every member's terms prospectively. Terminal. Requires community_id + profile_id.

Archive a ticket tier (take it off sale) on a live event you manage. Reversible. Requires event_id + tier_id; you must be a host.

As a community you run, ASSIGN an approved event to a venue Space + slot (space_id + ISO start_time/end_time) — confirms the booking on the same conflict lock so it can never double-book. If the event already holds a Space here, REASSIGNS it: the old room is released and the new one claimed in one atomic motion (an overlapping slot in a different room is fine). A slot taken meanwhile aborts with the conflict named; idempotent on the same space+slot. Creator/admin/moderator. Requires community_id + event_id + space_id + times.

Assign a person to a production item — teams→members/leads, milestones→owner/watchers, schedule_items→lead/assigned, cues→caller/owner, tasks→designated, places→build_lead, vendors→admin/leads, projects→leads, inventory→assigned_to/occupants. Identify by member.mode_id (a roster entry) or member.name. op set/add/remove; team.memberCount stays in sync. Requires event_id + entity + item_id + relation + member; host.

Assign a role (by role_id) to a production item — entity tasks/receipts/vendors/inventory/schedule_items (single) or projects (multiple). Stored as a name snapshot. op set/add/remove. Requires event_id + entity + item_id + role_id; host.

Create up to 500 promo codes on a live event in one call (duplicates and invalid rows skipped with reasons). Counts against the event's promo-code plan cap. Requires event_id; you must be a host.

Invite up to 200 affiliates to a live event at once by email with a shared discount/commission. Sends each an invite email. Counts against the affiliate plan cap. Requires event_id + emails; you must be a host.

Cancel a live event you manage — marks it cancelled, removes it from public discovery, cleans up invites/affiliates/broadcasts. Irreversible and outward-facing. Requires event_id; you must be a host.

Cancel a running or scheduled invitation send (stops future batches; already-scheduled emails still deliver). Requires event_id + job_id; you must be a host.

Cancel a pending team/staff invite (before it's accepted). To remove an accepted member, use demote_staff_to_guest. Requires event_id + invite_id; you must be a host.

Check a guest in (or back out) at a live event you manage — toggles their ticket between active and checked-in. Pass checked_in false to undo. Requires event_id + guest_id; you must be a host.

Check in one of a guest's allowed plus-ones at a live event you manage (fails if they're at their plus-one limit). Requires event_id + parent_guest_id + plus_one_name; you must be a host.

Check whether a venue Space is free for a specific slot: available (no confirmed overlap), every overlapping booking labeled hard (taken) or soft (pending request — first approval wins), and a soft listed-hours verdict, with local-time ranges. Requires community_id + space_id + ISO start_time/end_time. Read-only.

Get a Stripe Connect onboarding link the host opens to connect their account and enable payouts for ticket sales. Creates their Stripe account and returns the onboarding URL. Check get_account_status first. Requires a connected account.

Create a reusable 'open' affiliate profile — a shareable link promoters self-join (no named email; use add_affiliate for a specific person). Set per-tier discount, optional code prefix, affiliate cap, commission, and start/expiry. Counts against the affiliate-profile plan cap. Requires event_id + at least one tier; you must be a host.

Create a community you own — name, description, category, privacy (open/private), tags, icon/cover. Counts against your community plan cap. Requires a connected account.

Create a trackable share link (socialloop.ai/go/…) for a live event — tag it with a source (instagram, newsletter) and optional campaign; clicks are counted. Opens the public or immersive page. Requires event_id; host only.

Create an event draft on the user's behalf and return a claim link they open to publish it. Use when a user wants to create or publish an event — works even if they have no SocialLoop account yet. The draft is private until the user opens the claim link and confirms. For a user connected via 'Connect with SocialLoop', it publishes directly to their account and returns a manage link instead. Ticketing can be free RSVP, a fixed price, named tiers, or a donation (ticket_mode 'pwyw') with a minimum and suggested amounts.

Turn an existing event into a recurring series — pattern (daily/weekly/biweekly/monthly) + end (end_after total occurrences, or end_date). The source becomes occurrence 1; the rest are created on cadence with its tickets/promo/forms replayed. Requires source_event_id + pattern; you must be a host.

Create a registration/intake form on a live event — name + questions (text/textarea/select/multiSelect/email/phone/url/number, with options/required/placeholder). Starts as draft; activate with set_form_active. Requires event_id + name; you must be a host.

Create a partner profile — a named terms-group ('Resident DJs · keep 75%'). Members added or invited into it get its split terms automatically. Needs the community's Stripe connected. Requires community_id + name + terms.member_share_pct.

Create a production item in ANY area of a live event — entity is one of: milestones, timeline, schedule_items, tasks, projects, vendors, talent, roles, inventory, programming, meals, places, modes (event roster), transactions, invoices, teams, receipts. Pass name + optional status + notes + a `fields` object of entity details (e.g. milestones {target_date, category, phase}). USE THIS for milestones — a milestone is NOT a task. Requires event_id + entity + name; you must be a host.

Create a discount/promo code (percent or fixed) on a live event or an unclaimed draft. Provide either event_id, or draft_id + edit_token.

Create a discount (coupon) profile on a live event — a reusable per-tier discount config (tiers: ticket_class_id → percent/fixed) that promo codes attach to, with optional max uses + schedule. Counts against your plan's discount-profile cap. Requires event_id + tiers; you must be a host.

Decline a deal's pending terms (optional reason). First-proposal declines close the thread; renegotiation declines keep the deal active on current terms. Requires deal_id.

Permanently delete a production item (any entity: milestones, timeline, schedule_items, tasks, projects, vendors, talent, roles, inventory, programming, meals, places, modes, transactions, invoices, teams, receipts). To merely hide it, use update_production_item active:false instead. Requires event_id + entity + item_id; you must be a host.