find_businessLABSCO SUMMARY
Every reporting surface in Uberall, read-only, inside whichever assistant you already use.
Nothing in the catalogue modifies a listing, a review or a location — every tool retrieves and analyses — so pointing an agent at a multi-location account risks a wrong answer rather than a wrong edit. The reach is what makes it worth wiring up: directory connection status with reconnect URLs, Location Performance Score with its pillar breakdown, and Google, Facebook, Bing and Yelp activity over a date range all arrive as tool results instead of dashboard screens. The local jar this repository once published is archived, so the hosted endpoint is the path that gets maintained.
What it is
Uberall's hosted MCP server at https://mcp.uberall.com/mcp, exposing Locations Hub, Listings, Reviews, Social, Homepage and Dashboard as read-only tools over streamable HTTP. It replaces the local stdio server this repository shipped, which is now archived and read-only, and a sandbox at https://mcp.sandbox.uberall.com/mcp answers the same way against test data.
What you get
- Locations Hub: find_business and find_location by name, identifier, status, location count or product plan, get_business_by_id and get_location_by_id for a single record, plus get_keywords_for_locations and get_labels
- Listings: get_listings_details breaks a location down directory by directory — sync state, URLs, required actions — with get_google_page_details and get_facebook_page_details for the two profiles people ask about most
- get_businesses_by_connection_status and get_locations_by_connection_status return what has fallen off a directory, with the reconnect URLs and the reason
- Reviews: get_feed_items covers reviews, comments, Q&A and mentions, filterable by location, channel, date, status, rating and keyword; get_crossfeed_config says which content types each directory supports
- Homepage: get_location_score gives the Location Performance Score with its visibility, reputation and engagement pillars, and get_location_ranking, get_location_benchmark, get_location_tasks, get_suggestions and get_key_metrics build out from it
- Dashboard over a date range: get_impressions_and_clicks, get_listing_health, get_profile_completeness, get_review_response_time, get_review_summary, get_review_trend, get_search_keywords and get_visibility_index
- Social: search_social_posts, filterable by location, business, status, directory and publication date
- Every tool carries its domain prefix — find_business is called as locationsHub_find_business
Requirements
An active Uberall account with access to the data you want to query, and a client that speaks remote streamable HTTP; there is nothing to install. Standard users connect over OAuth 2.0 and sign in through the browser, while accounts with the API_ADMIN role send the private server key as Authorization: Bearer <UBERALL_API_KEY>. Token refresh is not supported yet, so a long session will ask you to sign in again.
Setup effort
One command, then sign in — claude mcp add-json uberall '{"type":"http","url":"https://mcp.uberall.com/mcp"}', then approve the OAuth sign-in
USE CASES
01
Finding which locations fell off a directory
Filter locations or whole businesses by directory connection status. The reconnect URL and the reason come back with each one, so the fix is in the same result as the diagnosis.
02
Reading the low-star reviews from the last month
Pull feed items filtered by rating, date, channel and location in a single call, and check get_crossfeed_config first if you need to know which directories support replies at all.
03
Explaining a drop in customer activity
Compare impressions, clicks, calls and direction requests across Google, Facebook, Bing and Yelp over a date range, then check whether the Visibility Index moved with them.
04
Deciding which location to fix first
Rank locations by Location Performance Score, read the visibility, reputation and engagement breakdown behind the number, and get the open tasks with their priority and deep link.
05
Auditing a single location before a review meeting
Place ID, verification, categories, address, phone and status for the Google profile, the listing sync state elsewhere, and how complete the profile is — without opening the app.
28 tools
Listed in project docs. Your client may show a different list.
find_locationget_business_by_idget_location_by_idget_keywords_for_locationsget_labelsget_listings_detailsget_google_page_detailsget_facebook_page_detailsget_businesses_by_connection_statusget_locations_by_connection_statusget_feed_itemsget_crossfeed_configsearch_social_postsget_key_metricsget_location_scoreget_location_rankingget_location_benchmarkget_location_tasksget_suggestionsget_impressions_and_clicksget_listing_healthget_profile_completenessget_review_response_timeget_review_summaryget_review_trendget_search_keywordsget_visibility_indexBEFORE YOU INSTALL
What to know first
Tools you get
28 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- An active Uberall account with access to the data you want to query
Where it runs
The documented client connects to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
claude mcp add
TERMINAL
claude mcp add-json uberall '{"type":"http","url":"https://mcp.uberall.com/mcp"}'Hosted endpoint
ENDPOINT URL
https://mcp.uberall.com/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Any MCP client — API key
ANY MCP CLIENT — API KEY · JSON
{
"mcpServers": {
"uberall-mcp-server": {
"type": "http",
"url": "https://mcp.uberall.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_UBERALL_API_KEY>"
}
}
}
}
