The Reva MCP Server lets AI assistants like Claude work with your Reva data through the Model Context Protocol. Ask questions about your reviews, ratings, units, guest surveys, owners and competitors in plain language, and the assistant queries Reva on your behalf.

Endpoint: https://mcp.joinreva.com

For revenue, occupancy and other BI questions on your Reva Intel warehouse, connect the Reva Intel MCP Server too. It uses the same Reva sign-in.

📘
Read-only
The MCP server currently exposes read-only tools. Connected assistants can look up and summarize your data, but cannot change anything in your Reva account.

Requirements

A Reva account with API product access (the same access that unlocks the REST API). Contact hello@joinreva.com if you're not sure whether your plan includes it.
An MCP client that supports remote servers over Streamable HTTP with OAuth. Claude (web, desktop and mobile), Claude Code, ChatGPT, Codex, Cursor, VS Code and most modern MCP clients qualify.

How to connect

There are no API keys to copy. Reva uses OAuth: your MCP client registers itself, sends you to Reva to sign in with your normal credentials, and you approve the connection on a consent screen. Access can be revoked at any time.

Claude (web & desktop)

Reva is available in Claude's Connectors Directory.

Open the Reva listing, or search for Reva in Customize → Connectors.
Click Connect: a Reva window opens. Sign in if needed, review the permissions and click Authorize.
In any chat, enable the Reva connector from the tools menu and start asking questions.

You can also add it as a custom connector: open Customize → Connectors → Add → Add custom connector and enter https://mcp.joinreva.com. Custom connectors require a paid Claude plan.

Claude Code

claude mcp add --transport http reva https://mcp.joinreva.com

Then run /mcp inside a session, select reva and choose Authenticate to complete the browser sign-in.

ChatGPT

Reva is available in ChatGPT's plugin directory.

Open the Reva listing, or search for Reva in Plugins in the sidebar.
Click Install plugin. When a Reva window opens, sign in if needed, review the permissions and click Authorize.
In any chat, add Reva from the tools menu and start asking questions.

You can also add it as a custom MCP server: in Plugins, click Add, choose Add custom MCP server and enter https://mcp.joinreva.com with OAuth authentication.

Codex

codex mcp add reva --url https://mcp.joinreva.com
codex mcp login reva

codex mcp login opens a browser window for the Reva sign-in.

Cursor and other MCP clients

Add the server to your client's MCP configuration:

{
  "mcpServers": {
    "reva": {
      "url": "https://mcp.joinreva.com"
    }
  }
}

The client discovers Reva's OAuth endpoints automatically and opens a browser window for sign-in on first use.

Authentication

OAuth 2.1 with PKCE: the industry-standard authorization flow. Clients register automatically via Dynamic Client Registration; you never handle credentials.
Short-lived tokens: access tokens expire after 2 hours and refresh automatically. Nothing long-lived is stored in your MCP client.
Your permissions, exactly: a connected assistant sees precisely what your Reva user sees: only companies where you have API access, and only the units in your cohort if your account is restricted.

Available tools

Account discovery

Tool	What it does
`list_companies`	The companies your user can access. Start here: most other tools take a `company_id`.
`list_channels`	A company's review channels (Airbnb, Vrbo, Google, Booking.com, …).
`list_nodes`	A company's unit groupings (regions, buildings, cohorts).
`list_units`	A company's units, filterable by name, beds, active status and PMS id. Paginated.

Ratings & insights

Tool	What it does
`get_company_ratings`	Review count, average rating and replied count for a company. Filterable by channel and date range.
`get_review_stats`	Review count, average rating and replied count, for the company or grouped by month, week, channel, unit, cohort or rating. Grouped by cohort with a start date, each row also has the previous period of the same length.
`list_unit_ratings`	Every unit ranked by average rating with review counts. Worst-first or best-first, all-time or trailing 12 months. Refreshed daily.
`get_unit_ratings`	One unit's review count and average, filterable by channel and dates.
`get_trending_tags`	How many reviews mention each positive and negative guest sentiment tag (cleanliness, communication, location, …) and their share of the period's reviews, plus the trending tags: those whose share is above their usual monthly share in the 6 months before. Defaults to the last 12 months.
`get_staff_performance`	Cleaners and inspectors ranked by review outcomes. Requires the Breezeway integration.

Reviews

Tool	What it does
`list_reviews`	A company's reviews, newest first. Filter by rating, channel, listing type, unanswered (`host_response: false`) and date range. Paginated.
`list_unit_reviews`	One unit's reviews with the same filters. Paginated.

get_review_stats, list_reviews and list_unit_reviews also find reviews by their text: term matches reviews that contain every word, and phrases matches reviews that contain any of the phrases as whole words, so a count can be repeated exactly. get_review_stats and list_reviews take unit_ids and excluded_unit_ids to include or leave out units. get_review_stats, list_reviews and list_unit_reviews also take ratings and channels lists to match any of several ratings or channels. Unit and cohort rows from get_review_stats leave out brand reviews. Review rows include the guest's private feedback when there is one. Fields a company admin blocked for AI in your data policy are left out of every review tool: rows, stats such as the average rating, and text searches. Filtering or grouping by a blocked field returns an error, and list_unit_ratings returns an error when ratings are blocked.

Topics and matching sentences.

Topics. tags takes Reva's review tags. A review matches a topic when it has any of the tags or contains any of the phrases.
Matching sentences. list_reviews and list_unit_reviews with matches_only return the sentences that match, for up to 500 reviews per page.

Listings

Tool	What it does
`list_company_listings`	The company's own channel profiles with URLs.
`list_unit_listings`	All units with their per-channel listings and URLs. Paginated.
`get_unit_listings`	One unit's listings and URLs.
`list_competitor_listings`	Tracked competitors and their listings. Paginated.

Surveys, owners & competitors

Tool	What it does
`list_surveys`	A company's guest surveys, with their source, rating scale and whether each reports an average rating or NPS.
`get_survey_stats`	One survey's response count, average rating and NPS, plus one row per cohort, as on the survey page's Cohort tab. Filterable by dates, units and cohorts.
`list_survey_responses`	One survey's responses, newest first: rating, NPS, score, each answer under its question, the unit, the stay dates and the sentiment tags. Paginated.
`list_owners`	Property owners with their units, owner reports sent, the last one sent and the next scheduled one, as on the Owners page. Filterable by name and unit. Paginated.
`get_competitor_benchmark`	The company's average rating and review count next to each tracked competitor's, as on the Competitor Benchmark report, with the company's rank, its gap to the leader and to the competitors' average. Defaults to the last 12 months.

Each of these tools needs the same access as its page in Reva: surveys need the Surveys page, owners the Owners page, and the benchmark the Competitor Benchmark report. If your account is restricted to a cohort, the survey and owner tools return only the responses and owners of your units, each owner lists only your units, and get_competitor_benchmark is not available. Owner names and emails a company admin blocked for AI are left out of list_owners, and get_competitor_benchmark returns an error when ratings are blocked.

Reservations

Tool	What it does
`get_reservation`	A reservation's booking dates and unit — reviews reference their `reservation_id`, so assistants can look up the stay behind a review.

Help center

Tool	What it does
`search_help_center`	The help center articles (help.joinreva.com) that answer a how-to question about Reva, with their links. Holds no company data.

Interactive views

In Claude and ChatGPT, get_company_ratings, get_review_stats, get_trending_tags, list_reviews, list_unit_reviews, list_unit_ratings, get_competitor_benchmark and get_staff_performance also show an interactive view in the conversation: the numbers as cards, charts and tables, and the reviews as cards, with buttons that change the period, the grouping or the filters, or open the same data in Reva. Other assistants get the same text result without the view.

Things to try

"Rank my 10 worst-rated units this year and summarize what guests complain about in each."
"Which reviews from the last two weeks haven't been answered? Draft a reply for each."
"Compare my average rating on Airbnb vs Vrbo since January, month by month."
"How many reviews this summer mention the air conditioning, and at which units?"
"What are the top negative sentiment trends across my portfolio, and which buildings do they come from?"
"Give me the Google listing links for all active units in Gulf Breeze."

Limits

Rate limit: 60 requests per minute per connection.
Pagination: review, unit, owner and survey response lists return 20 items per page, and review and survey response lists take per_page up to 100; unit rankings return 100 per page.
Freshness: unit rankings and the unfiltered competitor benchmark are recomputed nightly; everything else is queried live.

Managing connected apps

See and disconnect every app you've authorized at app.joinreva.com/oauth/authorized_applications (also linked from Account → Integrations). Revoking an app signs it out immediately.

Troubleshooting

"Authentication failed" or repeated sign-in prompts: the connection was revoked or expired. Remove the connector in your client and add it again.
"You are not authorized to perform this action": your Reva user doesn't have API product access for that company. For the survey, owner and competitor tools, your user also needs access to the Surveys, Owners or Competitor Benchmark page in Reva. Contact hello@joinreva.com.
Unit rankings come back empty: rankings are computed nightly; a newly connected company populates after its first overnight refresh.
Trending tags for periods older than a year: pass an explicit earlier min_date; the tool defaults to the last 12 months.