Skip to main content
Glama

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/

Ownership verified
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

C2.7/5.0

Scored across 78 tools

Disambiguation3/5

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.

Naming Consistency3/5

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.

Tool Count1/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.

Completeness4/5

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 tools
analytics_bingBing analytics (deprecated)A
Read-only
Inspect

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 rangeC
Read-only
Inspect

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 rangeC
Read-only
Inspect

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_getGet connected account detailsB
Read-only
Inspect

Returns the details of a single connected Google or Facebook account by its ID.

Inputs: connectedAccountId (required).

connected_accounts_google_foldersList Google Business Profile foldersB
Read-only
Inspect

Returns the Google Business Profile folders (groups) accessible to a connected Google account.

Inputs: connectedAccountId (required), folderName.

connected_accounts_listList connected accountsB
Read-only
Inspect

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 accountA
Read-only
Inspect

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 sitesB
Read-only
Inspect

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 suggestionsB
Read-only
Inspect

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 DocA
Read-only
Inspect

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 EndpointB
Read-only
Inspect

Get full details of a specific REST API endpoint by operationId.

Inputs: operationId (required).

get_subscriptionGet SubscriptionA
Read-only
Inspect

Get the active subscription and plan details for this account.

Inputs: no named parameters.

get_usageGet UsageB
Read-only
Inspect

Get current API usage and rate-limit headroom.

Inputs: window.

list_api_keysList API KeysA
Read-only
Inspect

List the active API keys for this dev-portal account.

Inputs: no named parameters.

list_endpointsList EndpointsA
Read-only
Inspect

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 locationC
Read-only
Inspect

Get duplicate listings for the given location.

Inputs: locationId (required).

listings_duplicates_rollupDuplicate listing rollup for tagC
Read-only
Inspect

Duplicate listing rollup for tag.

Inputs: tag, page, siteId, status, +1 more.

listings_mark_duplicateMark listings as duplicatesA
Destructive
Inspect

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_premiumList premium listings for a locationA
Read-only
Inspect

The sync status of every publisher directory in the location's plan: syncStatus, displayStatus, actionRequired, the live listingUrl and the connected account per site. The premium tier is fixed by the route; there is no listing-type argument.

Inputs: locationId (required).

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 scanA
Read-only
Inspect

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 scansA
Read-only
Inspect

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 locationC
Read-only
Inspect

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 accountC
Read-only
Inspect

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 IDA
Read-only
Inspect

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 CodesC
Read-only
Inspect

Get locations by the Store Codes.

Inputs: storeCodes (required), fields.

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-categoriesC
Read-only
Inspect

List of sub-categories.

Inputs: no named parameters.

locations_supported_countriesList of supported countriesC
Read-only
Inspect

List of supported countries.

Inputs: includeStates.

locations_updateUpdate a locationB
Destructive
Inspect

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)B
Read-only
Inspect

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 requestC
Read-only
Inspect

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 endpointC
Read-only
Inspect

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 pageC
Read-only
Inspect

Individual social post view page.

Inputs: postId (required).

recent_errorsRecent ErrorsB
Read-only
Inspect

Get the most recent failed API requests (4xx + 5xx) for this account.

Inputs: limit.

reviews_analyticsAnalytics KPIs for a single location over a date rangeC
Read-only
Inspect

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 locationC
Read-only
Inspect

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 locationC
Read-only
Inspect

Time-series review volume / average-rating data for a single location.

Inputs: locationId (required), site, endDate, startDate.

reviews_edit_responseEdit a published review responseA
Destructive
Inspect

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 IDB
Read-only
Inspect

Fetch full review, question or social-mention records by ID.

Inputs: interactionIds.

reviews_listList reviews for a locationB
Read-only
Inspect

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 locationsC
Read-only
Inspect

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 locationsB
Read-only
Inspect

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 locationB
Read-only
Inspect

Per-location review settings, including connected review sites and notification thresholds.

Inputs: locationId (required).

reviews_settings_editUpdate review settings for a locationA
Destructive
Inspect

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)C
Read-only
Inspect

Per-site metadata (colors, icons, plan support).

Inputs: no named parameters.

search_categoriesSearch CategoriesA
Read-only
Inspect

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 DocsA
Read-only
Inspect

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_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.

social_brands_getGet a brandA
Read-only
Inspect

Returns one social brand by its UUID, with its profile details, timezone, archival state and connected-channel count.

Inputs: brandId (required).

social_brands_listList brandsB
Read-only
Inspect

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 brandB
Destructive
Inspect

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_listList a brand's connectionsB
Read-only
Inspect

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 usageA
Read-only
Inspect

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 jobA
Read-only
Inspect

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 postA
Destructive
Inspect

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 postB
Read-only
Inspect

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 commentsA
Read-only
Inspect

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 postsB
Read-only
Inspect

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 detailsA
Read-only
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects 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.
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Country-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).
      5
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      The 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
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.