Pulse Verity

Signed Bitcoin and crypto prices for AI agents: multi-exchange prices anyone can verify offline.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
80%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~10,787Tokens (tool definitions)
~11.0 KBTypical response size
Significant attention impact (8.43% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "pulse-verity": {
      "command": "npx",
      "args": [
        "pulse-verity"
      ]
    }
  }
}

Runnable packages

npmpulse-verity1.3.6stdio

Remote endpoints

https://mcp.thepulse.markets/api/index/mcpstreamable-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_index_price(symbol)

Get a current signed crypto index price from /api/index/v1/price. Returns symbol, price, optional priceText, at, grade, signature, kid and sig. Preserve priceText exactly for verify_print. Optional tier, confidence, dispersionBps, interval, sources, engine and cadence describe the observation; they are not covered by the v1 signature, and the v2 block signs them with the price. Pass the whole print, v2 included, to verify_print. Coverage changes: use list_index_assets to discover assets. A stale or unavailable response means no current price, never zero.

Input Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9]+$",
      "description": "Crypto ticker symbol, e.g. BTC, ETH, SOL"
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$"
    },
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "priceText": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "at": {
      "type": "string",
      "maxLength": 40
    },
    "grade": {
      "type": "string",
      "enum": [
        "consensus",
        "blended",
        "indicative",
        "composite",
        "single-source"
      ]
    },
    "signature": {
      "type": "string",
      "minLength": 88,
      "maxLength": 88,
      "pattern": "^[A-Za-z0-9+/]{86}==$"
    },
    "kid": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,64}$"
    },
    "sig": {
      "type": "string",
      "const": "pulse-index-v1"
    },
    "success": {
      "type": "boolean",
      "const": true
    },
    "engine": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "tier": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20
        },
        {
          "type": "null"
        }
      ]
    },
    "confidence": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "dispersionBps": {
      "anyOf": [
        {
          "$ref": "#/properties/confidence/anyOf/0"
        },
        {
          "type": "null"
        }
      ]
    },
    "interval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "lower": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "upper": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "lower",
            "upper"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cadence": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "band": {
              "type": "string",
              "enum": [
                "real-time",
                "five-second",
                "ten-second",
                "slow",
                "unavailable"
              ]
            },
            "calculatedAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "newestSourceAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "oldestSourceAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "p50UpdateMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "p95UpdateMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updatesLast120s": {
              "$ref": "#/properties/sources/anyOf/0"
            }
          },
          "required": [
            "band",
            "calculatedAgeMs",
            "newestSourceAgeMs",
            "oldestSourceAgeMs",
            "p50UpdateMs",
            "p95UpdateMs"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "v2": {
      "type": "object",
      "properties": {
        "sig": {
          "type": "string",
          "const": "pulse-index-v2"
        },
        "canonical": {
          "type": "string",
          "minLength": 1,
          "maxLength": 8192
        },
        "signature": {
          "$ref": "#/properties/signature"
        },
        "kid": {
          "$ref": "#/properties/kid"
        }
      },
      "required": [
        "sig",
        "canonical",
        "signature",
        "kid"
      ],
      "additionalProperties": false
    },
    "sample": {
      "type": "boolean",
      "const": true
    },
    "note": {
      "type": "string",
      "maxLength": 2048
    },
    "getKey": {
      "type": "string",
      "maxLength": 256
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_index_batch(symbols)

Read signed prices for up to 100 symbols per request; this account's plan may allow fewer (get_account_status reports batchMaxSymbols). One /api/index/v1/batch request returns observations with individually signed successful rows and per-symbol errors for unavailable rows. A request over the plan's limit is refused with code TOO_MANY_SYMBOLS: split it. Verify each successful row with verify_print; the v2 block on each row signs its quality fields, while the surrounding batch metadata is not signed. No automatic retries.

Input Schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 20,
        "pattern": "^[A-Za-z0-9]+$",
        "description": "Crypto ticker symbol, e.g. BTC, ETH, SOL"
      },
      "minItems": 1,
      "maxItems": 100
    }
  },
  "required": [
    "symbols"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "requested": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "returned": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "observations": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "symbol": {
                "type": "string",
                "pattern": "^[A-Za-z0-9]{1,20}$"
              },
              "price": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "priceText": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "at": {
                "type": "string",
                "maxLength": 40
              },
              "grade": {
                "type": "string",
                "enum": [
                  "consensus",
                  "blended",
                  "indicative",
                  "composite",
                  "single-source"
                ]
              },
              "signature": {
                "type": "string",
                "minLength": 88,
                "maxLength": 88,
                "pattern": "^[A-Za-z0-9+/]{86}==$"
              },
              "kid": {
                "type": "string",
                "pattern": "^[A-Za-z0-9._:-]{1,64}$"
              },
              "sig": {
                "type": "string",
                "const": "pulse-index-v1"
              },
              "success": {
                "type": "boolean",
                "const": true
              },
              "engine": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 64
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "sources": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "tier": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 20
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "confidence": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "dispersionBps": {
                "anyOf": [
                  {
                    "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "interval": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "lower": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "upper": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "lower",
                      "upper"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cadence": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "band": {
                        "type": "string",
                        "enum": [
                          "real-time",
                          "five-second",
                          "ten-second",
                          "slow",
                          "unavailable"
                        ]
                      },
                      "calculatedAgeMs": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "newestSourceAgeMs": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "oldestSourceAgeMs": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "p50UpdateMs": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "p95UpdateMs": {
                        "anyOf": [
                          {
                            "$ref": "#/properties/observations/items/anyOf/0/properties/confidence/anyOf/0"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "updatesLast120s": {
                        "$ref": "#/properties/observations/items/anyOf/0/properties/sources/anyOf/0"
                      }
                    },
                    "required": [
                      "band",
                      "calculatedAgeMs",
                      "newestSourceAgeMs",
                      "oldestSourceAgeMs",
                      "p50UpdateMs",
                      "p95UpdateMs"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "v2": {
                "type": "object",
                "properties": {
                  "sig": {
                    "type": "string",
                    "const": "pulse-index-v2"
                  },
                  "canonical": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 8192
                  },
                  "signature": {
                    "$ref": "#/properties/observations/items/anyOf/0/properties/signature"
                  },
                  "kid": {
                    "$ref": "#/properties/observations/items/anyOf/0/properties/kid"
                  }
                },
                "required": [
                  "sig",
                  "canonical",
                  "signature",
                  "kid"
                ],
                "additionalProperties": false
              },
              "sample": {
                "type": "boolean",
                "const": true
              },
              "note": {
                "type": "string",
                "maxLength": 2048
              },
              "getKey": {
                "type": "string",
                "maxLength": 256
              }
            },
            "required": [
              "symbol",
              "price",
              "at",
              "grade",
              "signature",
              "success"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean",
                "const": false
              },
              "symbol": {
                "type": "string",
                "maxLength": 20
              },
              "code": {
                "type": "string",
                "maxLength": 80
              },
              "message": {
                "type": "string",
                "maxLength": 512
              }
            },
            "required": [
              "success",
              "symbol",
              "code",
              "message"
            ],
            "additionalProperties": false
          }
        ]
      },
      "maxItems": 100
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_index_assets(limit, offset, band, status)

Read one bounded page from /api/index/v1/verity/catalog. Discover crypto symbols and their current coverage status and measured cadence. Catalog rows, prices and metadata are unsigned: use get_index_price or get_index_batch for signed receipts. Availability changes; total is a catalog count, not a count of fresh prices. No automatic pagination.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Rows per page, 1 to 100; 50 when omitted. A plan may return fewer: use count and offset."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000,
      "default": 0
    },
    "band": {
      "type": "string",
      "enum": [
        "real-time",
        "five-second",
        "ten-second",
        "slow",
        "unavailable"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "consensus",
        "blended",
        "indicative",
        "insufficient-coverage",
        "venue-disagreement",
        "unconvertible-quote",
        "stale",
        "kernel-rejected"
      ]
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "engine": {
      "type": "string",
      "maxLength": 64
    },
    "total": {
      "type": "integer",
      "minimum": 0
    },
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "bands": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "real-time",
          "five-second",
          "ten-second",
          "slow",
          "unavailable"
        ]
      },
      "maxItems": 5
    },
    "note": {
      "type": "string",
      "maxLength": 2048
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "maxLength": 128
          },
          "status": {
            "type": "string",
            "enum": [
              "consensus",
              "blended",
              "indicative",
              "insufficient-coverage",
              "venue-disagreement",
              "unconvertible-quote",
              "stale",
              "kernel-rejected"
            ]
          },
          "price": {
            "anyOf": [
              {
                "type": "number",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ]
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "null"
              }
            ]
          },
          "venues": {
            "$ref": "#/properties/total"
          },
          "freshVenues": {
            "$ref": "#/properties/total"
          },
          "quotes": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "maxItems": 100
          },
          "cadence": {
            "type": "object",
            "properties": {
              "band": {
                "$ref": "#/properties/bands/items"
              },
              "calculatedAgeMs": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "newestSourceAgeMs": {
                "anyOf": [
                  {
                    "$ref": "#/properties/rows/items/properties/cadence/properties/calculatedAgeMs/anyOf/0"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "oldestSourceAgeMs": {
                "anyOf": [
                  {
                    "$ref": "#/properties/rows/items/properties/cadence/properties/calculatedAgeMs/anyOf/0"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "p50UpdateMs": {
                "anyOf": [
                  {
                    "$ref": "#/properties/rows/items/properties/cadence/properties/calculatedAgeMs/anyOf/0"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "p95UpdateMs": {
                "anyOf": [
                  {
                    "$ref": "#/properties/rows/items/properties/cadence/properties/calculatedAgeMs/anyOf/0"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "updatesLast120s": {
                "$ref": "#/properties/total"
              }
            },
            "required": [
              "band",
              "calculatedAgeMs",
              "newestSourceAgeMs",
              "oldestSourceAgeMs",
              "p50UpdateMs",
              "p95UpdateMs"
            ],
            "additionalProperties": false
          },
          "ambiguousTicker": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "required": [
          "symbol",
          "status",
          "price",
          "at",
          "venues",
          "freshVenues",
          "quotes",
          "cadence",
          "ambiguousTicker"
        ],
        "additionalProperties": false
      },
      "maxItems": 100
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_recorded_print(symbol, at)

Get the recorded signed index print nearest a requested time from /api/index/v1/print. Accepts ISO-8601 or epoch milliseconds. Check deltaMs: it is the distance between your requested time and the sampled print. Sampling and retention are bounded; a recorded print need not equal a separate live read. qualityRecorded says whether its quality fields were stored when it was recorded (prints from 1 Oct 2026). Preserve priceText, kid and the v2 block when present for verify_print. deltaMs is not signed. Formerly named get_settlement_print; calls under that name still work.

Input Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9]+$",
      "description": "Crypto ticker symbol, e.g. BTC, ETH, SOL"
    },
    "at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
    }
  },
  "required": [
    "symbol",
    "at"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$"
    },
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "priceText": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "at": {
      "type": "string",
      "maxLength": 40
    },
    "grade": {
      "type": "string",
      "enum": [
        "consensus",
        "blended",
        "indicative",
        "composite",
        "single-source"
      ]
    },
    "signature": {
      "type": "string",
      "minLength": 88,
      "maxLength": 88,
      "pattern": "^[A-Za-z0-9+/]{86}==$"
    },
    "kid": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,64}$"
    },
    "sig": {
      "type": "string",
      "const": "pulse-index-v1"
    },
    "success": {
      "type": "boolean",
      "const": true
    },
    "engine": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "tier": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20
        },
        {
          "type": "null"
        }
      ]
    },
    "confidence": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "dispersionBps": {
      "anyOf": [
        {
          "$ref": "#/properties/confidence/anyOf/0"
        },
        {
          "type": "null"
        }
      ]
    },
    "interval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "lower": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "upper": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "lower",
            "upper"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cadence": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "band": {
              "type": "string",
              "enum": [
                "real-time",
                "five-second",
                "ten-second",
                "slow",
                "unavailable"
              ]
            },
            "calculatedAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "newestSourceAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "oldestSourceAgeMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "p50UpdateMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "p95UpdateMs": {
              "anyOf": [
                {
                  "$ref": "#/properties/confidence/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updatesLast120s": {
              "$ref": "#/properties/sources/anyOf/0"
            }
          },
          "required": [
            "band"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "v2": {
      "type": "object",
      "properties": {
        "sig": {
          "type": "string",
          "const": "pulse-index-v2"
        },
        "canonical": {
          "type": "string",
          "minLength": 1,
          "maxLength": 8192
        },
        "signature": {
          "$ref": "#/properties/signature"
        },
        "kid": {
          "$ref": "#/properties/kid"
        }
      },
      "required": [
        "sig",
        "canonical",
        "signature",
        "kid"
      ],
      "additionalProperties": false
    },
    "sample": {
      "type": "boolean",
      "const": true
    },
    "note": {
      "type": "string",
      "maxLength": 2048
    },
    "getKey": {
      "type": "string",
      "maxLength": 256
    },
    "qualityRecorded": {
      "type": "boolean"
    },
    "kind": {
      "type": "string",
      "const": "daily-close"
    },
    "assetId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 160
        },
        {
          "type": "null"
        }
      ]
    },
    "closeDay": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "deltaMs": {
      "type": "number",
      "minimum": 0
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢verify_print(symbol, price, priceText, at, grade, ...)

Verify a signed print locally with ECDSA P-256/SHA-256. Canonical bytes are pulse-index-v1\n<symbol>\n<priceText or String(price)>\n<at>\n<grade>. The public key ring is read from /api/index/v1/pubkey, cached for five minutes and refreshed at most once per 30 seconds on a failed check. A supplied kid selects only that exact key; old prints without kid are tried against the bounded published ring. valid=true authenticates only the canonical price fields, not kid, sig, quality, cadence, timestamps outside at, or other metadata. When the print carries a v2 block (pulse-index-v2), it is verified too: v2.valid=true means the signature over v2.canonical is valid AND every signed line (sources, tier, confidence, dispersionBps, interval, cadence, engine, price and the rest) matches the supplied fields; v2.signedFields are the signed values and v2.mismatches names any field that differs. recordValid=true and verificationScope=full-record require BOTH price and complete v2 record verification. metadataSigned equals recordValid. Require recordValid before trusting quality fields. A v1-only print has scope price-only, never verified metadata. Neither signature proves freshness or settlement suitability; indicative data must not be used for settlement. An invalid signature can mean an altered print or a key no longer published; it does not by itself prove tampering.

Input Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9]+$",
      "description": "Crypto ticker symbol, e.g. BTC, ETH, SOL"
    },
    "price": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "pattern": "^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?$"
        },
        {
          "type": "number"
        }
      ]
    },
    "priceText": {
      "$ref": "#/properties/price/anyOf/0",
      "description": "Exact signed price text, when provided by the API; preserve unchanged"
    },
    "at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      "description": "Timestamp from the print, unchanged"
    },
    "grade": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
    },
    "signature": {
      "type": "string",
      "minLength": 88,
      "maxLength": 88,
      "pattern": "^[A-Za-z0-9+/]{86}==$",
      "description": "ECDSA P-256 signature in base64"
    },
    "kid": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,64}$",
      "description": "Signing key identifier, when provided by the API"
    },
    "sig": {
      "type": "string",
      "const": "pulse-index-v1"
    },
    "kind": {
      "type": "string",
      "const": "daily-close"
    },
    "assetId": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 160,
          "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "closeDay": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "engine": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 64,
          "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "tier": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 20,
          "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "confidence": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "dispersionBps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "interval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "lower": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "upper": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "lower",
            "upper"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cadence": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "band": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 40,
                  "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$"
                },
                {
                  "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"
                }
              ]
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "v2": {
      "type": "object",
      "properties": {
        "sig": {
          "type": "string",
          "const": "pulse-index-v2"
        },
        "canonical": {
          "type": "string",
          "minLength": 1,
          "maxLength": 8192,
          "description": "The exact signed string from the print, unchanged"
        },
        "signature": {
          "type": "string",
          "minLength": 88,
          "maxLength": 88,
          "pattern": "^[A-Za-z0-9+/]{86}==$"
        },
        "kid": {
          "$ref": "#/properties/kid"
        }
      },
      "required": [
        "sig",
        "canonical",
        "signature",
        "kid"
      ],
      "additionalProperties": false,
      "description": "The v2 block from the print, unchanged: it signs the whole record, quality fields included"
    }
  },
  "required": [
    "symbol",
    "price",
    "at",
    "grade",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean",
      "description": "Legacy price-only signature check. Use recordValid for quality metadata."
    },
    "recordValid": {
      "type": "boolean",
      "description": "Both signatures and every required v2 field verified. Does not prove freshness or settlement suitability."
    },
    "verificationScope": {
      "type": "string",
      "enum": [
        "full-record",
        "price-only",
        "invalid"
      ]
    },
    "metadataSigned": {
      "type": "boolean"
    },
    "verifiedWithKid": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[A-Za-z0-9._:-]{1,64}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "checked": {
      "type": "string",
      "maxLength": 512
    },
    "keySource": {
      "type": "string",
      "maxLength": 256
    },
    "v2": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "valid": {
              "type": "boolean"
            },
            "signatureValid": {
              "type": "boolean"
            },
            "fieldsMatch": {
              "type": "boolean"
            },
            "mismatches": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 80
              },
              "maxItems": 18
            },
            "signedFields": {
              "anyOf": [
                {
                  "type": "object",
                  "additionalProperties": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                {
                  "type": "null"
                }
              ]
            },
            "verifiedWithKid": {
              "anyOf": [
                {
                  "$ref": "#/properties/verifiedWithKid/anyOf/0"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "valid",
            "signatureValid",
            "fieldsMatch",
            "mismatches",
            "signedFields",
            "verifiedWithKid"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_account_status

Read this connection's Pulse Verity plan and usage from /api/index/v1/account: plan, used (calls counted this UTC month), limit, remaining, resetAt, perMinute, batchMaxSymbols, capacityAction and upgradeUrl (the plans page). The monthly allowance is account-wide: every key and connected app on the account shares it. perMinute applies to each key. This call does not count toward the allowance.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "plan": {
      "type": "string",
      "maxLength": 40,
      "description": "The plan name customers see, e.g. Developer"
    },
    "used": {
      "type": "integer",
      "minimum": 0,
      "description": "Calls counted this UTC month, account-wide"
    },
    "limit": {
      "type": "integer",
      "minimum": 0,
      "description": "The monthly allowance"
    },
    "remaining": {
      "type": "integer",
      "minimum": 0
    },
    "resetAt": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
    },
    "perMinute": {
      "$ref": "#/properties/remaining"
    },
    "batchMaxSymbols": {
      "$ref": "#/properties/remaining"
    },
    "capacityAction": {
      "type": "string",
      "enum": [
        "review_plans",
        "contact_support"
      ]
    },
    "upgradeUrl": {
      "type": "string",
      "const": "https://thepulse.markets/developers#/portal/pricing"
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_index_history(symbol, dataset, interval, from, to, ...)

Read price history for one crypto symbol from /api/index/v1/history: candles (open, high, low, close) at 1m, 5m, 1h or 1d, with period metrics and pagination. dataset=verified (default) is built from prints Pulse signed live; reconstructed is rebuilt history at 1h or 1d and was not signed at the historical time. The account's plan sets whether history is included and how far back a request reaches: rangeClamped says the window was shortened, and historyLimit names the plan when the plan did it. Each call counts as one API call. For the next page pass pagination.nextCursor as cursor with the same symbol, dataset and interval. Signed rows (verifiedObservations) are returned only with includeSignedRows=true; each verifies with verify_print. Candles and metrics are not signed. An empty page means no recorded history in that window, never a zero price.

Input Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9]+$",
      "description": "Crypto ticker symbol, e.g. BTC"
    },
    "dataset": {
      "type": "string",
      "enum": [
        "verified",
        "reconstructed"
      ],
      "description": "verified (default): built from prints Pulse signed live. reconstructed: rebuilt hourly and daily history, not signed at the historical time; interval 1h or 1d only."
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "1h",
        "1d"
      ],
      "description": "Candle width; 1h when omitted."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[^\\x00-\\x1f\\x7f\\u0085\\u2028\\u2029]+$",
      "description": "Start, ISO-8601 or epoch milliseconds (13 digits); 30 days before `to` when omitted. The plan may shorten it."
    },
    "to": {
      "$ref": "#/properties/from",
      "description": "End, ISO-8601 or epoch milliseconds (13 digits); now when omitted."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "description": "Underlying points per page, 1 to 1000; 500 when omitted."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "pagination.nextCursor from the previous page, unchanged."
    },
    "assetId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[A-Za-z0-9:._-]+$",
      "description": "Canonical asset id, when a ticker names more than one asset."
    },
    "includeSignedRows": {
      "type": "boolean",
      "description": "Include verifiedObservations, each a signed row verify_print checks (verified dataset only). Off by default to keep pages small."
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "symbol": {
      "type": "string",
      "maxLength": 40
    },
    "dataset": {
      "type": "string",
      "maxLength": 80
    },
    "interval": {
      "type": "string",
      "maxLength": 8
    },
    "from": {
      "type": "string",
      "maxLength": 40
    },
    "to": {
      "type": "string",
      "maxLength": 40
    },
    "rangeClamped": {
      "type": "boolean"
    },
    "pagination": {
      "type": "object",
      "properties": {
        "nextCursor": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ]
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    },
    "candles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "at": {
            "type": "string",
            "maxLength": 40
          },
          "open": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "low": {
            "type": "number"
          },
          "close": {
            "type": "number"
          }
        },
        "required": [
          "at",
          "open",
          "high",
          "low",
          "close"
        ],
        "additionalProperties": true
      }
    },
    "signedRowsOmitted": {
      "type": "integer",
      "minimum": 0
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_upgrade_options(reason, dataset, feature)

List the Pulse Verity plans with their limits and prices, and the prepaid call packs and extra stream connections while each is on sale, each with a portal link. Read-only; does not count toward the allowance. The current plan is marked when the account is on that plan's terms (currentPlan shows the account's own limits either way), and when a recent plan refusal is known (or reason is given) the smallest plan, add-on or pack that fixes it is recommended. A link opens the portal, which shows the item, price and terms; the account holder completes payment on Stripe. Nothing is bought by this tool or by opening a link.

Input Schema

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string",
      "enum": [
        "MONTHLY_LIMIT",
        "RATE_LIMITED",
        "TOO_MANY_SYMBOLS",
        "BATCH_TOO_LARGE",
        "RESEARCH_NOT_INCLUDED",
        "SYMBOL_LIMIT",
        "SOURCE_HEALTH_NOT_INCLUDED",
        "WEBHOOKS_NOT_INCLUDED",
        "STREAM_NOT_INCLUDED",
        "CONNECTION_LIMIT",
        "KEY_LIMIT",
        "HISTORY_WINDOW"
      ],
      "description": "A refusal code this connection received, e.g. TOO_MANY_SYMBOLS or MONTHLY_LIMIT, when it is not the most recent one."
    },
    "dataset": {
      "type": "string",
      "enum": [
        "verified",
        "reconstructed"
      ],
      "description": "For HISTORY_WINDOW: the history dataset that was shortened; verified (the get_index_history default) when omitted."
    },
    "feature": {
      "type": "string",
      "enum": [
        "history",
        "research-tools"
      ],
      "description": "For RESEARCH_NOT_INCLUDED: history when get_index_history was refused, research-tools for compare or metadata; when omitted, the plan that includes both."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "pricingVersion": {
      "type": "string",
      "enum": [
        "2026-10",
        "v1"
      ]
    },
    "currency": {
      "type": "string",
      "const": "usd"
    },
    "checkout": {
      "type": "object",
      "properties": {
        "month": {
          "type": "boolean"
        },
        "year": {
          "type": "boolean"
        }
      },
      "required": [
        "month",
        "year"
      ],
      "additionalProperties": false
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 20
          },
          "name": {
            "type": "string",
            "maxLength": 40
          }
        },
        "required": [
          "id",
          "name"
        ],
        "additionalProperties": true
      }
    },
    "currentPlan": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "maxLength": 40
            }
          },
          "required": [
            "name"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "recommendation": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "maxLength": 40
            }
          },
          "required": [
            "reason"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡submit_verity_feedback(category, surface, symbol, requestId, observedAt, ...)

Write one structured bug, missing capability, or data quality report for private human triage. Only submit when the user requests reporting; do not include keys, passwords, transcripts or attachments. Returns a durable receipt and duplicate flag, not a promise of a fix. No code or production behavior changes automatically. Status is available with the same account at GET /api/index/v1/feedback/<id>.

Input Schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "bug",
        "missing_capability",
        "data_quality"
      ]
    },
    "surface": {
      "type": "string",
      "enum": [
        "get_index_price",
        "get_index_batch",
        "list_index_assets",
        "get_recorded_print",
        "get_settlement_print",
        "verify_print",
        "/api/index/v1/price",
        "/api/index/v1/batch",
        "/api/index/v1/print",
        "/api/index/v1/verity/catalog",
        "/api/index/v1/pubkey",
        "/api/index/v1/sample",
        "/api/index/v1/history",
        "/api/index/v1/metadata",
        "/api/index/v1/research/compare",
        "/api/index/v1/source-health",
        "/api/index/v1/verity/price",
        "/api/index/v1/verity/batch",
        "/api/index/mcp"
      ]
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 48,
      "pattern": "^[A-Za-z0-9._:/-]+$"
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 96,
      "pattern": "^[A-Za-z0-9._:-]+$"
    },
    "observedAt": {
      "type": "string",
      "format": "date-time"
    },
    "expected": {
      "type": "string",
      "minLength": 3,
      "maxLength": 1200
    },
    "actual": {
      "type": "string",
      "minLength": 3,
      "maxLength": 1200
    },
    "reproduction": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 500
      },
      "minItems": 1,
      "maxItems": 6
    }
  },
  "required": [
    "category",
    "surface",
    "expected",
    "actual",
    "reproduction"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "feedback": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^vf_[a-f0-9]{32}$"
        },
        "status": {
          "type": "string",
          "enum": [
            "received",
            "triaged",
            "in_progress",
            "resolved",
            "closed"
          ]
        },
        "receivedAt": {
          "type": "string",
          "format": "date-time"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "id",
        "status",
        "receivedAt",
        "updatedAt",
        "expiresAt"
      ],
      "additionalProperties": false
    },
    "duplicate": {
      "type": "boolean"
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "Identifier for this MCP call; not a signed price field."
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
        },
        "nextAction": {
          "type": "string",
          "enum": [
            "wait",
            "review_access",
            "check_limits",
            "reconnect",
            "check_input",
            "choose_another_symbol",
            "report_issue"
          ]
        },
        "retryable": {
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        },
        "accountUrl": {
          "type": "string",
          "const": "https://thepulse.markets/developers/access"
        },
        "upgradeUrl": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^https:\\/\\/thepulse\\.markets\\/developers(?:\\?ref=[a-z0-9][a-z0-9-]{0,39})?#\\/(?:portal\\/pricing|buy\\/plan\\/(?:basic|builder|commercial)\\/(?:month|year)|buy\\/pack\\/(?:10|50|200)|buy\\/stream-addon)$"
        },
        "resetAt": {
          "type": "string",
          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-01T00:00:00\\.000Z$"
        },
        "capacityAction": {
          "type": "string",
          "enum": [
            "review_plans",
            "contact_support"
          ]
        }
      },
      "required": [
        "code",
        "nextAction"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools
auth requiredversion not recorded—