Rigshare

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 on RIGShare"
• "Are there any A100 80GB setups with SSH access?"
• "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 listed 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 the Enterprise plan 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; while RIGShare payments are paused a new plan cannot be bought) 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-booking spend cap and an optional cap over a rolling 24 hours (there is no monthly cap). The 24 hour total counts bookings and session extensions requested in the last 24 hours, before sales tax. Requests that were later declined, cancelled or expired keep counting until 24 hours pass. Refusals come back with code spend_limit_per_booking or spend_limit_24h and nothing is booked or authorized. A booking retry sent while the first booking request is still being processed gets 409 request_in_progress (session extensions have no such check, so check the session's budget before extending again), and if the limits cannot be read the answer is 503 limits_unavailable and nothing is booked. 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; while RIGShare payments are paused a new plan cannot be bought) 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-booking spend cap and an optional spend cap over a rolling 24 hours. A booking or a session extension is checked against them before sales tax is added (each one is checked on its own against the per-booking cap), and a per-minute booking counts its full budget. Requests that were later declined, cancelled or expired keep counting toward the 24 hour cap until 24 hours pass. 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 i