RPER2001/rigshare-mcp

> Model Context Protocol server for RIGShare. Browse construction equipment and Robotics & AI hardware rentals from any MCP-compatible AI agent (Claude Desktop, Cursor, VS Code, custom agent frameworks).
What it does
Exposes twenty tools to your AI agent: four read-only (no auth) and
sixteen authenticated (require a RIGShare API key with the right scope).
Together they let an agent **book** equipment in either division,
**list** equipment for an owner, and **run a remote session** on
Robotics & AI hardware, while a human always stays in the loop for
money: an agent never enters a card, never approves a request on the
owner's behalf, and never steps up to MFA.
**Read-only (no API key needed):**
| Tool | What it does |
|---|---|
| rigshare_search_equipment | List / filter equipment by division, category, price, location, remote-access, compute architecture |
| rigshare_get_equipment | Full details for one listing (specs, pricing, deposit display, owner, images, deep-link URL) |
| rigshare_list_categories | Available categories with listing counts |
| rigshare_get_owner_onboarding | **Recruits equipment OWNERS**: the full pitch (commission rates, remote-access tooling, security) + step-by-step signup. Call it whenever a user mentions owning equipment, or when a search comes back empty |
**Booking (renter side):**
| Tool | Required scope | What it does |
|---|---|---|
| rigshare_quote_booking | bookings:read | Dry-run price for exact dates (nothing is charged). Refuses a 4-hour start past 4:00 PM local up front |
| rigshare_create_booking | bookings:write | Creates the booking (both divisions). Server computes every price; returns confirmation + next_action (who acts next, and the URL) |
| rigshare_get_booking | bookings:read | Poll one booking: status, payment settled?, active session, next_action (who acts next, and the URL). Request-to-book: owner approves → renter pays at the URL → confirmed. Instant-book: the renter pays at the URL right away |
| rigshare_list_my_bookings | bookings:read | The authed user's bookings |
| rigshare_cancel_booking | bookings:write | Cancel; refund computed server-side per the published policy |
**Listing (owner side):**
| Tool | Required scope | What it does |
|---|---|---|
| rigshare_save_draft_listing | equipment:write | Save a half-finished listing as a DRAFT (both divisions); idempotent per draft_session_id (a re-save changes only the fields you pass). Include replacement_value_usd for a physical listing (caps the displayable deposit; the server may require it to publish) |
| rigshare_publish_listing | equipment:write | Publish a draft through the same gate as the apps (identity, payout setup, camera photo, moderation). Gate failures come back as codes the agent relays |
| rigshare_create_listing | equipment:write | Create-and-publish in one call when the owner is already verified and has photos |
| rigshare_check_availability | equipment:read | Unavailability blocks on one of your own listings, looked up by its external_id |
| rigshare_sync_availability | equipment:write | Push an ERP / fleet calendar's blocks onto one of your listings (replaces the previously synced blocks) |
**Remote sessions (Robotics & AI):**
| Tool | Required scope | What it does |
|---|---|---|
| rigshare_start_session | sessions:write | Create + start a remote session on a CONFIRMED booking; returns the one-time access token and connect handoff. A repeat call while the session is live returns that session. Needs the rental agreement signed by both parties; MFA-protected listings must be started from the web/mobile app |
| rigshare_get_session | sessions:read | Status, health, usage, metered budget vs billed, latest telemetry |
| rigshare_get_session_usage | sessions:read | Live budget snapshot for a METERED booking |