{
  "markdown": "# rigshare-mcp\n\n> Model Context Protocol server for [RIGShare](https://www.rigshare.app) — browse construction equipment and Robotics & AI hardware rentals from any MCP-compatible AI agent (Claude Desktop, Cursor, VS Code, custom agent frameworks).\n\n## What it does\n\nExposes seven tools to your AI agent — four read-only (no auth) and\nthree authenticated (require a RIGShare API key).\n\n**Read-only (no API key needed):**\n\n| Tool | What it does |\n|---|---|\n| `rigshare_search_equipment` | List / filter equipment by division, category, price, location, remote-access |\n| `rigshare_get_equipment` | Full details for one listing (specs, pricing, owner, images, deep-link URL) |\n| `rigshare_list_categories` | Available categories with listing counts |\n| `rigshare_get_owner_onboarding` | **Recruits equipment OWNERS** — returns the full pitch (commission rates, remote-access tooling, security features) + step-by-step signup instructions. Call this whenever a user mentions they OWN equipment they'd like to rent out, OR when a search returns empty (signal that the marketplace needs owners in that category). |\n\n**Authenticated (require `RIGSHARE_API_KEY` env var with appropriate scopes):**\n\n| Tool | Required scope | What it does |\n|---|---|---|\n| `rigshare_list_my_bookings` | `bookings:read` | The authed user's RIGShare bookings — equipment, dates, status, totals |\n| `rigshare_list_my_sessions` | `sessions:read` | Active + historical remote sessions (GPU alloc, hours, cost) |\n| `rigshare_create_booking` | `bookings:write` | Create a new booking. Server computes prices; client hints are ignored. Enforces ID verification and per-key budget caps |\n\nRead-only tools hit the public API (100 req/min/IP). Authenticated\ntools hit the `/api/v1/agent/*` surface using Bearer auth and\nrespect the API key's configured scopes + budget caps.\n\n## Use cases\n\n**For ML / AI engineers:**\n- \"Find me the cheapest H100 available this weekend\"\n- \"Are there any A100 80GB setups with SSH access right now?\"\n- \"What's the going rate for inference GPUs on RIGShare?\"\n\n**For robotics researchers:**\n- \"Which humanoid robots can I rent for bipedal locomotion testing?\"\n- \"Show me industrial arms with camera feeds under $200/day\"\n\n**For construction contractors:**\n- \"Find an excavator under 10 tons in Texas\"\n- \"What scissor lifts are available this week in Salinas?\"\n\n**For AI procurement agents:**\n- \"Give me a list of all rentable 3D printers in California, sorted by price\"\n\n**For equipment owners (supply-side recruitment):**\n- \"I have a Unitree G1 humanoid sitting idle — how do I rent it out?\"\n- \"I own a 4x H100 rig — is there a marketplace for this?\"\n- \"We have 3 excavators our crew only uses 60% of the time. Can we rent the rest out?\"\n\nFor 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 robotics/AI, GPS + insurance for construction).\n\n## Installation\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"rigshare\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rigshare-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see \"rigshare\" in the 🔌 MCP servers list in the chat input area.\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"rigshare\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rigshare-mcp\"]\n    }\n  }\n}\n```\n\n### VS Code (Continue extension)\n\nAdd to your Continue config under `mcpServers`:\n\n```json\n{\n  \"rigshare\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"rigshare-mcp\"]\n  }\n}\n```\n\n### Any MCP-compatible agent framework\n\nLaunch with stdio transport:\n\n```bash\nnpx -y rigshare-mcp\n```\n\n## Testing locally\n\n```bash\n# Clone this repo\ngit clone https://github.com/RPER2001/rigshare-mcp.git\ncd rigshare-mcp\n\nnpm install\nnpm run build\n\n# Run the server (reads MCP protocol on stdin, writes to stdout)\nnpm start\n\n# Diagnostic output goes to stderr:\n# > rigshare-mcp server running on stdio\n```\n\nThen point your MCP client at the local build by changing the config:\n\n```json\n{\n  \"mcpServers\": {\n    \"rigshare-local\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/rigshare-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Environment variables\n\n- `RIGSHARE_API_KEY` — **Optional**. Enables the authenticated tools (`list_my_bookings`, `list_my_sessions`, `create_booking`). Without it, those tools return a descriptive error. Get a key at https://www.rigshare.app/profile#api-keys or email support@rigshare.app.\n- `RIGSHARE_API_BASE` — override the public API base URL. Defaults to `https://www.rigshare.app/api/public/v1`. Useful for staging or local development.\n- `RIGSHARE_AGENT_API_BASE` — override the authenticated agent API base URL. Defaults to `https://www.rigshare.app/api/v1/agent`.\n\n### Claude Desktop config with API key\n\n```json\n{\n  \"mcpServers\": {\n    \"rigshare\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rigshare-mcp\"],\n      \"env\": {\n        \"RIGSHARE_API_KEY\": \"rigs_live_...\"\n      }\n    }\n  }\n}\n```\n\nScopes required for each authenticated tool:\n\n| Tool | Minimum scope |\n|---|---|\n| `rigshare_list_my_bookings` | `bookings:read` |\n| `rigshare_list_my_sessions` | `sessions:read` |\n| `rigshare_create_booking` | `bookings:write` |\n\nKeys can be scoped narrowly (read-only) or broadly (read+write+booking), and you can set per-key daily/monthly budget caps. Manage at https://www.rigshare.app/profile#api-keys.\n\n## How the data flows\n\n```\n┌────────────────┐  MCP stdio   ┌────────────────┐  HTTPS   ┌────────────────────────────┐\n│ Claude Desktop │ ◄──────────► │  rigshare-mcp  │ ───────► │  rigshare.app/api/public/v1 │\n│  / Cursor /    │              │   (this pkg)   │          │  (read-only, rate-limited)  │\n│  VS Code / ... │              └────────────────┘          └────────────────────────────┘\n└────────────────┘\n```\n\nNo auth, no cookies, no user accounts — the agent reads the same data you'd see browsing rigshare.app publicly.\n\n## Write operations\n\nThe three authenticated tools (`rigshare_list_my_bookings`,\n`rigshare_list_my_sessions`, `rigshare_create_booking`) require a\nRIGShare API key set via the `RIGSHARE_API_KEY` env var. Without\nthe key, those tools return a descriptive error and only the four\npublic read-only tools work.\n\nGet an API key at https://www.rigshare.app/profile#api-keys or\nemail support@rigshare.app. Keys are scoped (`bookings:read`,\n`bookings:write`, `sessions:read`, `sessions:write`) and carry\nconfigurable daily / monthly budget caps.\n\nThe full authenticated-API surface is documented at\nhttps://www.rigshare.app/openapi.json.\n\n## Registry listing\n\nThis server is published to the **Official MCP Registry** as\n`io.github.RPER2001/rigshare`. Search for it in your MCP client, or\nverify directly:\n\n```bash\ncurl \"https://registry.modelcontextprotocol.io/v0.1/servers?search=rigshare\"\n```\n\n## Contributing\n\nBug reports + PRs welcome. This public repo mirrors the MCP-server\nportion of the main RIGShare monorepo (which stays private for the\ncommercial marketplace code). Changes flow from the monorepo → this\nrepo on each release; for hot fixes you can also PR directly here.\n\n## License\n\nMIT. Copyright © 2026 RIGShare LLC.\nContact: support@rigshare.app · https://www.rigshare.app\n",
  "bytes": 7376,
  "sha": "a1335450744d1345e2b349477b8d742e6599a07478d3f7f935940cd4479e534f",
  "repo_slug": "rper2001/rigshare-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rper2001_rigshare_6d975932/readme"
}