MCP Tools Reference: paydeveloper.googleapis.com

Tool: query_merchant_error_metrics

Retrieves detailed error metrics for a specific merchant business profile. This tool provides a granular breakdown of errors, allowing developers to pinpoint and resolve issues.

The following sample demonstrate how to use curl to invoke the query_merchant_error_metrics MCP tool.

Curl Request
  
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": "query_merchant_error_metrics", 
 "arguments": { 
 // provide these details according to the tool' 
s  
MCP  
specification  
 } 
  
 } 
,  
 "jsonrpc" 
:  
 "2.0" 
,  
 "id" 
:  
 1 
 } 
 ' 
  

Input Schema

Request message for querying merchant error metrics.

QueryMerchantErrorMetricsRequest

JSON representation
 { 
 "merchantId" 
 : 
 string 
 , 
 "timeRange" 
 : 
 enum ( TimeRange 
) 
 } 
Fields
merchantId

string

Required. The unique identifier of the merchant for which error metrics are being requested.

timeRange

enum ( TimeRange )

Optional. The time range of the error metrics data.

Output Schema

Response message for querying merchant error metrics.

QueryMerchantErrorMetricsResponse

JSON representation
 { 
 "errorMetrics" 
 : 
 [ 
 { 
 object (  MerchantErrorMetric 
 
) 
 } 
 ] 
 } 
Fields
errorMetrics[]

object ( MerchantErrorMetric )

The error metrics data of the merchant.

MerchantErrorMetric

JSON representation
 { 
 "errorDetail" 
 : 
 { 
 object (  ErrorDetail 
 
) 
 } 
 , 
 "hourlyErrorCounts" 
 : 
 [ 
 { 
 object (  HourlyErrorCount 
 
) 
 } 
 ] 
 } 
Fields
errorDetail

object ( ErrorDetail )

Output only. Details of the error.

hourlyErrorCounts[]

object ( HourlyErrorCount )

Output only. A list of error count and its timestamp, rounded to the nearest top of hour.

ErrorDetail

JSON representation
 { 
 "errorCode" 
 : 
 string 
 , 
 "errorMessage" 
 : 
 string 
 } 
Fields
errorCode

string

Error code, e.g. "OR_BIBED_07".

errorMessage

string

Descriptive message only, no user data nor internal stack traces.

HourlyErrorCount

JSON representation
 { 
 "hourlyTimestamp" 
 : 
 string 
 , 
 "count" 
 : 
 integer 
 } 
Fields
hourlyTimestamp

string ( Timestamp format)

Timestamp representing the start of the hour.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

count

integer

The number of errors within this hour.

Timestamp

JSON representation
 { 
 "seconds" 
 : 
 string 
 , 
 "nanos" 
 : 
 integer 
 } 
Fields
seconds

string ( int64 format)

Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).

nanos

integer

Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Create a Mobile Website
View Site in Mobile | Classic
Share by: