SocialLoop docs

Agent API

Two public HTTP endpoints, no authentication on either. GET /api/events finds public upcoming events for someone looking for something to attend. POST /agent runs everything else — creating a draft requires no account; it returns a claim link the user opens to publish. Prefer a native connector? See the MCP docs.

1. Find events (no account, no key)

The attendee-side read, as a plain GET — for the question “what’s on in San Francisco this weekend?”. It returns only events a host published for discovery (drafts, cancelled and suspended events are never included, and no guest data is exposed), and each result carries the canonical page to RSVP or buy on. Identical in result shape to POST /agent with tool: "discover_events".

GET https://socialloop.ai/api/events?city=San%20Francisco&free_only=true

# All params optional:
#   city        e.g. "San Francisco" — case- and accent-insensitive
#   date_from   ISO 8601; clamped to now (only upcoming events)
#   date_to     ISO 8601; defaults to 90 days out, capped at 365
#   free_only   true | false
#   limit       1–50 (default 20)

Response — link url directly; RSVP and ticketing run on the page itself. moreAvailable: true means a cap hid results: narrow the city or the date window.

{
  "ok": true,
  "tool": "discover_events",
  "result": {
    "events": [
      {
        "eventId": "0a90b902c12583b62933",
        "name": "Sunday Supper",
        "url": "https://socialloop.ai/loops/0a90b902c12583b62933",
        "startsAt": "2026-09-06T02:00:00.000Z",
        "endsAt": "2026-09-06T05:00:00.000Z",
        "timezone": "America/Los_Angeles",
        "city": "San Francisco",
        "venueName": "The Loft",
        "category": "food_drink",
        "hostName": "Ada",
        "priceRange": { "min": 0, "max": 0, "currency": "USD", "isFree": true }
      }
    ],
    "returned": 1,
    "matched": 1,
    "moreAvailable": false,
    "window": { "from": "...", "to": "..." }
  }
}

2. 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" }, ... ] }

3. 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"
  }
}

4. 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).

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.