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.

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.

Retrieve the 5-hour Z.

ic-member flow: request a weekly-token Z.

Retrieve the weekly-token Z.

Report the weekly token usage + remaining budget for the member (weekly-token) Z.

Returns the operator's pending Z.

Approve a pending Z.

Deny a pending Z.

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.

Toggle publicMetadata.

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.

Queue a booking envelope for life-side processing — Ray's life repo (kernel.

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.

Add one or more NEW channels to a LIVE room at runtime — the channel analog of runtime role-add.

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.

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.

Mutate an EXISTING file's visibility / grantees / label / description / tags — you uploaded it, or you're operator.

Queue an audio file for offline transcription + speaker diarization by IC's GPU worker.

Get one transcription job by id: its status (queued / processing / done / error), source, timing, attempts, and — when done — the result file ids + metadata (also fetchable with ic_transcribe_get).

List YOUR recent transcription jobs, newest first (expired jobs are pruned).

Fetch the result of a DONE transcription job: the markdown + JSON transcript file ids (download with ic_files_get) plus metadata (language, num_speakers, duration, segments).

File a print request with the Floor 10 print farm.

List YOUR print requests, newest first.

Fetch one print request by id: status, model file / link, material / color / quantity, and the full status history with manager notes.

Cancel YOUR OWN print request while it's still pending or accepted (once it's printing, talk to the farm).

Move a print request through the farm lifecycle: pending -> accepted -> printing -> ready -> collected, or reject (from pending/accepted/printing) with a note.

Verify an IC member's agent token that YOUR service accepted, without spending that member's rate budget.

Published specs for every printer in the Floor 10 farm, so a design tool can size a part to a real build envelope BEFORE submitting it.

Stage a print you designed FOR an IC member.

Resolve a print handoff a design service staged in YOUR name.

Read one staged handoff by id, or list the handoffs staged in your name.

Find print jobs a brokering service submitted.

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.

Mutate an EXISTING folder's visibility / grantees / name / description / tags — you own it, or you're operator.

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.

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.

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 BOTH with the recipient's posture and with what YOUR token can actually reach.

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?

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.

Everything a prospective participant or their agent needs to decide to come: title, dates, venue, current phase, seats total/remaining, whether an NDA is required, the rubric link, and the sponsor bounties posted so far.

Put a member straight onto the roster as a PARTICIPANT, bypassing the application queue.

Returns the exact questions to answer for one applicant type, so your agent can fill an application without scraping a web form.

Submit an application.

Where your application stands: applied / approved / waitlisted / rejected / withdrawn, plus the reviewer's note when there is one.

Withdraw.

The review queue with everything needed to decide: answers, contact details, and the machine-checked evidence from the applicant's URL.

Decide one application.

Record that you have signed the venue's NDA.

One call that answers 'where do I stand': your event roles, NDA and check-in state, your team and its members, and your submission if you have one.

Every sponsor credit at this event, how to claim each one, and YOUR mark against each.

Tick one square on your credits checklist.

The credits checklist across the whole builder roster.

Every team at the event with its name, size, the startup it's working on, and whether it is recruiting plus what it's looking for.

Start a team and become its lead.

Join an existing team by id.

Leave the team you're on.

Turn your team's recruiting flag on or off and edit what you are looking for.

Submit (or re-submit) your team's project.

The attendee list.

Mark someone as physically present.

All submissions with their repo, demo, blurb and agent-surface description, plus the scores you have already given.

Record your scores for one team.

Poll the event's group chat, newest first.

Say something to the whole event.

Take a message off the public event page and out of every agent's read.

Publish a sponsor challenge participants can build against.

Grant or revoke event roles.

Move the event through PRE -> OPEN -> BUILD -> SUBMIT -> LOCKED -> JUDGING -> RESULTS.

Team standings ranked by MEAN score across judges, with the judge count alongside each so the sample size is visible rather than hidden inside one number.

Register (or refresh) YOUR OWN MCP service so agents on the floor can find it.

Search the IC endpoint registry — the member-run MCP services other agents on the floor have published.

Fetch a single endpoint-registry entry by id, including its full normalized card and the tool list an agent would get.

Toggle whether YOUR endpoint appears in ic_endpoint_search.

Read the endpoint-registry review queue, newest first.

Approve the card awaiting review on an endpoint: promotes it to the served card and indexes it for ic_endpoint_search.

Refuse the card awaiting review on an endpoint, with a note the owner can read via ic_endpoint_get.

Fetch the caller's OWN vinyl-figure manifest — the parts to render it, the animation clips they have actually unlocked, and the member stats behind those unlocks.

Fetch a member's published vinyl-figure manifest by handle.

The full catalog of things a Funko Me figure can earn — animation clips, props, skins, stages — with the condition that unlocks each one.

The caller's OWN unlock snapshot: every catalog item, whether they have earned it, and per-condition progress so you can say '3 more commits' instead of 'locked'.

Flip the caller's OWN publicShare switch.

Take a published figure out of public view: sets publicShare=false and removes the handle from the gallery index, so /api/funko/m/<handle> immediately returns the SAME not_found as a handle that never existed.

The undo for ic_admin_funko_takedown: sets publicShare=true and re-lists the handle.

Add generation allowance to one member.