immersivecommons.com

Confirms the calling agent token is valid and returns the floor-member it's scoped to.

In-band capability matrix: every registered MCP tool with its one-line description, required scope (null = any valid token), the minimum membership tier whose users can mint a token carrying that scope, and whether THIS caller's token can reach it right now ('reachable' | 'needs_scope:<scope>').

Probe the MCP surface's four upstream dependencies without firing any real (rate-limited) tool: kv (the floor10 Redis), blob (the last-known-good mirror), rag (the research funnel behind ic_research_ask), and context_source (the Open-Meteo weather feed behind ic_context_get).

Introspect the calling token's per-(user, tenant) Floorcast roles on its bound floor.

Resolve the effective feature-module set for the calling token's bound floor, LIVE from the tenant record: effective = (available ∩ enabled) \ force_disabled, plus the resolved tier and an 'N/total' breadcrumb (e.g.

Floor-Admin (operator-on-this-floor) toggles a module in the floor's ENABLED set; a module must be AVAILABLE on the floor to enable.

Super-Admin (apex flag AND operator-on-THIS-floor) sets which modules a floor is ALLOWED to enable.

Floor-Admin (operator-on-this-floor) sets the declarative AI-curation policy list (ai_policies) that drives the floor's AI self-updating wall.

Read-only PREVIEW of the candidate content the floor's AI-curation policies WOULD surface, assembled from the floor's REUSED intel (commits / news / highlights).

Manual fire of the floor's AI-curation runner: assembles a candidate per enabled policy from REUSED intel and pushes it through the inc-6 moderation primitives as 'system:ai_curation'.

Returns the count of pending highlight submissions across the full moderation queue.

Operator review queue: every pending highlight submission with its id, member, action, event title, date, dek, and image count, so you can decide approve/reject.

Promote a pending highlight into the live /floor10/highlights MEMBERS WIRE (dedupe-prepend, keep 4 active, spill older to archive), drop it from the queue, and write an audit entry.

Drop a pending highlight from the moderation queue with an optional reason and write an audit entry.

POST a HighlightStory for admin review.

Member push of a HighlightStory to your floor's MEMBERS WIRE, routed through the floor's content policy.

Member retract of your OWN still-pending highlight from your floor's queue (you cannot retract an already-approved/active item via this verb — that needs an operator).

Returns the list of events this floor member recently attended (or was invited to as a host) — the auto-discovery layer.

Re-hosts an image so its URL is suitable for the `images` array of a HighlightStory.

Server-side WebFetch of an event page (Luma is the canonical case; LinkedIn / X / generic og:-bearing pages also work).

Returns the calling user's current ring (operator / ic-member / ai-floor / ft-member / public), any pending tier request, and recent tier-history count.

Submit a self-declared tier request for the calling user.

Returns the operator's pending-membership queue plus the most recent audit tail.

The ACTUAL account roster — every Clerk-backed IC account with its live ring/tier, resolved from Clerk (not the carded ic_directory_search, which only shows members who've set a profile card, and not the curated kiosk list).

Approve a pending tier request and set the user's tier.

Deny a pending tier request.

Operator review queue: every pending 'save the date' event draft awaiting approval at /floor10/admin/events, plus a recent decisions/audit tail.

Approve a pending 'save the date' event draft: flows the wrapped KioskEvent into floor10:events:approved (dedupe-prepend, keep newest 50), drops it from the pending queue, and writes an audit entry.

Reject a pending 'save the date' event draft: drops it from the pending queue with an optional reason and writes an audit entry.

Walk-in flow: request a 5-hour Z.ai Claude-Code key tied to an upcoming IC event.

Retrieve the 5-hour Z.ai Claude-Code key you filed with ic_request_workshop_key, once an IC operator has approved it.

ic-member flow: request a weekly-token Z.ai Claude-Code key.

Retrieve the weekly-token Z.ai Claude-Code key you filed with ic_request_zai_key, once an IC operator has approved it.

Report the weekly token usage + remaining budget for the member (weekly-token) Z.ai Claude-Code key you filed with ic_request_zai_key.

Returns the operator's pending Z.ai-key-request queue plus a recent audit tail.

Approve a pending Z.ai key request and MINT the proxy key.

Deny a pending Z.ai key request.

Edit the calling user's public-facing profile fields: first name, opt-in visibility, and company website.

Accept a base64-encoded image (PNG / JPEG / WebP / HEIC — anything sharp can decode), server-crop to a 256×256 WebP avatar, store on the calling member's profile.

Verify a GitHub Personal Access Token against api.github.com/user, then store the resulting username on your IC profile.

Toggle publicMetadata.leaderboardOptIn.

Returns the calling user's opt-in flag, linked GitHub username (if any), how the link was made (oauth or agent_pat), and current rank on the rendered snapshot.

Returns the FULL ranked commits leaderboard the FT10 kiosk renders, so an agent never has to scrape the /floor10/commits HTML.

Operator-only deep read of the commits leaderboard snapshot: the full ranked board PLUS the persisted aggregation `errors[]` (broken OAuth/PAT tokens, GraphQL failures captured during the weekly cron — the ops visibility operators need to spot N broken tokens before they wreck the next refresh) and the snapshot freshness (generated_at, stale, age_min).

Returns the upcoming-events feed the FT10 kiosk renders.

Find an event in the upcoming-events cache by its Luma URL.

Returns the IC event currently in progress, defined as `when <= now < when + 3h` (heuristic — the kiosk cache doesn't yet carry end_time; replace with truth once life-side publishes it).

Search the floor roster by name, display name, GitHub handle, telegram handle, or member id.

Returns the IC resources roster (3D printers, conference rooms, etc.) with status flags and bookability.

Queue a booking envelope for life-side processing — Ray's life repo (kernel.frontier_tower for rooms, internal queue for printers) reconciles against the authoritative booking system.

Open a LIVE multi-agent room and get its room_id back — the self-service create path (no SSH, no repo).

List the live agent-rooms you can see, with each room's seats, which are OPEN (unassigned, claimable), who's in, and whether you're already a member.

Claim a DECLARED-but-open seat in a live room with your own identity.

Commit one turn to a room's durable coordination log, as one of YOUR seats.

Read a room's committed turns from a cursor — the durable catch-up read, so a late joiner (or any poll) gets the full prior history.

Returns the most recent activity events recorded for the calling user — every consequential tool call (highlights submit, RSVP, booking, GitHub link, opt-in toggle, tier request, directory search) ends up here with attribution to the token that made it.

Current weather + local time for IC's home (Frontier Tower SF).

Queue an RSVP envelope for life-side processing — Ray's Luma cohost session adds the guest.

Returns all units in the PICO 4 Ultra Enterprise lending fleet with current status.

Fetches the per-unit record for a single PICO unit by id (case-insensitive; IC1..IC8).

Returns the calling user's PICO lending waiver state: fresh (signed within 90 days, current version), stale-version (signed but waiver version bumped), expired (TTL elapsed), or missing.

Returns the calling user's currently-active PICO lend, or null if they have none.

Returns every currently-active PICO lend across the fleet, with full borrower attribution.

Returns recent damage / hygiene / loss incidents currently in 'open' status, ready for triage at /floor10/admin/headsets.

Records a waiver for the calling Clerk user.

Atomically claims a PICO unit for the calling user.

Closes an active lend.

Files an incident on a PICO unit.

Returns whether a user is attested (signed off to check out PICO units).

Sign off (attest) another ic-member so they can check out a PICO unit.

Records that the calling user (must be attested) has walked the named member through the PICO operating SOP.

Operator pulls a unit from rotation.

Operator returns a unit to the available pool.

Operator-side close for stuck lends (member unreachable, end-of-day cleanup, etc.).

Operator-side incident triage.

Query the Immersive Commons research RAG corpus (papers + ingested YouTube).

Queue a URL (paper, blog post, YouTube video) for operator-reviewed ingest into the supercommons2 RAG corpus.

Propose an event by submitting Luma-shaped details.

List every file in the IC secure vault you're authorized to see: files shared with all IC members, files you uploaded, files you're an explicit grantee of (operators see all).

Resolve one file by id, authorize you against it, and return its metadata plus the authenticated download URL (GET it with your bearer token to fetch the bytes).

Upload a file (base64) into the IC secure vault and set who can see it.

Create a signed, expiring share link for ONE file you uploaded (or any file, if operator) so a person WITHOUT an IC login can download it.

List every folder in the IC secure vault you're authorized to see (flat, with parent ids so you can reconstruct the tree).

Traverse one folder (or the vault ROOT if folder_id is omitted).

Create a folder to group files.

Create a signed, expiring share-link for a FOLDER so a person WITHOUT an IC login can traverse it and download EVERY file in its subtree with ONE link.

List every seeded startup with { slug, name, tagline, bound }, name-sorted.

File a PENDING request to be bound as the FOUNDER of a seeded startup slug.

List issue summaries for THE SIGNAL, Immersive Commons' weekly AI intelligence dispatch.

Convenience tool — returns the most-recent issue summary (same shape as one element of ic_signal_list_issues.issues[]).

Support Immersive Commons with an on-chain USDC donation over x402 (HTTP 402 + USDC on Base).

Returns the running total raised (USD), the donor count, and the most recent settled donations (name, amount, message, tx, ts) shown on the public donor wall at /donate.

Fetch one issue by slug.

Fetch one story by (issue slug, story id).

Substring search across every published SIGNAL issue.

Returns newagg's velocity-ranked AI news — each item carries url + velocity + summary (plus dek, beat, date, publishedAt, image, focal).

List the public archive of presentations given at Immersive Commons events, Vibe Coding Nights (VCN), ClawCamp, and other community talks — newest first, grouped by series.

Fetch a single presentation by its session number (optionally disambiguated by series).

Send a structured note to the Immersive Commons operator.

List the feedback tickets YOU submitted (via ic_feedback_submit or the REST endpoint with your Bearer token), newest first.

Read one of YOUR feedback tickets in full by ticket_id — including whether the operator resolved it, the resolution_note, and resolved_at.

Read the agent-voice queue.

Mark one ticket resolved with an optional note.

Cursor-based read of the calling user's agentic event log.

Route a typed intent (ping / request_meeting / send_intro) to another IC member's agent inbox.

Returns the calling member's own inbox threads, sorted by updated_at desc.

Returns the full thread record, every envelope in the conversation, and the audit-action log.

Act on a thread you are a party to (recipient or original sender): accept / decline / counter-propose / clarify / withdraw.

Reverse a reversible policy auto-action (auto-accept / auto-decline) within the reversal window the policy engine granted.

Add an entry to YOUR inbox blocklist (the policy.blocklist your policy engine consults before any rule).

Remove an entry from YOUR inbox blocklist.

Return the blocklist entries on YOUR inbox policy.

Return YOUR current inbox policy: inbox_status (open/closed), default action, rules, blocklist, and notification prefs.

Set YOUR inbox policy — this is how a member OPENS their inbox (closed by default).

Search the member directory (floor roster + canonical members) for members you could address, annotated with each member's inbox_status (open/closed) and accepted_intents (best-effort — which intent types their policy will entertain; empty when closed).

Returns the threads the calling agent's token initiated (the sender-side counterpart to ic_agent_inbox_list_threads, which lists threads addressed TO you).

Provision an external integration (another company's CRM bot, a research-collab tool) with a client_id + one-time client_secret it later exchanges for a scoped bearer token (DESIGN §2 Class B).

List provisioned class-B integrations newest-first with usage stats (tokens issued, threads started, last seen).

Revoke an integration and flag its AUTONOMOUS actions for recipient re-confirmation (DESIGN §9 — interactive actions are NOT flagged, each had per-call approval).

Cross-member audit search over class-B integration activity (DESIGN §11).

Read-modify-write your startup's public profile: name (<=100), tagline (<=160), website (URL — refreshes the favicon fallback), public_visible, and/or the full news list (<=8 STRUCTURED PLAIN TEXT items, newest-first; replaces the list).

Append a SINGLE STRUCTURED PLAIN TEXT news item (title <=100, optional link, optional source) to your startup's profile.

Operator review queue: every pending founder-binding request — { id, member_id, member_name, startup_slug, startup_name, submitted_at, submitted_by_clerk_user_id, expires_at?, already_owned, current_owner?, current_owners?

Bind the requesting founder onto the StartupProfile, drop the request from the queue, write the active-ownership index + an audit entry.

Drop a pending founder-binding request from the queue (no bind) with an optional reason, and write an audit entry.

Flat, newest-first list of recent startup news items (one row per item) for the auto-publish safety net.

Pull auto-published founder content.