listingsAPI MCP

Listings API MCP

Connect any MCP capable AI assistant to the Listings API and manage business listings, reviews, posts and local analytics across 50 plus directories, maps and search engines.

Website · API docs · MCP page · Claude directory · Get an API key · Apify actors

What the Listings API is

Local search runs on business data. A shop, a clinic or a franchise outlet has a name, an address, a phone number, opening hours, categories and photos, and that data has to be identical on Google, Apple Maps, Bing, Facebook, Yelp, the voice assistants and dozens of smaller directories before search engines trust it enough to rank it. Keeping that data consistent by hand does not scale past a handful of locations.

The Listings API is a REST API that does this job. You store each location once, and the API syncs it to more than 50 publishers, tracks where each listing is live, finds and suppresses duplicates, pulls in the reviews those listings collect, lets you reply to them, publishes posts and offers to the connected profiles, and returns the performance data Google, Facebook and Bing report back. Agencies, multi location brands and franchise systems use it to run local presence for hundreds or thousands of locations from one place.

What this MCP server is

The Model Context Protocol lets an AI assistant call external tools. This server exposes the Listings API as a set of MCP tools, so an assistant such as Claude, Cursor, Windsurf, Gemini CLI or Cline can look up your locations, read your reviews, draft and publish replies, schedule posts and pull analytics in plain conversation, using your own account and your own data.

It is a remote server. It runs at https://listingsapi.com/mcp and uses Streamable HTTP. No local server package or build is required. Point your client at the URL and sign in through its OAuth browser flow, or use an existing API key where the client requires a header.

https://listingsapi.com/mcp

Find it in directories

The same server is listed in these directories, so you can install it from the one your client already uses:

The agent skills in this repository are listed separately; see Agent skills.

What you can do with it

Once connected, the assistant can work across five areas of your account.

Locations. Create and update location profiles, search for locations, and read their details. A location is the master record used by its publisher listings.

Listings and citations. See which publishers currently carry a location and what state each listing is in, list the sites your plan covers, pull the duplicate listings the network has detected for one location or for your whole account, and mark a listing as a duplicate so it gets suppressed, or clear that flag if the match was wrong. Voice assistant coverage is reported separately.

Reviews. Read reviews, fetch specific reviews by ID, inspect review analytics, and publish replies where the connected publisher supports them. Published replies appear on the review site.

Posts. Read existing posts and publish posts to supported connected profiles. Check the current tool contract for supported publishers and payloads.

Analytics. Read Google, Facebook and Bing performance for any location: search views, map views, direction requests, calls, website clicks and the rest, for whatever date range you ask about.

There is also a set of connected account operations for linking a Google or Facebook account, matching its profiles to your locations and creating a brand new Google Business Profile listing for a location that has none.

Destructive operations such as archiving locations and deleting posts are not exposed as MCP tools. Use the MCP guide and the server's documentation tools to check the operations currently available.

Example requests

Once the server is connected, these are the kinds of things you can ask your assistant.

• "List every location we have in Texas and tell me which ones are missing a phone number."
• "Show me all reviews under three stars from the last week across every store, grouped by location."
• "Draft a reply to the latest Google review for the Austin store, keep it under 60 words, and post it."
• "Publish an offer post about 20 percent off servicing to every location in the Northeast region, running through the end of the month."
• "Compare direction requests and phone calls for our top ten stores this month against last month."
• "Which of our locations still do not have a Google Business Profile listing?"

What you need

A ListingsAPI account. See plans and signup for production access, or check Day Pass availability below. OAuth-capable clients let you sign in without copying an API key into a configuration file.

Try it free with a day pass

Check live availability before signup; the Day Pass is offered for limited periods. While open is true, you can activate a free 24-hour sandbox at Day Pass signup. It covers up to 2 locations and syncs to 10 ListingsAPI demo directories. It never writes to real publishers. Reviews, posts, social, analytics, connected accounts, and webhooks are excluded.

Signup asks for your name, email, and company, plus acceptance of the Terms of Service and Privacy Policy. The 24 hours begin when you activate the pass through the emailed link or 6-digit code. Read the Day Pass guide for current limits and activation steps. In an OAuth client, choose Email me a sign-in link with the Day Pass email. For API-key clients, configure the Day Pass key locally using the same API header prefix. Installing a plugin or skill does not start a pass.

Keys carry an access level. A key with Read access covers every lookup and report. Creating and updating locations, replying to reviews, publishing posts and connecting accounts need a key with Write access.

The server accepts two ways of authenticating:

OAuth uses public clients, PKCE, and dynamic client registration. No pre-issued client secret is needed. Start with read access unless your task requires writes. OAuth tokens apply to the MCP endpoint; REST integrations use API keys.

Setup

Use the client instructions below. Replace API-key placeholders only in local settings, and keep credentials out of shared repositories.

Codex

In Add plugin marketplace, enter:

Choose the Listings API marketplace and install Listings API. Complete the browser sign-in and consent flow when prompted. The plugin connects to https://listingsapi.com/mcp and includes the six agent skills already in this repository. Installation does not create a ListingsAPI account or activate a Day Pass.

To register the same marketplace from the Codex CLI:

codex plugin marketplace add https://github.com/listings-api/listingsapi-mcp.git --ref main

The catalog is .agents/plugins/marketplace.json, and the Codex compatibility manifest is .codex-plugin/plugin.json. They reuse the existing skills, logo, and MCP configuration. Keep sparse paths empty so those files remain available. This repo marketplace is separate from the public OpenAI plugin directory; see the official packaging documentation.

Claude Code

claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <your-api-key>"

Claude Desktop

Open claude.ai/directory/listings-api and click Connect. Claude runs the sign-in flow and the connector is ready in Claude Desktop and Claude.ai.

To add it by URL instead, open Settings, then Connectors, then Add custom connector, and enter https://listingsapi.com/mcp as the URL. Claude Desktop will prompt for authentication when the server first requests it.

Cursor

Install it from Cursor Directory, or add to ~/.cursor/mcp.json, or to .cursor/mcp.json inside a project:

{

"mcpServers": { "listingsapi": { "url": "https://listingsapi.com/mcp" } } }

Use Connect on the server entry to complete OAuth in your browser. This repository's Cursor plugin uses the same configuration. If you need API-key authentication, add "headers": { "Authorization": "API " } inside the entry in local settings.

Windsurf

Open the MCP configuration file from your editor's MCP settings; the legacy Windsurf location is ~/.codeium/windsurf/mcp_config.json. Editor versions can use a different path. For a client that supports OAuth, add:

{

"mcpServers": { "listingsapi": { "serverUrl": "https://listingsapi.com/mcp" } } }

Complete the browser authentication prompt. For API-key authentication, add "headers": { "Authorization": "API " } inside the entry in local settings. See the current Cascade MCP documentation for your editor version.

Gemini CLI

Install this repository as an extension:

gemini extensions install https://github.com/listings-api/listingsapi-mcp

Restart Gemini CLI, then run /mcp auth listingsapi and complete the browser sign-in. Use /mcp to inspect the connection and discovered tools. The extension enables OAuth and needs no API-key setting.

For an API-key setup instead of the extension, add this entry to the existing mcpServers object in ~/.gemini/settings.json:

{

"mcpServers": { "listingsapi": { "httpUrl": "https://listingsapi.com/mcp", "headers": { "Authorization": "API ${LISTINGSAPI_API_KEY}" } } } }

Provide LISTINGSAPI_API_KEY through your local environment. Use one connection configuration at a time. See Gemini's MCP documentation for authentication and configuration details.

Cline

Open MCP Servers, then Remote Servers, add https://listingsapi.com/mcp, and