MewCP Google Business MCP

Lista las ubicaciones de la cuenta especificada, opcionalmente filtradas y ordenadas, y devuelve los objetos Location coincidentes con información de paginación.

Entradas:

- `parent` (string, required) — The name of the account to fetch locations from. If the parent Account is of type PERSONAL, only directly-owned Locations are returned; otherwise all accessible locations (direct or indirect) are returned.
- `read_mask` (string, required) — Comma-separated list of fully qualified field names to return. Example: "user.displayName,photo".
- `page_size` (integer, optional) — How many locations to fetch per page. Default 10, minimum 1, maximum 100.
- `page_token` (string, optional) — Fetches the next page; returned by a previous call when more locations exist than fit the page size.
- `filter_` (string, optional) — Filter constraining which locations to return. Empty means no constraints (all locations, paginated). See Google's "Work with Location Data" guide for valid fields.
- `order_by` (string, optional) — Comma-separated sort fields (SQL syntax). Default ascending; append " desc" for descending. Valid fields: title, storeCode. E.g. "title, storeCode desc".

Esquema de salida data:

{
  locations: {
    name: string;
    languageCode: string | null;
    storeCode: string | null;
    title: string | null;
    phoneNumbers: object | null;
    categories: object | null;
    storefrontAddress: object | null;
    websiteUri: string | null;
    regularHours: object | null;
    specialHours: object | null;
    serviceArea: object | null;
    labels: any[] | null;
    adWordsLocationExtensions: object | null;
    latlng: object | null;
    openInfo: object | null;
    metadata: object | null;
    profile: object | null;
    relationshipData: object | null;
    moreHours: any[] | null;
    serviceItems: any[] | null;
  }[];
  nextPageToken: string | null;
  totalSize: number | null;
}

Crea una nueva Location que será propiedad del usuario conectado y devuelve la Location recién creada.

Entradas:

- `parent` (string, required) — The name of the account in which to create this location.
- `location` (object, required) — Location object to create. Required sub-fields: title (and primaryCategory within categories if categories are set).
- `validate_only` (boolean, optional) — If true, validates the request without actually creating the location.
- `request_id` (string, optional) — A unique request ID for the server to detect duplicate requests. UUIDs recommended. Max 50 characters.

Esquema de salida data:

{
  name: string;
  languageCode: string | null;
  storeCode: string | null;
  title: string | null;
  phoneNumbers: object | null;
  categories: object | null;
  storefrontAddress: object | null;
  websiteUri: string | null;
  regularHours: object | null;
  specialHours: object | null;
  serviceArea: object | null;
  labels: any[] | null;
  adWordsLocationExtensions: object | null;
  latlng: object | null;
  openInfo: object | null;
  metadata: object | null;
  profile: object | null;
  relationshipData: object | null;
  moreHours: any[] | null;
  serviceItems: any[] | null;
}

Devuelve la ubicación especificada tal como la estableció por última vez el comerciante; puede no reflejar actualizaciones de Google o contenido generado por usuarios en vivo en Google Maps.

Entradas:

- `name` (string, required) — The name of the location to fetch.
- `read_mask` (string, required) — Read mask specifying which fields to return in the response. Comma-separated list of fully qualified field names. Example: "title,websiteUri".

Esquema de salida data:

{
  name: string;
  languageCode: string | null;
  storeCode: string | null;
  title: string | null;
  phoneNumbers: object | null;
  categories: object | null;
  storefrontAddress: object | null;
  websiteUri: string | null;
  regularHours: object | null;
  specialHours: object | null;
  serviceArea: object | null;
  labels: any[] | null;
  adWordsLocationExtensions: object | null;
  latlng: object | null;
  openInfo: object | null;
  metadata: object | null;
  profile: object | null;
  relationshipData: object | null;
  moreHours: any[] | null;
  serviceItems: any[] | null;
}

Actualiza los campos de la ubicación especificada según la máscara de actualización proporcionada y devuelve la Location actualizada. Solo se cambian los campos que proporcionas; los demás conservan su valor actual. NOTA: esto sobrescribe los valores de campo actuales — el estado original no se almacena después de la llamada. La respuesta incluye tanto el estado anterior como el posterior para que tengas un registro completo de lo que cambió.

Entradas:

- `location_name` (string, required) — Google identifier for this location, in the form locations/{locationId}.
- `update_mask` (string, required) — The specific fields to update. Comma-separated list of fully qualified field names.
- `location` (object, required) — Location object carrying the updated field values.
- `validate_only` (boolean, optional) — If true, validates the request without actually updating; response is empty unless there are validation errors.

Esquema de salida data:

{
  before: {
    name: string;
    languageCode: string | null;
    storeCode: string | null;
    title: string | null;
    phoneNumbers: object | null;
    categories: object | null;
    storefrontAddress: object | null;
    websiteUri: string | null;
    regularHours: object | null;
    specialHours: object | null;
    serviceArea: object | null;
    labels: any[] | null;
    adWordsLocationExtensions: object | null;
    latlng: object | null;
    openInfo: object | null;
    metadata: object | null;
    profile: object | null;
    relationshipData: object | null;
    moreHours: any[] | null;
    serviceItems: any[] | null;
  };
  after: {
    name: string;
    languageCode: string | null;
    storeCode: string | null;
    title: string | null;
    phoneNumbers: object | null;
    categories: object | null;
    storefrontAddress: object | null;
    websiteUri: string | null;
    regularHours: object | null;
    specialHours: object | null;
    serviceArea: object | null;
    labels: any[] | null;
    adWordsLocationExtensions: object | null;
    latlng: object | null;
    openInfo: object | null;
    metadata: object | null;
    profile: object | null;
    relationshipData: object | null;
    moreHours: any[] | null;
    serviceItems: any[] | null;
  };
}

DESTRUCTIVO — REQUIERE CONFIRMACIÓN EXPLÍCITA DEL USUARIO ANTES DE LLAMAR. Elimina permanentemente la ubicación. Esta acción es irreversible — la ubicación y sus datos no se pueden recuperar a través de esta API (el sitio web de Google Business Profile puede ofrecer otras vías de recuperación). NUNCA llames a esta herramienta de forma autónoma o como parte de un flujo automatizado. DEBES detenerte, informar al usuario exactamente qué se eliminará y que es permanente, y esperar su confirmación escrita explícita antes de continuar.

Entradas:

- `name` (string, required) — The name of the location to delete.

Esquema de salida data:

{
  // no fields — deletion is confirmed by the envelope's success/statusCode
}

Devuelve la ubicación especificada tal como aparece en vivo en Google Maps y Search, que puede diferir de la versión del comerciante, junto con máscaras de lo que Google cambió y lo que aún está pendiente.

Entradas:

- `name` (string, required) — The name of the location to fetch.
- `read_mask` (string, required) — Comma-separated list of fully qualified field names to return.

Esquema de salida data:

{
  location: object;
  diffMask: string | null;
  pendingMask: string | null;
}

Recupera los atributos de una ubicación tal como los estableció por última vez el comerciante.

Entradas:

- `name` (string, required) — Google identifier for this location, in the form locations/{locationId}/attributes.

Esquema de salida data:

{
  name: string;
  attributes: {
    name: string;
    valueType: string | null;
    values: any[] | null;
    repeatedEnumValue: object | null;
    uriValues: any[] | null;
  }[];
}

Actualiza los atributos de una ubicación determinada según la máscara de atributos proporcionada y devuelve los Attributes actualizados. Solo se cambian los campos que proporcionas; los demás conservan su valor actual. NOTA: esto sobrescribe los valores de campo actuales — el estado original no se almacena después de la llamada. La respuesta incluye tanto el estado anterior como el posterior para que tengas un registro completo de lo que cambió.

Entradas:

- `attributes_name` (string, required) — Google identifier for this location, in the form locations/{locationId}/attributes.
- `attribute_mask` (string, required) — Attribute names (as attributes/{attribute}) to update. Every attribute you want updated must be in both attributes and attributeMask. To delete an attribute, put it in attributeMask with no matching entry in attributes.
- `name` (string, required) — Google identifier for this location, in the form locations/{locationId}/attributes (body field, same value as attributes.name).
- `attributes` (array<object>, optional) — The attributes to set (each with name, valueType, values, repeatedEnumValue, uriValues). May be empty when deleting all attributes via attributeMask.

Esquema de salida data:

{
  before: {
    name: string;
    attributes: {
      name: string;
      valueType: string | null;
      values: any[] | null;
      repeatedEnumValue: object | null;
      uriValues: any[] | null;
    }[];
  };
  after: {
    name: string;
    attributes: {
      name: string;
      valueType: string | null;
      values: any[] | null;
      repeatedEnumValue: object | null;
      uriValues: any[] | null;
    }[];
  };
}

Recupera los atributos de una ubicación tal como aparecen en vivo en Google Maps y Search, que pueden diferir de la versión del comerciante.

Entradas:

- `name` (string, required) — Google identifier for this location, in the form locations/{locationId}/attributes.

Esquema de salida data:

{
  name: string;
  attributes: {
    name: string;
    valueType: string | null;
    values: any[] | null;
    repeatedEnumValue: object | null;
    uriValues: any[] | null;
  }[];
}

Obtiene la cadena especificada, devolviendo NOT_FOUND si la cadena no existe.

Entradas:

- `name` (string, required) — The chain's resource name, in the format `chains/{chain_place_id}`.

Esquema de salida data:

{
  name: string;
  chainNames: {
    displayName: string | null;
    languageCode: string | null;
  }[] | null;
  websites: {
    uri: string | null;
  }[] | null;
  locationCount: number | null;
}

Busca una cadena según su nombre y devuelve la lista de cadenas coincidentes.

Entradas:

- `chain_name` (string, required) — Search for a chain by its name. Exact/partial/fuzzy/related queries are supported. Examples: "walmart", "wal-mart", "walmmmart", "沃尔玛".
- `page_size` (integer, optional, default: 10) — The maximum number of matched chains to return from this query. Default is 10, maximum is 500.

Esquema de salida data:

{
  chains: {
    name: string;
    chainNames: {
      displayName: string | null;
      languageCode: string | null;
    }[] | null;
    websites: {
      uri: string | null;
    }[] | null;
    locationCount: number | null;
  }[] | null;
}

Devuelve una lista de categorías de negocios que coinciden con el inicio del nombre de la categoría (por ejemplo, 'food' coincide con 'Food Court' pero no con 'Fast Food Restaurant').

Entradas:

- `region_code` (string, required) — The ISO 3166-1 alpha-2 country code.
- `language_code` (string, required) — The BCP 47 code of the language.
- `view` (string, required) — Specifies which parts of the Category resource to return. Values: `CATEGORY_VIEW_UNSPECIFIED` (equivalent to `BASIC`), `BASIC` (only `displayName`, `category_id`, `languageCode`), `FULL` (all fields).
- `filter_` (string, optional) — Filter string from the user; the only supported field is `displayName`, e.g. `filter=displayName=foo`.
- `page_size` (integer, optional) — How many categories to fetch per page. Default is 100, minimum is 1, maximum is 100.
- `page_token` (string, optional) — If specified, fetches the next page of categories.

Esquema de salida data:

{
  categories: {
    name: string | null;
    displayName: string | null;
    languageCode: string | null;
  }[] | null;
  nextPageToken: string | null;
}

Devuelve una lista de categorías de negocios para el idioma y los IDs de categoría (GConcept) proporcionados.

Entradas:

- `names` (array<string>, required) — The GConcept ids the localized category names should be returned for. Repeat this parameter to request more than one category; at least one name must be set.
- `language_code` (string, required) — The BCP 47 code of the language that the category names should be returned in.
- `view` (string, required) — Specifies which parts of the Category resource to return. Values: `CATEGORY_VIEW_UNSPECIFIED` (equivalent to `BASIC`), `BASIC` (only `displayName`, `category_id`, `languageCode`), `FULL` (all fields).
- `region_code` (string, optional) — The ISO 3166-1 alpha-2 country code used to infer non-standard language.

Esquema de salida data:

{
  categories: {
    name: string | null;
    displayName: string | null;
    languageCode: string | null;
  }[] | null;
}

Devuelve la lista de atributos que estarían disponibles para una ubicación con la categoría principal y el país dados. Proporciona exactamente uno de: parent (el nombre de recurso de una ubicación existente), O category_name junto con region_code y language_code. Establece show_all en true para obtener metadatos de todos los atributos disponibles independientemente de parent/category_name — en ese caso, region_code y language_code son obligatorios. Usa page_token de una respuesta anterior para paginar los resultados.

Entradas:

- `parent` (string, optional) — Resource name of the location to look up available attributes for. If set, category_name, region_code, language_code and show_all are not required and must not be set.
- `category_name` (string, optional) — The primary category stable ID to find available attributes. Must be of the format categories/{category_id}.
- `region_code` (string, optional) — The ISO 3166-1 alpha-2 country code to find available attributes.
- `language_code` (string, optional) — The BCP 47 code of language to get attribute display names in. Falls back to English if unavailable.
- `show_all` (boolean, optional) — If true, metadata for all available attributes is returned, disregarding parent and category_name. region_code and language_code are required when this is true.
- `page_size` (integer, optional) — How many attributes to include per page. Default is 200, minimum is 1.
- `page_token` (string, optional) — If specified, the next page of attribute metadata is retrieved.

Esquema de salida data:

{
  attributeMetadata: {
    parent: string | null;
    valueType: string | null;
    displayName: string | null;
    groupDisplayName: string | null;
    repeatable: boolean | null;
    valueMetadata: any[] | null;
    deprecated: boolean | null;
  }[] | null;
  nextPageToken: string | null;
}

Busca todas las ubicaciones posibles en Google que coincidan con la solicitud especificada y devuelve las entradas GoogleLocation coincidentes. Se debe proporcionar exactamente uno de location o query.

Entradas:

- `page_size` (integer, optional) — The number of matches to return. Default is 3, maximum is 10. No pagination.
- `location` (object, optional) — Union field `search_query` — exactly one of `location` or `query` is required. Location to search for; if provided, finds locations matching the provided details.
- `query` (string, optional) — Union field `search_query` — exactly one of `location` or `query` is required. Text query to search for. Less accurate than an exact location, but can surface more inexact matches.

Esquema de salida data:

{
  googleLocations: {
    name: string | null;
    location: object | null;
    requestAdminRightsUri: string | null;
  }[] | null;
}

Devuelve los valores para cada fecha en un rango de tiempo dado para una única métrica diaria especificada. Solo están disponibles datos diarios; las métricas por hora no son compatibles.

Entradas:

- `name` (string, required) — The location for which the time series should be fetched. Format: `locations/{locationId}` where `locationId` is an unobfuscated listing id.
- `daily_metric` (string, required) — The metric to retrieve time series for. One of: `DAILY_METRIC_UNKNOWN`, `BUSINESS_IMPRESSIONS_DESKTOP_MAPS`, `BUSINESS_IMPRESSIONS_DESKTOP_SEARCH`, `BUSINESS_IMPRESSIONS_MOBILE_MAPS`, `BUSINESS_IMPRESSIONS_MOBILE_SEARCH`, `BUSINESS_CONVERSATIONS`, `BUSINESS_DIRECTION_REQUESTS`, `CALL_CLICKS`, `WEBSITE_CLICKS`, `BUSINESS_BOOKINGS`, `BUSINESS_FOOD_ORDERS`, `BUSINESS_FOOD_MENU_CLICKS`.
- `daily_range` (object, required) — The timerange to fetch. `{ "startDate": {"year", "month", "day"}, "endDate": {"year", "month", "day"} }`, both inclusive.
- `daily_sub_entity_type` (object, optional) — The sub-entity type/id the time series relates to. Currently no `DailyMetric` supports this (breakdown not available). Union of `dayOfWeek` (enum) or `timeOfDay` (`{"hours", "minutes", "seconds", "nanos"}`).

Esquema de salida data:

{
  timeSeries: {
    datedValues: {
      date: object | null;
      value: string | null;
    }[] | null;
  } | null;
}

Devuelve los valores para cada fecha en un rango de tiempo dado para múltiples métricas diarias especificadas a la vez. Solo están disponibles datos diarios; las métricas por hora no son compatibles.

Entradas:

- `location` (string, required) — The location for which the time series should be fetched. Format: `locations/{locationId}` where `locationId` is an unobfuscated listing id.
- `daily_metrics` (array<string>, required) — The metrics to retrieve time series for. Same enum values as `get_daily_metrics_time_series`. Repeat this parameter for multiple metrics.
- `daily_range` (object, required) — The timerange to fetch. `{ "startDate": {"year", "month", "day"}, "endDate": {"year", "month", "day"} }`, both inclusive.

Esquema de salida data:

{
  multiDailyMetricTimeSeries: {
    dailyMetricTimeSeries: {
      dailyMetric: string | null;
      dailySubEntityType: object | null;
      timeSeries: {
        datedValues: {
          date: object | null;
          value: string | null;
        }[] | null;
      } | null;
    }[] | null;
  }[] | null;
}

Devuelve las palabras clave de búsqueda utilizadas para encontrar un negocio en Search o Maps, cada una acompañada de recuentos de impresiones agregados mensualmente.

Entradas:

- `parent` (string, required) — The location for which the time series should be fetched. Format: `locations/{locationId}` where `locationId` is an unobfuscated listing id.
- `monthly_range` (object, required) — The range in months to aggregate search keyword impressions over. `{ "startMonth": {"year", "month", "day"}, "endMonth": {"year", "month", "day"} }`, both inclusive — only year and month are considered.
- `page_size` (integer, optional, default: 100) — Number of results requested. Default 100, maximum 100.
- `page_token` (string, optional) — Base64-encoded token indicating the next paginated result to return.

Esquema de salida data:

{
  searchKeywordsCounts: {
    searchKeyword: string | null;
    insightsValue: {
      value: string | null;
      threshold: string | null;
    } | null;
  }[] | null;
  nextPageToken: string | null;
}

Cada herramienta devuelve la misma envoltura de nivel superior. Solo data varía según la herramienta.

// Success
{
  "success": true,
  "statusCode": 200,
  "retriable": false,
  "retry_after_seconds": null,
  "error": null,
  "data": { ... }
}

// Error
{
  "success": false,
  "statusCode": 400,
  "retriable": false,
  "retry_after_seconds": null,
  "error": { "code": "VALIDATION_ERROR", "message": "page_size must be between 1 and 100", "details": null },
  "data": null
}

• retriable — true cuando es seguro reintentar (límite de velocidad, error de red, 503). false para errores de validación y autenticación.
• retry_after_seconds — segundos a esperar antes de reintentar; presente solo cuando retriable es true y el upstream especifica un retraso.
• error.code — cadena legible por máquina: VALIDATION_ERROR (entrada incorrecta, detectada antes de realizar la llamada), AUTH_ERROR (sin token de acceso OAuth en la credencial), UPSTREAM_ERROR (la API de Google devolvió un estado de error), SERVER_ERROR (fallo inesperado).

• page_size — Número máximo de resultados a devolver por página. Cada herramienta de listado/búsqueda define su propio valor predeterminado y máximo — consulta las Entradas de esa herramienta.
• page_token — Token de paginación opaco de la nextPageToken de una respuesta anterior (o equivalente), utilizado para obtener la siguiente página de resultados.
• filter_ — Expresión de filtro específica de la herramienta que restringe qué registros se devuelven; los campos compatibles difieren según la herramienta (consulta list_locations y list_categories).

Ubicación:

locations/{locationId}
Example: locations/12345678901234567890

Atributos de Ubicación:

locations/{locationId}/attributes
Example: locations/12345678901234567890/attributes

Atributo:

attributes/{attribute}
Example: attributes/has_wifi

Cadena:

chains/{chain_place_id}
Example: chains/10248

Categoría:

categories/{category_id}
Example: categories/gcid:coffee_shop

• Causa: Token de acceso OAuth no proporcionado en los encabezados de la solicitud o formato incorrecto
• Solución:
  1. Verifica que los encabezados Authorization: Bearer YOUR_ACCESS_TOKEN y X-Mewcp-Credential-Id: CREDENTIAL-ID estén presentes
  2. Comprueba que tu credencial de Google esté activa en tu cuenta de MewCP

• Causa: Las llamadas a la API han superado tus límites de solicitudes
• Solución:
  1. Revisa el uso de créditos en tu panel de Curious Layer
  2. Mejora a un plan de pago o agrega créditos para límites más altos
  3. Contacta al soporte para ajustes de créditos

• Causa: No hay ninguna credencial de Google vinculada a tu cuenta
• Solución:
  1. Ve a Credenciales en tu panel de MewCP
  2. Conecta tu cuenta de Google mediante OAuth
  3. Reintenta la solicitud con el encabezado X-Mewcp-Credential-Id correcto

• Causa: La carga útil JSON no es válida o le faltan campos obligatorios
• Solución:
  1. Valida la sintaxis JSON antes de enviar
  2. Asegúrate de que todos los parámetros obligatorios de la herramienta estén incluidos
  3. Verifica que los tipos de parámetros coincidan con los valores esperados

• Causa: Nombre de servidor incorrecto en el endpoint de la API
• Solución:
  1. Verifica el formato del endpoint: {server-name}/mcp/{tool-name}
  2. Usa el nombre de servidor correcto de la documentación
  3. Revisa los servidores disponibles en tu cuenta de Curious Layer

• Causa: Una llamada ascendente a la API de My Business Business Information o a la API de Business Profile Performance devolvió un error
• Solución:
  1. Consulta el Panel de estado de Google Cloud para ver si hay interrupciones
  2. Verifica que tu cuenta de Google sea propietaria o administradora de la ubicación del negocio y que el alcance business.manage se haya otorgado durante OAuth
  3. Revisa el mensaje de error para obtener detalles específicos

• Referencia de la API de My Business Business Information — Referencia completa de endpoints para ubicaciones, cadenas, categorías, atributos y Google Locations
• Referencia de la API de Business Profile Performance — Referencia completa de endpoints para métricas de rendimiento e impresiones de palabras clave de búsqueda
• Documentación de FastMCP — Especificación de FastMCP
• Credenciales de FastMCP — Paquete de credenciales de FastMCP para el manejo de credenciales