Model Context Protocol

Connect AI assistants to your fleet

Use Claude Desktop, Claude Code, ChatGPT, Cursor, or any MCP-compatible client to manage your vehicles, expenses, reservations, and more — through natural language.

Up and running in 3 steps

1

Generate a token

Go to My Profile → API Tokens and create a Personal Access Token with the scopes your integration needs.

2

Configure your client

Paste the config snippet below into your AI client. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible tool.

3

Start chatting

Ask your AI assistant to list your vehicles, log an expense, check availability, or anything else. It sees only the tools your token allows.

Setup guide

The RevHostHQ MCP server uses Streamable HTTP transport and supports both OAuth 2.1 (for clients that handle authentication automatically) and Personal Access Tokens (for manual configuration).

ChatGPT

OAuth — no token needed

ChatGPT supports remote MCP servers natively. It handles the OAuth flow for you — no tokens to copy or paste.

  1. Open ChatGPT SettingsConnectorsAdd connector.
  2. Enter the server URL: https://api.revhosthq.com/mcp
  3. ChatGPT will redirect you to RevHostHQ to log in and approve access.
  4. Once approved, the tools appear in your ChatGPT conversations automatically.

For the Responses API, pass the OAuth access token as authorization_token in your mcp_servers config. See OpenAI MCP docs.

Claude

Claude Code

OAuth — no token needed

Claude Code handles the OAuth flow automatically when you add a remote MCP server:

Terminal
claude mcp add revhost --url https://api.revhosthq.com/mcp

Claude Code will open your browser to log in and approve access. No token needed.

Claude Desktop (claude.ai)

OAuth — no token needed

Claude uses Custom Connectors with OAuth — no config files or tokens to manage.

  1. Open ClaudeSettingsConnectors.
  2. Click Add custom connector at the bottom.
  3. Enter the URL: https://api.revhosthq.com/mcp
  4. Claude will redirect you to RevHostHQ to log in and approve access.
  5. Once approved, RevHostHQ tools appear in your conversations.

Claude API (MCP Connector)

Personal Access Token

Use the MCP Connector in the Messages API:

API request (mcp_servers)
{
  "mcp_servers": [{
    "type": "url",
    "url": "https://api.revhosthq.com/mcp",
    "name": "revhost",
    "authorization_token": "revh_pat_YOUR_TOKEN_HERE"
  }],
  "tools": [{
    "type": "mcp_toolset",
    "mcp_server_name": "revhost"
  }]
}

Gemini

OAuth — no token needed

Google AI Studio and Gemini support remote MCP servers with OAuth.

  1. Open Google AI StudioTools (or MCP settings).
  2. Click Add MCP Server and enter: https://api.revhosthq.com/mcp
  3. AI Studio will redirect you to RevHostHQ to log in and approve access.
  4. Once approved, the tools are available in your Gemini sessions.

Also works with the Gemini CLI and Vertex AI ADK. See Google's MCP docs.

Cursor / Windsurf / Other MCP clients

Personal Access Token

Most MCP clients support Streamable HTTP. Create a Personal Access Token and use:

URL: https://api.revhosthq.com/mcp
Auth header: Authorization: Bearer revh_pat_...

Two ways to authenticate

OAuth 2.1Recommended

For clients that support it (ChatGPT, Claude Code, Gemini). You log in and approve access once — the client handles tokens automatically. No setup required.

Personal Access TokenManual

For developer tools, IDE integrations, and API usage. Create a token with specific scopes, paste it into your client config.

25 tools at your AI's fingertips

Your AI assistant can manage your entire fleet operation. Each tool respects the scopes on your token — grant only what the integration needs.

Vehicles

vehicle:read, vehicle:write
  • list_vehiclesList all vehicles with pagination and status filter
  • get_vehicleGet vehicle details by ID
  • check_vehicle_availabilityCheck if a vehicle is available between two dates
  • create_vehicleCreate a new non-Turo vehicle
  • update_vehicleUpdate a vehicle (blocked for Turo-synced)

Expenses

expense:read, expense:write
  • list_expensesList expenses with category, date, and vehicle filters
  • get_expenseGet expense details
  • create_expenseLog a new expense
  • update_expenseUpdate expense fields
  • delete_expenseDelete an expense

Private Reservations

private_reservation:read, private_reservation:write
  • list_private_reservationsList private reservations with filters
  • get_private_reservationGet reservation details
  • create_private_reservationCreate a new private rental
  • update_private_reservationUpdate reservation fields
  • cancel_private_reservationCancel a reservation

Turo Reservations

turo_reservation:read
  • list_turo_reservationsList Turo reservations with filters
  • get_turo_reservationGet Turo reservation details

Reminders

reminder:read, reminder:write
  • list_remindersList reminders with type and status filters
  • get_reminderGet reminder details
  • create_reminderCreate a vehicle reminder
  • update_reminderUpdate reminder fields
  • complete_reminderMark a reminder as completed

Guests

guest:read
  • list_guestsUnified list of Turo + private guests
  • get_guest_profileGet a guest profile

Pricing

pricing:read, pricing:write
  • get_pricing_calendarGet daily prices for a date range
  • update_daily_priceSet price for a specific day (non-Turo only)

Invoices

invoice:read
  • list_invoicesList cohost invoices with filters
  • get_invoiceGet invoice with line items
  • get_invoice_statsAggregated stats (totals, counts by status)

Scopes reference

When you create a token, select only the scopes the integration needs. You can always create additional tokens with different scope sets.

ScopeDescription
vehicle:readList, get, and check availability of vehicles
vehicle:writeCreate/update non-Turo vehicles
private_reservation:readList and view private rental reservations
private_reservation:writeCreate, update, and cancel private reservations
turo_reservation:readList and view Turo reservations (read-only)
expense:readList and view vehicle expenses
expense:writeCreate, update, and delete expenses
reminder:readList and view vehicle reminders
reminder:writeCreate, update, and complete reminders
guest:readList guests and view profiles
pricing:readView daily pricing calendars
pricing:writeUpdate daily prices for non-Turo vehicles
invoice:readList, view, and get stats for cohost invoices

Security

  • Tokens are hashed (SHA-256) at rest — RevHostHQ never stores the plaintext.
  • Each token is rate-limited to 120 requests per minute.
  • All MCP requests are logged in the PAT audit log.
  • Turo-synced vehicles and guests are always protected from writes, regardless of scopes.
  • Grant the minimum scopes needed. Create separate tokens for different integrations.

Ready to connect your AI assistant?

Generate a token, paste the config, and start managing your fleet with AI.

Send us a message