SocialLoop docs

Agent API

A single public HTTP endpoint, https://socialloop.ai/agent, that any agent can call to run events on SocialLoop. No authentication is required to create a draft — it returns a claim link the user opens to publish. Prefer a native connector? See the MCP docs.

OpenAPI 3.1 spec →MCP docs

1. Discover the tools

A GET returns the live, callable tools and their JSON Schemas — no docs round-trip needed.

GET https://socialloop.ai/agent

# → { "tools": [ { "name", "description", "inputSchema", "requiresHumanConfirm" }, ... ] }

2. Create an event

POST a tool name + input. The model fills the schema from discovery.

POST https://socialloop.ai/agent
Content-Type: application/json

{
  "tool": "create_event_draft",
  "input": {
    "idempotency_key": "<a fresh uuid>",
    "event_name": "Friday Rooftop Social",
    "event_description": "A casual evening to meet new people.",
    "starts_at": "2026-06-27T20:00:00-05:00",
    "timezone": "America/Chicago",
    "location_address": "Chicago, IL",
    "visibility": "public",
    "ticket_mode": "rsvp",          // rsvp | paid | tiered | pwyw
    "capacity": 40
  }
}

Response — hand the user the claimUrl to publish:

{
  "ok": true,
  "tool": "create_event_draft",
  "result": {
    "draftId": "0a90b902c12583b62933",
    "previewUrl": "https://socialloop.ai/draft/0a90b902c12583b62933",
    "claimUrl":   "https://socialloop.ai/claim/0a90b902c12583b62933",
    "editToken":  "…",
    "expiresAt":  "2026-06-30T07:47:20.434Z"
  }
}

3. Refine & add offers

Use update_event_draft (with the edit_token) to adjust details, and create_promo_code to stage a discount before publishing:

POST https://socialloop.ai/agent

{
  "tool": "create_promo_code",
  "input": {
    "draft_id": "0a90b902c12583b62933",
    "edit_token": "…",            // from create_event_draft
    "code": "EARLYBIRD",
    "discount_type": "percent",   // percent | fixed
    "discount_value": 20
  }
}

Errors & limits

Errors return { "ok": false, "error": { "code", "message" } } with a stable machine code (SCHEMA_INVALID, PRECONDITION_FAILED, RATE_LIMIT_EXCEEDED, …) and the matching HTTP status. The anonymous surface is per-IP rate limited. The OpenAPI spec is the always-current, machine-readable contract (generated from the live catalog).

Full capability surface

Live tools are callable today; the rest are rolling out on the same catalog (call GET /agent for the live list).

Event creation & lifecycle

Create, refine, and publish events end-to-end.

Create an event Live

Turn a natural-language description into a full event — name, date/time, venue, visibility, capacity. Returns a claim link to publish (no account required to start).

create_event_draft

Edit an event Live

Refine any detail — title, time, location, description, settings — before or after publishing.

update_event_draft

Publish an event Live

Take an event live. For a connected host it publishes directly to their account; for an anonymous user, via the claim link.

Ticketing

From free RSVPs to tiered, paid, and application-gated tickets.

Ticket tiers & pricingRolling out

Free RSVP, fixed price, tiered, or pay-what-you-want — with capacities and secret allotments.

add_ticket_tier

Application-gated ticketingRolling out

Require host approval before charging (Stripe capture-on-approval).

Discount & coupon codes Live

Percent or fixed-amount promo codes, usage caps, windows, and per-tier targeting.

create_promo_code

Guest management & invitations

Build, invite, and run the guest list — full end-to-end.

Add guestsRolling out

Add individual guests or bulk-import an audience to an event.

add_guest

Invite guestsRolling out

Send invitations directly through the agent — invite people to the event end-to-end, not just track them.

import_guest_list

Check-in & waitlistRolling out

Mobile check-in, waitlist promotion, and source attribution per ticket.

Custom forms

Intake forms that compound across events.

Custom intake formsRolling out

AI-generated registration/intake forms with cross-event pre-fill.

Affiliate & promoter management

Recruit promoters and pay them automatically.

Affiliates & community partnersRolling out

add_affiliate

Discounts & coupon codes

Drive demand with targeted offers.

Create discount / coupon codes Live

Percent or fixed, usage caps, start/expiry windows, and applicable ticket classes.

create_promo_code

Community management

Turn attendees into a recurring community.

Communities & membershipsRolling out

Public, private, or member-only communities with routed Stripe, member tiers, and subscriber management.

Team management

Staff the event with the right roles.

Team & rolesRolling out

Invite staff/team members to an event with scoped roles.

invite_team_member

Production OS — budget, vendors, run-of-show, schedule, tasks

Plan and run the entire production through the agent.

Budget managementRolling out

Set and revise budgets, record receipts and line-item expenses.

set_budget

Vendor managementRolling out

Add vendors to the production graph and commit bookings.

add_vendor

Programming & talentRolling out

Build the lineup — add and book talent/performers.

add_talent

Run-of-showRolling out

Author the run-of-show / show-flow for the day-of.

Schedule managementRolling out

Production schedules and timeline coordination across the team.

Project & task managementRolling out

Manage the production as projects and tasks, end-to-end.

Financial transactionsRolling out

Record money movements against a project budget.

record_transaction

Analytics

Read performance back into the conversation.

Event analyticsRolling out

Views, RSVPs, ticket sales, conversion, and revenue.

get_event_analytics

SocialLoop (socialloop.ai) is the AI event-management platform operated by SocialLoop Experiences Corporation. Its MCP server is mcp.socialloop.ai / socialloop.ai/mcp. SocialLoop is not affiliated with social.plus, socialloop.app, or socialloop.io — any MCP or docs on those domains are not SocialLoop's.