Available Tools

The PlaceOptimizer MCP server exposes 8 tools across two surfaces. The three public tools are served at https://app.placeoptimizer.com/mcp and need no authentication. The five console tools are served at https://app.placeoptimizer.com/api/v1/mcp and require a PlaceOptimizer console session with an active organization and at least the member role.

Public tools (no auth)

ping_console

Lightweight service probe. Confirms reachability of the public endpoint and reports the service identity that the MCP negotiation advertised.

Returns:

{
  "service": "PlaceOptimizer Console",
  "version": "1.0.0",
  "status": "ok"
}

get_audit_overview

What PlaceOptimizer does — a Google Business Profile presence audit for multi-location brands — and how a prospective customer requests a free audit via the marketing-site funnel. Pure copy, no PII.

Returns: a text block describing the audit (listing accuracy, NAP consistency, duplicate detection, review velocity, photo coverage, post cadence, category fit) and pointing to the free-audit funnel at https://placeoptimizer.com/#free-audit.

get_public_endpoints

Lists the public agent-readiness discovery surfaces PlaceOptimizer publishes: the MCP endpoint, the server card, the API catalog, the OAuth-protected resource metadata, the security contact, and the marketing-site llms.txt.

Returns: a text block enumerating the endpoints, for example:

MCP endpoint:           https://app.placeoptimizer.com/mcp
MCP server card:        https://app.placeoptimizer.com/.well-known/mcp/server-card.json
API catalog:            https://app.placeoptimizer.com/.well-known/api-catalog
security.txt:           https://app.placeoptimizer.com/.well-known/security.txt
Marketing llms.txt:     https://placeoptimizer.com/llms.txt

Console tools (authenticated)

The five console tools resolve the session, the active organization, and the GBP data provider once per request, then read through the same provider the dashboard uses. All return JSON text.

list_locations

List the Google Business Profile locations the authenticated organization manages, with health score and source.

Returns: a JSON array of managed locations — each with its title, store code, address, phones, categories, website, regular hours, status, health score, and data source.

get_location_metrics

Fetch post, media, review, and optimization metrics for a single location (insights data).

Returns: a JSON object with the location's post, media, review, and optimization metrics for the current month window.

list_location_reviews

List the reviews (rating, text, author) for a single location.

Returns: a JSON array of reviews — each with rating (1–5), comment text, author name, and timestamps.

list_location_posts

List the Google Business Profile posts published on a single location.

Returns: a JSON array of posts — each with topic type (standard, event, offer, alert), summary, state, and timestamps.

get_org_info

Return the authenticated organization id, name, and the caller's role.

Returns:

{
  "id": "01J...",
  "name": "Acme Retail's Workspace",
  "role": "owner"
}

Example conversation

You: "List my managed locations."

Assistant: calls list_locations → returns the organization's locations with health scores.

You: "What reviews does the store with id locations/123 have?"

Assistant: calls list_location_reviews with locationId: "locations/123" → returns its reviews.

Next steps

• Authentication — how the session is established and the OAuth 2.1 rollout
• Troubleshooting — 401s, missing tools, and other issues