{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uberall Platform MCP Server","description":"Explore the Uberall API to integrate powerful local marketing, reputation management, and business listing solutions into your applications.","keywords":"uberall, api, local marketing, reputation management, business listings, location data, online presence, reviews, local search","lang":"en-US","image":"/assets/logo.7debf27ce4b0f61bb0a268e1ac309f05d031cfa02db9baf02842030a31a09baa.cdc3be38.svg","siteUrl":"https://docs.uberall.com","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://uberall.com","name":"Uberall","contactPoint":{"@type":"ContactPoint","telephone":"+49 (0)30 208 479 320","contactType":"Customer service","email":"api@uberall.com"}},"meta":[{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:title","content":"Uberall API Documentation"},{"name":"twitter:description","content":"Build powerful local marketing solutions with the Uberall API"},{"name":"twitter:image","content":"/assets/logo.7debf27ce4b0f61bb0a268e1ac309f05d031cfa02db9baf02842030a31a09baa.cdc3be38.svg"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"uberall-platform-mcp-server","__idx":0},"children":["Uberall Platform MCP Server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Uberall Platform MCP server"]}," is a hosted ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://modelcontextprotocol.io"},"children":["Model Context Protocol"]}," server that lets AI assistants and agents securely read and analyze your Uberall data using natural language. It exposes Uberall capabilities across Locations Hub, Listings, Reviews, Social, Homepage, and Dashboard as MCP ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tools"]},", and works with any MCP-compatible client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["remote"]}," server: there is nothing to install or run locally. You connect your MCP client to a single HTTPS endpoint and authenticate with your Uberall account."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This hosted server replaces the previous local (stdio) ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uberall-mcp-server"]},", which is now deprecated."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Environment"},"children":["Environment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"URL"},"children":["URL"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Transport"},"children":["Transport"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.uberall.com/mcp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Streamable HTTP"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sandbox"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.sandbox.uberall.com/mcp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Streamable HTTP"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An active ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Uberall account"]}," with access to the data you want to query. If you are not set up yet, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@uberall.com"},"children":["get in touch"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart"},"children":["Getting Started"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An MCP-compatible client that supports remote, streamable-HTTP servers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One of the two supported authentication methods below. For the API-key method, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#get-your-api-keys"},"children":["Get your API keys"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server supports two ways to authenticate, depending on your account type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"oauth-20-recommended-standard-users","__idx":4},"children":["OAuth 2.0 (recommended, standard users)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most users connect via ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]},". Your MCP client opens an Uberall login page in the browser; after you sign in and approve, the client is connected — no API key handling required."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," token refresh is not yet supported, so you will occasionally be asked to re-authenticate. While a session is active the experience is seamless."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"bearer-api-key--api_admin-users","__idx":5},"children":["Bearer API key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API_ADMIN"]}," users)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accounts with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API_ADMIN"]}," role can authenticate by sending their Uberall API key as a bearer token:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer <UBERALL_API_KEY>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Find your key under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Org settings → API Keys"]}," in the Uberall app — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#get-your-api-keys"},"children":["Get your API keys"]}," for the full walkthrough. Use the private server key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["privateKey"]},"); for details on Uberall's keys and token lifecycle, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#authentication-and-versioning"},"children":["Authentication and versioning"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connecting","__idx":6},"children":["Connecting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server works with any MCP client that supports ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["remote, streamable-HTTP"]}," servers. Point your client at the endpoint and authenticate with either OAuth or a bearer API key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most clients accept a JSON server definition like this (OAuth — the first request opens an Uberall login in your browser):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"http\",\n  \"url\": \"https://mcp.uberall.com/mcp\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API_ADMIN"]}," users, supply your API key as a bearer token instead (replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UBERALL_API_KEY"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"http\",\n  \"url\": \"https://mcp.uberall.com/mcp\",\n  \"headers\": { \"Authorization\": \"Bearer UBERALL_API_KEY\" }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to your MCP client's own documentation for where to register a remote/streamable-HTTP server — typically a settings screen, a CLI command, or a JSON config file. To try the server before wiring it into a client, you can also point the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/modelcontextprotocol/inspector"},"children":["MCP Inspector"]}," at the endpoint above."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-tools","__idx":7},"children":["Available tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All tools are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["read-only"]},": they retrieve and analyze your Uberall data and never modify it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each tool is exposed under a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["domain-prefixed name"]}," in the form ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<prefix>_<tool>"]},". The tables below list the tool by its base name; the prefix for each domain is shown in its heading. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find_business"]}," in Locations Hub is exposed as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locationsHub_find_business"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"locations-hub--locationshub_-prefix","__idx":8},"children":["Locations Hub (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locationsHub_"]}," prefix)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find_business"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find businesses (accounts) by name, identifier, status, location count, or product plan."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["find_location"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find locations by search criteria, ID, status, or business."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_business_by_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve a single business by its numeric ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_location_by_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve a single location by its numeric ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_keywords_for_locations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve keywords associated with locations."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_labels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve labels available to apply to locations."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"listings--listings_-prefix","__idx":9},"children":["Listings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listings_"]}," prefix)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_listings_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detailed breakdown of a location's listings across directories (Google, Facebook, Yelp, Apple, …): sync state, URLs, required actions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_google_page_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Google Business Profile data for a location: place ID, verification, categories, address, phone, status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_facebook_page_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Facebook page details connected to a location."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_businesses_by_connection_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Businesses filtered by directory connection status (e.g. disconnected), with reconnect URLs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_locations_by_connection_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Locations filtered by directory connection status, with reconnect URLs and reasons."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reviews--reviews_-prefix","__idx":10},"children":["Reviews (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reviews_"]}," prefix)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_feed_items"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reviews, comments, Q&A, and mentions, filterable by location, channel, date, status, rating, keywords, and more."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_crossfeed_config"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Channel configuration for the account: supported directories and the content types they support."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"social--social_-prefix","__idx":11},"children":["Social (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["social_"]}," prefix)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_social_posts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search existing social posts, filterable by location, business, status, directory, and publication date."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"homepage--homepage_-prefix","__idx":12},"children":["Homepage (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["homepage_"]}," prefix)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Headline performance and Location Performance Score (LPS) insights."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_key_metrics"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Headline metrics (Google searches, impressions, clicks, review rating, reply rate, response time, revenue estimator), current vs. previous period."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_location_score"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Location Performance Score with pillar breakdown (visibility, reputation, engagement) and per-product completeness."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_location_ranking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Locations ranked by Location Performance Score."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_location_benchmark"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Compares your score against peer businesses in the same category and locality."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_location_tasks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open tasks to improve locations, with type, priority, product area, and deep link."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_suggestions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Improvement recommendations per location."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dashboard--dashboard_-prefix","__idx":13},"children":["Dashboard (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dashboard_"]}," prefix)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Analytics over a date range."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_impressions_and_clicks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer-activity metrics (impressions, clicks, calls, direction requests) across Google, Facebook, Bing, and Yelp."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_listing_health"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Listing-health counts across directories: in sync vs. needs attention."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_profile_completeness"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How complete location profiles are: average completeness, missing-data counts, and tiers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_review_response_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How quickly locations reply to reviews: average response time and replied counts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_review_summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review summary: average rating, totals, and per-star breakdown."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_review_trend"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review rating trend over time with interaction counts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_search_keywords"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top Google search keywords that led customers to your locations."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_visibility_index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Visibility Index (0–100) over time across search and maps."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-prompts","__idx":14},"children":["Example prompts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once connected, ask your assistant natural-language questions such as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Which of my locations are disconnected from Google, and how do I reconnect them?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Summarize the reviews with fewer than 3 stars from the last 30 days.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show the listing sync status for location 2946407.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Find all businesses on the Advanced product plan with more than 50 locations.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"How have my impressions and clicks trended over the last 30 days, and which locations have the lowest performance score?\""]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"faq--troubleshooting","__idx":15},"children":["FAQ & troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Why am I occasionally asked to sign in again?"]}," ","Token refresh is not yet supported for OAuth, so sessions are not renewed automatically — browser clients re-authenticate more often than desktop apps. Separately, Uberall access tokens require a fresh manual login after long inactivity; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#access-token-lifecycle-and-authentication"},"children":["Access Token Lifecycle"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["I get a 401 / \"unauthorized\" error."]}," ","For OAuth, make sure you completed the browser sign-in. For the API-key method, confirm the bearer token belongs to an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API_ADMIN"]}," account and is the private server key — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#get-your-api-keys"},"children":["Get your API keys"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No tools show up, or the connector won't connect."]}," ","Check that the URL is exactly ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.uberall.com/mcp"]},", that your client supports remote streamable-HTTP servers, and that authentication completed. Remote MCP servers can also be blocked by a corporate VPN or firewall."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can I try it without touching production data?"]}," ","Yes — point the connector at the sandbox endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.sandbox.uberall.com/mcp"]},". See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart#sandbox-environment"},"children":["Sandbox Environment"]}," for what it supports."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":16},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questions or issues: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:api@uberall.com"},"children":["api@uberall.com"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For how Uberall handles your data, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://uberall.com/en-us/privacy-policy"},"children":["Privacy Policy"]},"."]}]},"headings":[{"value":"Uberall Platform MCP Server","id":"uberall-platform-mcp-server","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"OAuth 2.0 (recommended, standard users)","id":"oauth-20-recommended-standard-users","depth":3},{"value":"Bearer API key ( API_ADMIN users)","id":"bearer-api-key--api_admin-users","depth":3},{"value":"Connecting","id":"connecting","depth":2},{"value":"Available tools","id":"available-tools","depth":2},{"value":"Locations Hub ( locationsHub_ prefix)","id":"locations-hub--locationshub_-prefix","depth":3},{"value":"Listings ( listings_ prefix)","id":"listings--listings_-prefix","depth":3},{"value":"Reviews ( reviews_ prefix)","id":"reviews--reviews_-prefix","depth":3},{"value":"Social ( social_ prefix)","id":"social--social_-prefix","depth":3},{"value":"Homepage ( homepage_ prefix)","id":"homepage--homepage_-prefix","depth":3},{"value":"Dashboard ( dashboard_ prefix)","id":"dashboard--dashboard_-prefix","depth":3},{"value":"Example prompts","id":"example-prompts","depth":2},{"value":"FAQ & troubleshooting","id":"faq--troubleshooting","depth":2},{"value":"Support","id":"support","depth":2}],"frontmatter":{"seo":{"title":"Uberall Platform MCP Server"}},"lastModified":"2026-07-27T14:18:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/platform-mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}