Skip to main content
Glama
pulse-verity

pulse-verity

Verify a Signed Print

verify_print
Read-onlyIdempotent

Verify signed crypto price prints locally with ECDSA P-256/SHA-256 to confirm signatures, authenticated fields, and record validity before relying on price, source, or freshness data.

Instructions

Verify a signed print locally with ECDSA P-256/SHA-256. Legacy valid authenticates only the v1 canonical price fields. Pass the whole print including v2 to authenticate its complete live, archive or daily-close index record; agents using sources, confidence, interval or cadence must require recordValid=true. Live records sign 18 fields; archive records sign 13 without freshness ages, and daily-close records add signed assetId and closeDay. v2.signedFields lists exactly what is authenticated. kind selects the format and is not signed. Added non-null freshness ages invalidate archived verification. verificationScope is full-record only when both signatures and all required fields match, price-only for a valid v1 print without v2, or invalid otherwise. metadataSigned equals recordValid. deltaMs and surrounding metadata remain unsigned. Public keys come from /api/index/v1/pubkey, cached five minutes with refresh at most every 30 seconds. Each supplied kid selects only its exact published key; v1 prints without kid (or with kid null, as some history rows carry) use the bounded ring. No API key is sent to the key endpoint. Invalid verification can mean alteration or a key no longer published. Works without a developer key.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbol": "<symbol>",
      "price": "<price>",
      "at": "<at>",
      "grade": "<grade>",
      "signature": "<signature>"
    },
    "name": "verify_print"
  }
}

Input Schema

NameRequiredDescriptionDefault
atYesTimestamp from the print, unchanged
v2NoThe unchanged v2 block, which signs price and quality fields together
kidNoSigning key identifier, when provided by the API; null counts as absent
sigNoSignature version from the print (pulse-index-v1), when provided
kindNoSelects the daily-close record format; this selector is not itself signed
tierNoCoverage tier from the print, unchanged, when provided
gradeYesQuality grade from the print, unchanged, e.g. consensus
priceYesPrice from the print, unchanged (text or number)
engineNoPricing engine label from the print, unchanged, when provided
symbolYesCrypto ticker symbol, e.g. BTC, ETH, SOL
assetIdNoAsset identifier from the print, unchanged, when provided
cadenceNoCadence block from the print, unchanged, when provided
sourcesNoNumber of exchanges that contributed, from the print, when provided
closeDayNoUTC day of a daily close (YYYY-MM-DD), from the print, when provided
intervalNoPrice interval from the print, unchanged, when provided
priceTextNoExact signed price text, when provided by the API; preserve unchanged
signatureYesECDSA P-256 signature in base64
confidenceNoConfidence score from the print, unchanged, when provided
dispersionBpsNoSpread between contributing exchanges in basis points, from the print, when provided

Output Schema

NameRequiredDescriptionDefault
v2No
errorNo
validNoLegacy price-only signature check. Use recordValid for quality metadata.
checkedNo
keySourceNo
requestIdYesIdentifier for this MCP call; not a signed price field.
recordValidNoBoth signatures and every required v2 field verified. Does not prove freshness or settlement suitability.
metadataSignedNo
verifiedWithKidNo
verificationScopeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed34 schema fields changedv1.3.7
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / assetId / description
      Added value: +"Asset identifier from the print, unchanged, when provided"
    • changedInput schema / properties / cadence / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "band": {
      -        "anyOf": [
      -          {
      -            "maxLength": 40,
      -            "minLength": 1,
      -            "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "calculatedAgeMs": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "newestSourceAgeMs": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "oldestSourceAgeMs": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "p50UpdateMs": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "p95UpdateMs": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "band": {
      +        "anyOf": [
      +          {
      +            "maxLength": 40,
      +            "minLength": 1,
      +            "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Update cadence band, from the print"
      +      },
      +      "calculatedAgeMs": {
      +        "description": "Age of the calculation in milliseconds, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "newestSourceAgeMs": {
      +        "description": "Age of the newest exchange quote in milliseconds, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "oldestSourceAgeMs": {
      +        "description": "Age of the oldest exchange quote in milliseconds, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "p50UpdateMs": {
      +        "description": "Median time between updates in milliseconds, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "p95UpdateMs": {
      +        "description": "95th percentile time between updates in milliseconds, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / cadence / description
      Added value: +"Cadence block from the print, unchanged, when provided"
    • addedInput schema / properties / closeDay / description
      Added value: +"UTC day of a daily close (YYYY-MM-DD), from the print, when provided"
    • removedInput schema / properties / confidence / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / confidence / description
      Added value: +"Confidence score from the print, unchanged, when provided"
    • addedInput schema / properties / confidence / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedInput schema / properties / dispersionBps / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / dispersionBps / description
      Added value: +"Spread between contributing exchanges in basis points, from the print, when provided"
    • addedInput schema / properties / dispersionBps / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • addedInput schema / properties / engine / description
      Added value: +"Pricing engine label from the print, unchanged, when provided"
    • addedInput schema / properties / grade / description
      Added value: +"Quality grade from the print, unchanged, e.g. consensus"
    • changedInput schema / properties / interval / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "lower": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "upper": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "lower",
      -      "upper"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "lower": {
      +        "description": "Lower bound of the price interval, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "upper": {
      +        "description": "Upper bound of the price interval, from the print",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "lower",
      +      "upper"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / interval / description
      Added value: +"Price interval from the print, unchanged, when provided"
    • addedInput schema / properties / price / description
      Added value: +"Price from the print, unchanged (text or number)"
    • removedInput schema / properties / priceText / $ref
      Removed value: -"#/properties/price/anyOf/0"
    • addedInput schema / properties / priceText / maxLength
      Added value: +100
    • addedInput schema / properties / priceText / minLength
      Added value: +1
    • addedInput schema / properties / priceText / pattern
      Added value: +"^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?$"
    • addedInput schema / properties / priceText / type
      Added value: +"string"
    • addedInput schema / properties / sig / description
      Added value: +"Signature version from the print (pulse-index-v1), when provided"
    • changedInput schema / properties / sources / anyOf
      Previous value: -[
      -  {
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maximum": 9007199254740991,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / sources / description
      Added value: +"Number of exchanges that contributed, from the print, when provided"
    • addedInput schema / properties / tier / description
      Added value: +"Coverage tier from the print, unchanged, when provided"
    • removedInput schema / properties / v2 / additionalProperties
      Removed value: -false
    • removedInput schema / properties / v2 / properties / kid / $ref
      Removed value: -"#/properties/kid/anyOf/0"
    • addedInput schema / properties / v2 / properties / kid / description
      Added value: +"v2 signing key identifier, from the print"
    • addedInput schema / properties / v2 / properties / kid / pattern
      Added value: +"^[A-Za-z0-9._:-]{1,64}$"
    • addedInput schema / properties / v2 / properties / kid / type
      Added value: +"string"
    • addedInput schema / properties / v2 / properties / sig / description
      Added value: +"v2 signature version (pulse-index-v2), from the print"
    • addedInput schema / properties / v2 / properties / signature / description
      Added value: +"v2 ECDSA P-256 signature in base64, from the print"
    • addedOutput schema / properties / requestId / pattern
      Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • changedOutput schema / properties / v2 / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "fieldsMatch": {
      -        "type": "boolean"
      -      },
      -      "mismatches": {
      -        "items": {
      -          "maxLength": 80,
      -          "type": "string"
      -        },
      -        "maxItems": 18,
      -        "type": "array"
      -      },
      -      "signatureValid": {
      -        "type": "boolean"
      -      },
      -      "signedFields": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "boolean"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "valid": {
      -        "type": "boolean"
      -      },
      -      "verifiedWithKid": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/properties/verifiedWithKid/anyOf/0"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "valid",
      -      "signatureValid",
      -      "fieldsMatch",
      -      "mismatches",
      -      "signedFields",
      -      "verifiedWithKid"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "fieldsMatch": {
      +        "type": "boolean"
      +      },
      +      "mismatches": {
      +        "items": {
      +          "maxLength": 80,
      +          "type": "string"
      +        },
      +        "maxItems": 18,
      +        "type": "array"
      +      },
      +      "signatureValid": {
      +        "type": "boolean"
      +      },
      +      "signedFields": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {
      +              "type": [
      +                "string",
      +                "number",
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "valid": {
      +        "type": "boolean"
      +      },
      +      "verifiedWithKid": {
      +        "anyOf": [
      +          {
      +            "pattern": "^[A-Za-z0-9._:-]{1,64}$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "valid",
      +      "signatureValid",
      +      "fieldsMatch",
      +      "mismatches",
      +      "signedFields",
      +      "verifiedWithKid"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed8 schema fields changedv1.3.6
    • addedInput schema / properties / kid / anyOf
      Added value: +[
      +  {
      +    "pattern": "^[A-Za-z0-9._:-]{1,64}$",
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / kid / description
      Previous value: -"Signing key identifier, when provided by the API"New value: +"Signing key identifier, when provided by the API; null counts as absent"
    • removedInput schema / properties / kid / pattern
      Removed value: -"^[A-Za-z0-9._:-]{1,64}$"
    • removedInput schema / properties / kid / type
      Removed value: -"string"
    • changedInput schema / properties / v2 / properties / kid / $ref
      Previous value: -"#/properties/kid"New value: +"#/properties/kid/anyOf/0"
    • addedOutput schema / properties / error / properties / batchLimit
      Added value: +{
      +  "maximum": 100000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / error / properties / plan
      Added value: +{
      +  "enum": [
      +    "Developer",
      +    "Basic",
      +    "Builder",
      +    "Commercial",
      +    "Enterprise"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / error / properties / requested
      Added value: +{
      +  "maximum": 100000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
  3. Changed6 schema fields changedv1.3.3
    • addedOutput schema / properties / error / properties / capacityAction
      Added value: +{
      +  "enum": [
      +    "review_plans",
      +    "contact_support"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / error / properties / getKeyUrl
      Added value: +{
      +  "maxLength": 256,
      +  "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:[/?#][^\\s]*)?$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / error / properties / hostedServerUrl
      Added value: +{
      +  "const": "https://mcp.thepulse.markets/api/index/mcp",
      +  "type": "string"
      +}
    • changedOutput schema / properties / error / properties / nextAction / enum
      Previous value: -[
      -  "wait",
      -  "review_access",
      -  "check_limits",
      -  "reconnect",
      -  "check_input",
      -  "choose_another_symbol",
      -  "report_issue"
      -]New value: +[
      +  "wait",
      +  "review_access",
      +  "check_limits",
      +  "reconnect",
      +  "check_input",
      +  "choose_another_symbol",
      +  "report_issue",
      +  "get_key"
      +]
    • addedOutput schema / properties / error / properties / resetAt
      Added value: +{
      +  "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}Z$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / error / properties / upgradeUrl
      Added value: +{
      +  "const": "https://thepulse.markets/developers#/portal/pricing",
      +  "type": "string"
      +}
  4. Changed3 schema fields changedv1.3.1
    • addedInput schema / properties / assetId
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 160,
      +      "minLength": 1,
      +      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / closeDay
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / kind
      Added value: +{
      +  "const": "daily-close",
      +  "description": "Selects the daily-close record format; this selector is not itself signed",
      +  "type": "string"
      +}
  5. Changed9 schema fields changedv1.3.0
    • addedInput schema / properties / cadence
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "band": {
      +          "anyOf": [
      +            {
      +              "maxLength": 40,
      +              "minLength": 1,
      +              "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "calculatedAgeMs": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "newestSourceAgeMs": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "oldestSourceAgeMs": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "p50UpdateMs": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "p95UpdateMs": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / confidence
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / dispersionBps
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / engine
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 64,
      +      "minLength": 1,
      +      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / interval
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "lower": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "upper": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "lower",
      +        "upper"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / sources
      Added value: +{
      +  "anyOf": [
      +    {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / tier
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 20,
      +      "minLength": 1,
      +      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / v2
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The unchanged v2 block, which signs price and quality fields together",
      +  "properties": {
      +    "canonical": {
      +      "description": "The exact signed string from the print, unchanged",
      +      "maxLength": 8192,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "kid": {
      +      "$ref": "#/properties/kid"
      +    },
      +    "sig": {
      +      "const": "pulse-index-v2",
      +      "type": "string"
      +    },
      +    "signature": {
      +      "maxLength": 88,
      +      "minLength": 88,
      +      "pattern": "^[A-Za-z0-9+/]{86}==$",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "sig",
      +    "canonical",
      +    "signature",
      +    "kid"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "checked": {
      +      "maxLength": 512,
      +      "type": "string"
      +    },
      +    "error": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "accountUrl": {
      +          "const": "https://thepulse.markets/developers/access",
      +          "type": "string"
      +        },
      +        "code": {
      +          "pattern": "^[A-Z][A-Z0-9_]{0,79}$",
      +          "type": "string"
      +        },
      +        "nextAction": {
      +          "enum": [
      +            "wait",
      +            "review_access",
      +            "check_limits",
      +            "reconnect",
      +            "check_input",
      +            "choose_another_symbol",
      +            "report_issue"
      +          ],
      +          "type": "string"
      +        },
      +        "retryAfterSeconds": {
      +          "maximum": 86400,
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "retryable": {
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "nextAction"
      +      ],
      +      "type": "object"
      +    },
      +    "keySource": {
      +      "maxLength": 256,
      +      "type": "string"
      +    },
      +    "metadataSigned": {
      +      "type": "boolean"
      +    },
      +    "recordValid": {
      +      "description": "Both signatures and every required v2 field verified. Does not prove freshness or settlement suitability.",
      +      "type": "boolean"
      +    },
      +    "requestId": {
      +      "description": "Identifier for this MCP call; not a signed price field.",
      +      "format": "uuid",
      +      "type": "string"
      +    },
      +    "v2": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "fieldsMatch": {
      +              "type": "boolean"
      +            },
      +            "mismatches": {
      +              "items": {
      +                "maxLength": 80,
      +                "type": "string"
      +              },
      +              "maxItems": 18,
      +              "type": "array"
      +            },
      +            "signatureValid": {
      +              "type": "boolean"
      +            },
      +            "signedFields": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {
      +                    "anyOf": [
      +                      {
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "number"
      +                      },
      +                      {
      +                        "type": "boolean"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "valid": {
      +              "type": "boolean"
      +            },
      +            "verifiedWithKid": {
      +              "anyOf": [
      +                {
      +                  "$ref": "#/properties/verifiedWithKid/anyOf/0"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "required": [
      +            "valid",
      +            "signatureValid",
      +            "fieldsMatch",
      +            "mismatches",
      +            "signedFields",
      +            "verifiedWithKid"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "valid": {
      +      "description": "Legacy price-only signature check. Use recordValid for quality metadata.",
      +      "type": "boolean"
      +    },
      +    "verificationScope": {
      +      "enum": [
      +        "full-record",
      +        "price-only",
      +        "invalid"
      +      ],
      +      "type": "string"
      +    },
      +    "verifiedWithKid": {
      +      "anyOf": [
      +        {
      +          "pattern": "^[A-Za-z0-9._:-]{1,64}$",
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "requestId"
      +  ],
      +  "type": "object"
      +}
  6. First observedv1.1.0

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/idempotent annotations it discloses operational behavior the annotations cannot: keys fetched from /api/index/v1/pubkey, cached five minutes with refresh at most every 30s, no API key sent to that endpoint, works without a developer key, and that invalid results can mean alteration or an unpublished key. It also names explicitly what stays unsigned (deltaMs, surrounding metadata, kind).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence is front-loaded and the content is dense with little padding for a 19-parameter tool, but the remainder is a semicolon-chained wall of text mixing signing scope, key caching, and result semantics, with no grouping. An agent must parse it linearly to extract the v1/v2, kind, and kid rules.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 19 parameters, nested v2/cadence/interval objects, and an output schema, the description covers the remaining conceptual gaps: verificationScope values, that metadataSigned equals recordValid, signed-field counts per record type, and the key-resolution path. Nothing an agent needs before calling is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, so the baseline is 3; the description adds real meaning on top by explaining that kind is a selector and is not signed, that v2.signedFields enumerates exactly what is authenticated, and that kid pins to one published key while absent/null kid falls back to a bounded key ring. It stops short of documenting the freshness-age invalidation per field, though it does cover the archived-record case.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource plus the exact algorithm: 'Verify a signed print locally with ECDSA P-256/SHA-256', and immediately scopes it to the v1 vs v2 distinction, which is what separates it from the sibling retrieval tools such as get_recorded_print.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives conditional guidance an agent can act on: legacy valid only covers v1 canonical price fields, callers needing sources/confidence/interval/cadence must require recordValid=true, and pass the whole print to authenticate v2. It does not name a sibling alternative explicitly, which keeps it short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.