Rigshare README

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):

Booking (renter side):

Listing (owner side):

Remote sessions (Robotics & AI):

Read-only tools hit the public API (100 req/min/IP). Authenticated tools call the /api/v1/agent/* and /api/v1/* endpoints using Bearer auth and respect the API key's scopes and, where set, its spend caps.

Use cases

For ML / AI engineers:

• "Find me the cheapest H100 available this weekend"
• "Are there any A100 80GB setups with SSH access right now?"
• "What's the going rate for inference GPUs on RIGShare?"

For robotics researchers:

• "Which humanoid robots can I rent for bipedal locomotion testing?"
• "Show me industrial arms with camera feeds under $200/day"

For construction contractors:

• "Find an excavator under 10 tons in Texas"
• "What scissor lifts are available this week in Salinas?"

For AI procurement agents:

• "Give me a list of all rentable 3D printers in California, sorted by price"

For equipment owners (supply-side recruitment):

• "I have a Unitree G1 humanoid sitting idle. How do I rent it out?"
• "I own a 4x H100 rig. Is there a marketplace for this?"
• "We have 3 excavators our crew only uses 60% of the time. Can we rent the rest out?"

For any of these, the agent calls rigshare_get_owner_onboarding (optionally with the equipment type) and gets back the full pitch: commission rates, the right signup URL, the step-by-step process, and the division-specific pitch (remote access for AI compute, AI infrastructure and IoT sensors; handoff verification, condition photos and optional GPS tracking on paid plans for construction).

Installation

Claude Desktop

Add to your claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"]
    }
  }
}

Restart Claude Desktop. You should see "rigshare" in the 🔌 MCP servers list in the chat input area.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"]
    }
  }
}

VS Code (Continue extension)

Add to your Continue config under mcpServers:

{
  "rigshare": {
    "command": "npx",
    "args": ["-y", "rigshare-mcp"]
  }
}

Any MCP-compatible agent framework

Launch with stdio transport:

npx -y rigshare-mcp

Testing locally

# Clone this repo
git clone https://github.com/rigshare-hq/rigshare-mcp.git
cd rigshare-mcp

npm install
npm run build

# Run the server (reads MCP protocol on stdin, writes to stdout)
npm start

# Diagnostic output goes to stderr:
# > rigshare-mcp server running on stdio

Then point your MCP client at the local build by changing the config:

{
  "mcpServers": {
    "rigshare-local": {
      "command": "node",
      "args": ["/absolute/path/to/rigshare-mcp/dist/index.js"]
    }
  }
}

Environment variables

• RIGSHARE_API_KEY: Optional. Enables the 16 authenticated tools. Without it, those tools return a descriptive error and the 4 read-only tools still work. Create a key at https://www.rigshare.app/enterprise (API keys need a Pro or Enterprise plan) or email support@rigshare.app.
• RIGSHARE_BASE: override the RIGShare host that every API base below derives from. Defaults to https://www.rigshare.app.
• RIGSHARE_API_BASE: override the public API base URL. Defaults to https://www.rigshare.app/api/public/v1.
• RIGSHARE_AGENT_API_BASE: override the authenticated agent API base URL. Defaults to https://www.rigshare.app/api/v1/agent.
• RIGSHARE_V1_API_BASE: override the owner equipment/availability API base URL. Defaults to https://www.rigshare.app/api/v1.

Claude Desktop config with API key

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"],
      "env": {
        "RIGSHARE_API_KEY": "rigs_live_..."
      }
    }
  }
}

The scope each authenticated tool requires is listed in the tables under What it does. Keys can be scoped narrowly (read-only) or broadly (read+write+booking). A key can also carry an optional per-transaction spend cap and an optional daily spend cap (there is no monthly cap). A new key has neither cap and has auto-pay off; neither is set from the key page, so contact support@rigshare.app about them. Create and revoke keys at https://www.rigshare.app/enterprise.

How the data flows

┌────────────────┐  MCP stdio   ┌────────────────┐  HTTPS   ┌────────────────────────────┐
│ Claude Desktop │ ◄──────────► │  rigshare-mcp  │ ───────► │  rigshare.app/api/public/v1 │
│  / Cursor /    │              │   (this pkg)   │          │  (read-only, rate-limited)  │
│  VS Code / ... │              └────────────────┘          └────────────────────────────┘
└────────────────┘

The read-only tools use no auth, cookies or user accounts: the agent reads the same data you'd see browsing rigshare.app publicly. The authenticated tools call the agent and owner endpoints (/api/v1/agent/*, /api/v1/*) with your API key.

Write operations

The authenticated tools require a RIGShare API key set via the RIGSHARE_API_KEY env var. Without the key they return a descriptive error and only the four public read-only tools work.

Create an API key at https://www.rigshare.app/enterprise (API keys need a Pro or Enterprise plan) or email support@rigshare.app. Keys are scoped (equipment:read, equipment:write, bookings:read, bookings:write, sessions:read, sessions:write) and can carry an optional per-transaction spend cap and an optional daily spend cap. A booking is checked against them before sales tax is added. A new key has neither.

The human stays in the loop for money. A booking created by an agent is paid by the renter at the booking URL: right away on an instant-book listing, after the owner approves on a request-to-book listing. The exception is auto-pay: when it is enabled on the key, an instant-book booking is paid with the renter's saved card as it is created (a per-minute listing's budget is authorized as a card hold). Auto-pay is off on a new key, and extending a session's budget needs it. A listing is published only after the owner completes identity verification and payout setup in the app; a remote session on MFA-protected equipment must be started from the web or mobile app. rigshare_get_booking always tells the agent who has to act next.

Start times for short rentals. For FOUR_HOURS bookings send start_date / end_date as ISO date-times with a UTC offset in the equipment's local time; the session must start by 4:00 PM local. A date-only start is read as UTC midnight: it is usually refused, but in Pacific time in winter, Alaska and Hawaii it books a four-hour block on the previous afternoon. HOURLY bookings are billed for every started hour between the two instants, so send real date-times there as well.

The full authenticated-API surface is documented at https://www.rigshare.app/openapi.json.

Registry listing

This server is published to the Official MCP Registry as io.github.rigshare-hq/rigshare. Search for it in your MCP client, or verify directly:

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=rigshare"

Contributing

Bug reports and suggestions are welcome. Open an issue on this repository or email support@rigshare.app. This repository is updated automatically whenever the package changes, so changes are not merged here directly; accepted fixes arrive in a later update.

License

MIT. Copyright © 2026 RIGShare LLC. Contact: support@rigshare.app · https://www.rigshare.app