MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: list_merchants

Recupera una lista completa de todos los comercios de Google Pay asociados con la cuenta autenticada. Según el rol del usuario en un comercio, los administradores pueden ver la información detallada completa del comercio, mientras que los desarrolladores solo pueden ver la información básica.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP list_merchants.

Solicitud de Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Es el mensaje de solicitud para enumerar comercios.

ListMerchantsRequest

Representación JSON 
{
  "view": enum (MerchantView)
}
Campos
view

enum (MerchantView)

Opcional. Especifica el nivel de detalle que se devolverá para cada comercio.

MerchantView

Es el nivel de detalle que se devolverá para cada comercio.

Enums
MERCHANT_VIEW_UNSPECIFIED Es el valor predeterminado o no establecido. La API usará la vista BASIC de forma predeterminada.
MERCHANT_VIEW_BASIC Incluye información básica sobre el comercio.
MERCHANT_VIEW_FULL Incluya todos los detalles sobre el comerciante.

Esquema de salida

Es el mensaje de respuesta para enumerar comercios.

ListMerchantsResponse

Representación JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Campos
merchants[]

object (Merchant)

Son los comercios a los que el usuario tiene acceso.

Comercio

Representación JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Campos
merchantId

string

Solo salida. Es el identificador único del comercio.
displayName

string

Obligatorio. Es el nombre visible del comercio.
regionCode

string

Obligatorio. Es el código de región de la ubicación de la empresa del comercio. El formato son los códigos de región CLDR de Unicode, p.ej., "US". No se admite la India ("IN").
mcc

enum (Mcc)

Obligatorio. Es el código de categoría del comercio (MCC) del comercio.
corporateWebsiteUrl

string

Obligatorio. Es el sitio web corporativo del comercio.
customerSupportWebsiteUrl

string

Obligatorio. Sitio web de asistencia al cliente del comercio.
customerSupportEmail

string

Obligatorio. Es el correo electrónico de asistencia al cliente del comercio.
customerSupportPhone

string

Obligatorio. Es el número de teléfono de asistencia al cliente del comercio.
state

enum (State)

Solo salida. Es el estado del comercio.

Mcc

Es el código de categoría del comercio (MCC) de un comercio.

Enums
OTHERS Otros
MISC_FOOD_STORES Tiendas de alimentos varios: minimercados y mercados especializados
MISC_APPAREL Tiendas de ropa y accesorios varios
ARTISTS_SUPPLY Tiendas de artículos para artistas y artesanías
AUTOMOTIVE_PARTS Tiendas de repuestos y accesorios para automóviles
HEALTH_AND_BEAUTY Tienda de salud y belleza
BOOKS_PERIODICALS Libros, publicaciones periódicas y periódicos
CAMERA_STORES Tiendas de suministros fotográficos y cámaras
COMPUTERS_EQUIPMENT Computadoras, equipos periféricos para computadoras y software
COMPUTER_SOFTWARE Tiendas de software para computadoras
ELECTRONICS_SALES Ventas de electrónica
GIFT_SHOPS Tiendas de regalos, recuerdos y tarjetas
EATING_PLACES Lugares para comer y restaurantes
MISC_GENERAL_MERCHANDISE Artículos generales varios
HOME_SUPPLY Almacenes de suministros para el hogar
COMPUTER_NETWORK_SERVICES Servicios de redes informáticas
DIGITAL_GOODS_MEDIA Bienes digitales: Libros, películas y música
DIGITAL_GOODS_GAMES Bienes digitales: Juegos
DIGITAL_GOODS_APPLICATIONS Bienes digitales: Aplicaciones (no incluye juegos)
POLITICAL_ORGANIZATIONS Organizaciones políticas
CHARITABLE_ORGANIZATIONS Organizaciones benéficas y de servicios sociales
DRUG_STORES Droguerías y farmacias
REAL_ESTATE_RENTALS Agentes y administradores inmobiliarios: alquileres
MISC_PERSONAL_SERVICES Servicios personales diversos, no clasificados en otra parte
SPORTING_GOODS Tiendas de deportes
STATIONERY_OFFICE_SUPPLIES Papelería, artículos de oficina, papel para impresión y escritura
THEATRICAL_TICKET_AGENCIES Agencias de venta de entradas para cine
TIMESHARES Tiempos compartidos
TOURIST_ATTRACTIONS Atracciones y exhibiciones turísticas
HOBBY_TOY_GAME_SHOPS Tiendas de pasatiempos, juguetes y juegos
PET_SHOPS Tiendas de mascotas, tiendas de alimentos y suministros para mascotas
OTHER_LODGING Otros alojamientos: hoteles, moteles y complejos turísticos
TELECOMMUNICATION_SERVICES Servicios de telecomunicaciones
TRANSPORTATION_SERVICES Servicios de transporte
OTHER_AIRLINES Otras aerolíneas
TRAVEL_AGENCIES Agencias de viajes y operadores turísticos
GOVERNMENT_OWNED_LOTTERIES_US Loterías administradas por el Gobierno (solo para la región de EE.UU.)
GOVERNMENT_LICENSED_CASINOS_US Casinos en línea con licencia gubernamental (juegos de apuestas en línea) (solo para la región de EE.UU.)
BETTING Apuestas (incluidos billetes de lotería, fichas de casino, apuestas fuera del hipódromo y apuestas)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterías administradas por el Gobierno (regiones fuera de EE.UU.)

Estado

Es el estado de un comercio.

Enums
STATE_UNSPECIFIED El estado del comercio no está especificado.
VERIFIED El comercio está verificado y aprobado.
IN_REVIEW La edición del perfil de comercio está en proceso de revisión.
REJECTED Se rechaza la edición del perfil del comerciante.
INCOMPLETE_SIGNUP El perfil del comercio está incompleto.
SANCTIONS_HIT El perfil de comercio está sujeto a sanciones.
READY_FOR_REVIEW El perfil del comercio está completo y listo para su revisión.
DISABLED El perfil del comercio está inhabilitado o inactivo.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌