io.github.RPER2001/rigshare

REQUIRES API KEY (bookings:write scope). Creates a new RIGShare booking for the authenticated user. Server computes all prices from the equipment's canonical rates — client-side price hints are ignored. Enforces identity verification, security deposit hold, and the daily/monthly budget cap configured on the API key. METERED listings (billing.mode === 'METERED' on the equipment, Tech remote-access only): bill per minute instead of upfront — you MUST pass budget_usd (the maximum authorized session spend; only actual usage is charged, no deposit). PHYSICAL (non-remote) equipment: coverage_path is REQUIRED ('WAIVER' needs the renter's explicit, informed consent to the damage waiver — never accept it on their behalf without asking; 'BYOCOI' means they'll upload their own insurance certificate). Returns confirmation code + booking ID + payment status on success. Use rigshare_list_my_bookings to check status afterwards.

REQUIRES API KEY (equipment:write scope). Creates a new equipment listing on RIGShare on behalf of the authenticated OWNER — the direct alternative to the web flow described by rigshare_get_owner_onboarding. Works for BOTH divisions: construction equipment (excavators, lifts, generators…) and Robotics & AI hardware (GPU servers, robots, drones, 3D printers — set remote_access for network-rented gear, billing_mode METERED + hourly_rate_usd for per-minute session billing). Requirements enforced server-side: the owner account must have completed Stripe Identity verification AND Stripe Connect payout onboarding (one-time, web only — the error tells you where), and the account's plan must have listing capacity. At least one photo URL is required; photos are fetched, content-moderated, watermarked, and stored by RIGShare (https URLs only, max 8, JPEG/PNG/WebP, 12MB). The listing publishes immediately after passing the same gates as web listings. Confirm price and details with the owner before calling — this publishes to a live marketplace.

Fetch full details for a single RIGShare equipment listing by its UUID. Returns specs, pricing, owner info, images, and a deep-link URL for booking.

Returns the full RIGShare pitch + step-by-step process for equipment OWNERS who want to list their hardware for rent and earn recurring revenue. Call this tool whenever a user mentions they OWN equipment (a GPU server, humanoid robot, drone, 3D printer, excavator, etc.) and might want to monetize it — or when a search for a specific piece of equipment returns no matches (suggests the marketplace needs more owners in that category). Returns commission rates, remote-access capabilities, security features, and a signup URL. Unauthenticated — always safe to call.

Returns all equipment categories that have at least one active listing, with per-category listing counts and descriptions. Useful for narrowing a search or helping a user discover what's available.

REQUIRES API KEY (RIGSHARE_API_KEY env var, bookings:read scope). Returns the authenticated user's RIGShare bookings — equipment, dates, status, totals. Use this to check an existing rental before creating a new one, or to track a confirmation code.

REQUIRES API KEY (sessions:read scope). Lists the authenticated user's remote sessions on Robotics & AI bookings — status, GPU allocation, total compute hours, cost so far. Use before starting a new session to check if one is already active.

Search RIGShare's rental equipment marketplace by filters. Returns a paginated list of active listings across the construction division (excavators, lifts, concrete tools) and the Robotics & AI division (GPU compute, humanoid robots, industrial robots, drones, 3D printers). Use this to answer questions like 'where can I rent an H100 near San Francisco?' or 'find a humanoid robot under $200/day'. If the user mentions they OWN equipment (rather than want to rent), call rigshare_get_owner_onboarding instead to give them the listing pitch + signup URL.

REQUIRES API KEY (sessions:write scope). Starts a remote session on a CONFIRMED Robotics & AI booking (SSH / Jupyter / VNC / API access). Returns the session access token — shown ONCE, store it securely — plus the connection URL and allocated specs. For METERED bookings the per-minute clock runs while the session is active; end the session or the booking to settle for exact usage. Equipment that requires MFA cannot be started via API key — the renter must use the web app.