Listings API
Server Details
Listings API connects AI assistants to business listings, reviews, social posting and local analytics across 50+ sites. Manage business information, monitor listing sync, respond to reviews, publish posts and track performance through one MCP connection with OAuth or API-key authentication. Get started with the free 24-hour Day Pass: test listing creation, updates and sync with up to two demo locations across ten demo directories, with no credit card required. The Day Pass uses demo directories only; reviews, social posting and analytics require an eligible plan. Get your Day Pass : https://listingsapi.com/signup?campaign=daypass&plan=day-pass Day Pass guide for agents : https://listingsapi.com/docs/day-pass Visit Listings API: https://www.listingsapi.com/
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- listings-api/listingsapi-mcp
- GitHub Stars
- 0
- Server Listing
- Listings API MCP
- ChatGPT
- –
- Claude
- Listings API
TDQS
Scored across 78 tools
Most tools target distinct resources/actions, but several boundaries are muddy: connected_accounts_create_connect_url overlaps the Google and Facebook connect-link tools, posts_create_social vs social_posts_create both create social posts, and account-summary tools like whoami/get_subscription/get_usage overlap conceptually. Detailed descriptions help, but with 78 tools an agent can still misselect among similar-sounding operations.
Names are all snake_case and mostly resource_action oriented, but conventions are mixed: verb-first tools (get_doc, list_endpoints, search_docs), resource-first tools (locations_create, reviews_list), and inconsistent word orders within connected_accounts_*. The pattern is readable but not predictable enough for a 5.
78 tools is an extreme surface for an MCP server and far beyond the typical 3-15 tool range. Even for a broad Listings API domain, this many operations creates high selection burden and suggests many tools should be consolidated or grouped behind fewer parameterized endpoints.
The surface covers major workflows well: locations, connected accounts, listings scans/duplicates, reviews, social posts/brands, analytics, media, and developer docs. Minor gaps remain around lifecycle operations such as archiving/disconnecting/deleting some resources, but most core agent workflows are workable.
Available Tools
78 toolsanalytics_bingBing analytics (deprecated)ARead-onlyInspect
Deprecated. Bing no longer provides Bing Places insights, and no Bing analytics are available after August 2024, so this returns an empty views array for any later date range. Use analytics_google or analytics_facebook for profile metrics.
Inputs: locationId (required), toDate, fromDate.
analytics_facebookFacebook v4 metrics for a single location over a date rangeCRead-onlyInspect
Facebook v4 metrics for a single location over a date range.
Inputs: locationId (required), toDate, fromDate.
analytics_googleGoogle My Business v4 metrics for a single location over a date rangeCRead-onlyInspect
Google My Business v4 metrics for a single location over a date range.
Inputs: locationId (required), toDate, fromDate.
connected_accounts_confirm_matchesConfirm connection matchesCInspect
Confirms suggested location-to-listing matches returned by the connection suggestions endpoint.
Inputs: matchRecordIds (required).
connected_accounts_connect_listingConnect a listing to a locationCInspect
Links a specific Google Business Profile or Facebook listing to a Listings API location.
Inputs: locationId (required), connectedAccountId (required), connectedAccountListingId (required).
connected_accounts_create_connect_urlGet google/facebook oauth linkDInspect
Get google/facebook oauth link
Inputs: site (required), errorUrl (required), locationId (required), successUrl (required).
connected_accounts_create_google_listingCreate a Google listing for a locationBInspect
Creates a new Google Business Profile listing for an existing Listings API location and links it to a connected Google account.
Inputs: locationId (required), connectedAccountId (required), folderId.
connected_accounts_create_location_from_listingCreate a location from a listingCInspect
Creates a new Listings API location from an existing Google Business Profile or Facebook listing in a connected account.
Inputs: connectedAccountId (required), connectedAccountListingId (required), tenure.
connected_accounts_facebook_connect_linkGet a Facebook connection linkCInspect
Returns an OAuth URL to link a Facebook Pages account to your Listings API account.
Inputs: errorUrl (required), successUrl (required), entityId, platform, +1 more.
connected_accounts_getGet connected account detailsBRead-onlyInspect
Returns the details of a single connected Google or Facebook account by its ID.
Inputs: connectedAccountId (required).
connected_accounts_google_connect_linkGet a Google connection linkBInspect
Returns an OAuth URL to link a Google Business Profile account to your Listings API account.
Inputs: errorUrl (required), successUrl (required), entityId, platform, +1 more.
connected_accounts_google_foldersList Google Business Profile foldersBRead-onlyInspect
Returns the Google Business Profile folders (groups) accessible to a connected Google account.
Inputs: connectedAccountId (required), folderName.
connected_accounts_listList connected accountsBRead-onlyInspect
Returns the Google and Facebook accounts connected to your Listings API account, with connection health and linked-location counts.
Inputs: page, status, perPage, publisher.
connected_accounts_listingsList listings for a connected accountARead-onlyInspect
Read the Google Business Profile or Facebook listings available to a connected account. Requires connectedAccountId from connected_accounts_list; supports locationInfo search and page/perPage pagination. Returns listing IDs, names, addresses, phone numbers and live links for use with connected_accounts_connect_listing. This lookup does not connect or modify listings.
Inputs: connectedAccountId (required), page, perPage, locationInfo.
connected_accounts_plan_sitesList plan sitesBRead-onlyInspect
Returns every publisher directory site included in the account's plan, with each site's ID, URL, and supported countries.
Inputs: includeCountries.
connected_accounts_suggestionsList connection suggestionsBRead-onlyInspect
Returns suggested matches between Listings API locations and Google Business Profile or Facebook listings for a connected account.
Inputs: connectedAccountId (required), page, perPage.
connected_accounts_trigger_matchesTrigger location matchesAInspect
Queue an asynchronous fetch of Google Business Profile and Facebook profiles for the supplied connectedAccountIds, then match them against Listings API locations. Success means queued, not completed; failedIds identifies accounts not queued. Poll connected_accounts_get until requestMatchesStatus is MATCH_COMPLETED, then use connected_accounts_suggestions. This does not confirm matches or connect listings.
Inputs: connectedAccountIds (required).
get_docGet DocARead-onlyInspect
Fetch a documentation page in full, using a path returned by search_docs (e.g. "/docs/api/interactions-list"). search_docs only returns a short excerpt, so call this when the excerpt is not enough — for worked examples, pagination loops, or the complete parameter table. Returns the page frontmatter (including its parameter list) and the full body.
Inputs: path (required).
get_endpointGet EndpointBRead-onlyInspect
Get full details of a specific REST API endpoint by operationId.
Inputs: operationId (required).
get_subscriptionGet SubscriptionARead-onlyInspect
Get the active subscription and plan details for this account.
Inputs: no named parameters.
list_api_keysList API KeysARead-onlyInspect
List the active API keys for this dev-portal account.
Inputs: no named parameters.
list_endpointsList EndpointsARead-onlyInspect
List REST API endpoints from the OpenAPI spec, optionally filtered by category (e.g. "Locations", "Posts", "Reviews", "Analytics", "Listings", "Business Audit", "Connected Accounts", "Supporting APIs").
Inputs: tag.
listings_duplicatesGet duplicate listings for the given locationCRead-onlyInspect
Get duplicate listings for the given location.
Inputs: locationId (required).
listings_duplicates_rollupDuplicate listing rollup for tagCRead-onlyInspect
Duplicate listing rollup for tag.
Inputs: tag, page, siteId, status, +1 more.
listings_mark_duplicateMark listings as duplicatesADestructiveInspect
Flag the supplied listingItemIds as confirmed duplicates for suppression or cleanup. Use listing item IDs from the duplicate-listing tools, optionally scoped by locationId. Success means accepted for suppression; use listings_mark_not_duplicate to clear an incorrect flag.
Inputs: listingItemIds (required), locationId.
listings_mark_not_duplicateMarking the non duplicate listing itemCInspect
Marking the non duplicate listing item.
Inputs: listingItemIds (required), locationId.
listings_scans_createCreate a listings scanAInspect
Start a scan of how any business is listed across the directory network: maps and search engines, data aggregators, local directories and AI assistants. The business does not need to be a location in the account. Takes name, street, city, countryIso (two-letter), phone, and stateIso and postalCode where the country uses them. Returns at once with the scan QUEUED (COMPLETED when a recent scan of the same business is reused); poll listings_scans_get every 15 seconds until the status is COMPLETED or FAILED, or rely on the listing_scan webhook events. A new search uses the monthly allowance that depends on the plan, so check quota.remaining in the response. Needs a read-write API key. Not available on day passes.
Inputs: city (required), name (required), phone (required), street (required), +4 more.
listings_scans_getGet a listings scanARead-onlyInspect
Fetch one listings scan by id with its per-directory results: status FOUND, NOT_FOUND, UNAVAILABLE or PENDING, whether the listing is accurate, and the name, address and phone comparison. UNAVAILABLE means the directory could not be checked this time, not that the business is missing. Results are partial while the scan is QUEUED or IN_PROGRESS; poll every 15 seconds until it is COMPLETED or FAILED. Scans are kept for 90 days.
Inputs: scanId (required).
listings_scans_listList listings scansARead-onlyInspect
List the listings scans of the account, newest first, without their results. Takes page and perPage (1 to 50). Also returns the monthly allowance in quota; use listings_scans_get for one scan with results.
Inputs: page, perPage.
listings_voice_assistantsGet voice assistants for a locationCRead-onlyInspect
Get voice assistants for a location.
Inputs: locationId (required).
locations_add_location_photosAttach photos to a location by public image URLCInspect
Attach photos to a location by public image URL.
Inputs: photos (required), locationId (required).
locations_allAll locations that belong to an accountCRead-onlyInspect
All locations that belong to an account.
Inputs: last, after, first, before, +2 more.
locations_cancel_locations_archiveCancel archival of locationsCInspect
Cancel archival of locations.
Inputs: locationIds (required), clientMutationId.
locations_createCreate a new locationDInspect
Create a new location.
Inputs: name (required), phone (required), bizUrl (required), stateIso (required), +41 more.
locations_get_locations_by_idsGet locations by IDARead-onlyInspect
Fetch existing location records by their base64 Relay IDs returned in each location record's id field. Pass the IDs in locationIds; numeric database IDs are not accepted.
Inputs: locationIds (required), fields.
locations_get_locations_by_store_codesGet locations by the Store CodesCRead-onlyInspect
Get locations by the Store Codes.
Inputs: storeCodes (required), fields.
locations_searchSearch for locationsCRead-onlyInspect
Search for locations.
Inputs: after, first, query, fields, +1 more.
locations_star_location_photosStar or unstar a location's photos. At most four may be starred at once (SY15012)CInspect
Star or unstar a location's photos. At most four may be starred at once (SY15012).
Inputs: starred (required), photoIds, locationId.
locations_subcategoriesList of sub-categoriesCRead-onlyInspect
List of sub-categories.
Inputs: no named parameters.
locations_supported_countriesList of supported countriesCRead-onlyInspect
List of supported countries.
Inputs: includeStates.
locations_updateUpdate a locationBDestructiveInspect
Overwrite the supplied writable fields of an existing location identified by its base64 Relay ID. Omitted fields remain unchanged. Changes can sync to the location's publisher listings.
Inputs: id (required), city, name, phone, +45 more.
media_filesList media files attached to a single location (starred + unstarred)BRead-onlyInspect
List media files attached to a single location (starred + unstarred).
Inputs: locationId (required).
media_upload_statusReturn the status of a bulk add-media-to-location requestCRead-onlyInspect
Return the status of a bulk add-media-to-location request.
Inputs: requestId (required).
posts_create_socialCreate social posts for multiple locationsDInspect
Create social posts for multiple locations.
Inputs: postName (required), postType (required), postSites (required), locationIds (required), +9 more.
posts_rollup_social_posts_by_locationPaginated list of posts for a single location, used by the V4 REST /locations/:id/posts endpointCRead-onlyInspect
Paginated list of posts for a single location, used by the V4 REST /locations/:id/posts endpoint
Inputs: locationId (required), page, perPage.
posts_social_post_viewIndividual social post view pageCRead-onlyInspect
Individual social post view page.
Inputs: postId (required).
recent_errorsRecent ErrorsBRead-onlyInspect
Get the most recent failed API requests (4xx + 5xx) for this account.
Inputs: limit.
reviews_analyticsAnalytics KPIs for a single location over a date rangeCRead-onlyInspect
Analytics KPIs for a single location over a date range.
Inputs: locationId (required), endDate, startDate.
reviews_analytics_by_sitePer-site breakdown of interactions stats for a single locationCRead-onlyInspect
Per-site breakdown of interactions stats for a single location.
Inputs: locationId (required), endDate, startDate.
reviews_analytics_timelineTime-series review volume / average-rating data for a single locationCRead-onlyInspect
Time-series review volume / average-rating data for a single location.
Inputs: locationId (required), site, endDate, startDate.
reviews_edit_responseEdit a published review responseADestructiveInspect
Replace the text of an existing review response on its source site. Use reviews_respond to publish a new response.
Inputs: reviewId (required), responseId (required), responseContent (required), templateId.
reviews_getGet reviews by IDBRead-onlyInspect
Fetch full review, question or social-mention records by ID.
Inputs: interactionIds.
reviews_listList reviews for a locationBRead-onlyInspect
Paginated list of reviews, questions and social mentions for a single location, with filters.
Inputs: locationId (required), last, after, first, +11 more.
reviews_phrasesNewer per-phrase stats breakdown for one or more locationsCRead-onlyInspect
Newer per-phrase stats breakdown for one or more locations.
Inputs: endDate, category, siteUrls, sortOrder, +8 more.
reviews_respondRespond to a reviewBInspect
Publish a reply to a review, question or social mention on the source site.
Inputs: interactionId (required), responseContent (required), respondedWith.
reviews_rollupList reviews across locationsBRead-onlyInspect
Paginated list of reviews, questions and social mentions across every location the key can see. Pass tag to narrow to a location tag; it defaults to "all".
Inputs: tag, last, after, first, +12 more.
reviews_settingsGet review settings for a locationBRead-onlyInspect
Per-location review settings, including connected review sites and notification thresholds.
Inputs: locationId (required).
reviews_settings_editUpdate review settings for a locationADestructiveInspect
Overwrite the supplied review-source settings or positive-rating threshold for a location. The threshold is a star rating from 1 to 5; setting it alone leaves source selection unchanged.
Inputs: locationId (required), siteUrls, positiveInteractionThreshold.
reviews_sourcesPer-site metadata (colors, icons, plan support)CRead-onlyInspect
Per-site metadata (colors, icons, plan support).
Inputs: no named parameters.
search_categoriesSearch CategoriesARead-onlyInspect
Search the ListingsAPI business-category taxonomy by name (case-insensitive). Returns the best matches with their IDs instead of the full ~6,000-row list. createLocation/updateLocation also accept a plain-text category name in subCategoryId — the API fuzzy-matches it server-side.
Inputs: limit, query, primary_only.
search_docsSearch DocsARead-onlyInspect
Search the Listings API developer portal documentation by keyword. Returns matching page titles, descriptions, slugs and a short excerpt. The excerpt is only a fragment — pass a returned path to get_doc to read the whole page, and get_endpoint for an endpoint's full parameter contract.
Inputs: query (required).
social_brands_getGet a brandARead-onlyInspect
Returns one social brand by its UUID, with its profile details, timezone, archival state and connected-channel count.
Inputs: brandId (required).
social_brands_listList brandsBRead-onlyInspect
Returns a paginated list of the social brands on the account, with each brand's profile, timezone and connected-channel count.
Inputs: page, size, filters.
social_brands_updateUpdate a brandBDestructiveInspect
Updates a social brand's name, timezone, website, categories, hashtags or bio. Only the fields sent are changed.
Inputs: profileId (required), bio, logo, siteUrl, +8 more.
social_connections_linkGet a connection linkBInspect
Returns a short-lived hosted URL that walks an end user through connecting one social platform to a brand.
Inputs: brandId (required), channel (required), redirectUrl (required), state, +1 more.
social_connections_listList a brand's connectionsBRead-onlyInspect
Returns the social accounts connected to a brand, with the platform, display name and archival state of each.
Inputs: brandId (required).
social_limitsGet Social plan limits and usageARead-onlyInspect
Returns the account's Social connection cap alongside its current brand and connection usage. Brands are unlimited on API plans, so the brand allowance comes back null.
Inputs: no named parameters.
social_posts_bulk_createCreate social posts in bulkAInspect
Validates and queues up to 500 social posts across brands in one request, returning a job to poll for per-row results.
Inputs: posts (required), name.
social_posts_bulk_jobGet a bulk post jobARead-onlyInspect
Returns the status, counts and per-row results of a bulk social post job created by social_posts_bulk_create.
Inputs: bulkJobId (required).
social_posts_cancel_scheduledCancel a scheduled postADestructiveInspect
Cancels a social post that is still scheduled or in draft so it never publishes. Posts that already went live are unaffected.
Inputs: socialPostId (required).
social_posts_createCreate a social postAInspect
Creates a draft, scheduled or immediately published post on a brand's connected Facebook, Instagram, X, LinkedIn and Pinterest accounts. Distinct from posts_create_social, which posts to Google and Facebook for a location.
Inputs: name (required), action (required), content (required), platforms (required), +9 more.
social_posts_getGet a social postBRead-onlyInspect
Returns one social post with its content, schedule and the per-channel publish status, live link and error.
Inputs: postId (required).
social_posts_insightsGet post insights and commentsARead-onlyInspect
Returns the platform's own engagement payload and comments for one published social post on one connected channel.
Inputs: postId (required), socialConnectedChannelId (required).
social_posts_listList a brand's postsBRead-onlyInspect
Returns a paginated list of a brand's social posts with their content, schedule, platforms and per-channel status.
Inputs: brandId (required), page, size, filters, +1 more.
whoamiGet authenticated account detailsARead-onlyInspect
Read the authenticated Listings API account summary and billing state: whether API access is paused for an unpaid invoice, and the pay link when one is available. Call this after a payment_required or social_payment_required error to get the pay link again.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Your agent needs what customers say in public — Google Business profiles and reviews, Trustpilot, Tripadvisor, hotel listings and the Q&A under a listing. **What you can ask for** • "Pull this business's Google reviews and group the complaints." • "What do Trustpilot reviewers say about this competitor?" • "Find hotels matching this search and their live prices." • "What questions are people asking on this Google listing, and are they answered?" • "Search listings for this category in this city." **How to use it** Point any MCP client at https://mcp.aisa.one/seo-business/mcp and sign in with OAuth — there is no key to create or paste. 22 tools: Google Business info, reviews, extended reviews, updates and Q&A; Trustpilot and Tripadvisor search and reviews; Google hotel info and searches; business listing search; plus Reddit and Pinterest signals for a business. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the reviews here, then ask the same agent what that business ranks for or who links to it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/seo/mcp for all of it at once — rankings, keywords, backlinks, site health and AI-answer visibility across DataForSEO, Semrush and Ahrefs.
Local business leads and website intelligence for AI agents: lead lists, contacts, tracking, SEO and
One API for public web data across social, directories and real estate, as clean JSON.
Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides a scaffold for connecting AI assistants to Microsoft's trusted-partner business listings API, laying groundwork for managing business listing operations over the REST endpoints. It does not yet make live API calls.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceConnects a Google Business Profile to AI assistants like Claude, ChatGPT, Cursor, and Claude Code so users can query local search and Maps performance, track keywords, and monitor reviews through natural language. It also supports write actions for replying to reviews, publishing local posts, and managing photos and menus, with per-account read-only or read-and-write controls.5MIT
- AlicenseAqualityBmaintenanceCountry-agnostic MCP-callable directory for AI agents to find local SMBs — realtors, insurance agents, medical practitioners — by category, location, or natural-language query. Returns business catalog data and UTM-tagged booking URLs (zero PII).5MIT
- FlicenseNot gradedqualityCmaintenanceThe owner-verified local business data + service & menu-price layer for AI agents. Owner-authored business profiles where every response carries provenance — verification level, completeness score, freshness timestamps, and upstream sources. * Search & profiles — find businesses by name, category, city, or geo-radius; full profiles with contacts, hours, media, ratings. * Price layer-
Glama MCP Gateway
Add one secure layer between your agents and this server.
social_brands_createCreate a brandBInspect
Creates a social brand, the container that owns connected social accounts and the posts published from them.
Inputs: timezone (required), profileName (required), bio, logo, +7 more.