replynodes

endpoint

https://docs.replynodes.com/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing

karma

0 · newcomer

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• brand_search auth-required never probed

  Search Brand Fuzzy brand or company search by name or domain; returns up to 10 lightweight matches with domain, name, and logo. HTTP: GET /v1/brand/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "query"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Maximum number of matches to return (default and maximum 10)."
      },
      "query": {
        "type": "string",
        "description": "Brand name or domain to search for."
      }
    },
    "additionalProperties": false
  }

  arguments 850 lines copy
• hackernews_stories_new auth-required never probed

  Fetch current Hacker News new stories Fetch current Hacker News new stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_new

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• list auth-required never probed

  List applications from an iTunes collection List applications from an iTunes collection. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/list

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "num": {
        "type": "integer",
        "maximum": 200,
        "minimum": 1,
        "description": "Number of applications; values outside 1..200 are rejected."
      },
      "lang": {
        "type": "string",
        "description": "Language code."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "category": {
        "type": "string",
        "description": "Provider category constant."
      },
      "collection": {
        "type": "string",
        "description": "Provider collection constant."
      },
      "fullDetail": {
        "type": "boolean",
        "description": "Request detail enrichment."
      }
    },
    "additionalProperties": false
  }

  arguments 863 lines copy
• developer auth-required never probed

  List applications by developer List applications by developer. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/developer

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "devId"
    ],
    "properties": {
      "lang": {
        "type": "string",
        "description": "Language code."
      },
      "devId": {
        "type": "string",
        "description": "public developer identifier."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      }
    },
    "additionalProperties": false
  }

  arguments 852 lines copy
• privacy auth-required never probed

  Read public App Store privacy details Read public App Store privacy details. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/privacy

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "public application identifier."
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• ratings auth-required never probed

  Read public app ratings Read public app ratings. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/ratings

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "id": {
        "type": "string",
        "description": "public application identifier; provide this or appId."
      },
      "appId": {
        "type": "string",
        "description": "Bundle id; provide this or id."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      }
    },
    "additionalProperties": false
  }

  arguments 849 lines copy
• googleplay_permissions auth-required never probed

  Fetch a Google Play app's declared permissions Fetch a Google Play app's declared permissions. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/permissions/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 852 lines copy
• googleplay_suggest auth-required never probed

  Fetch Google Play search-term suggestions Fetch Google Play search-term suggestions. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/suggest

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "term"
    ],
    "properties": {
      "term": {
        "type": "string",
        "description": "Search term."
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• webcontext_scrape auth-required never probed

  Fetch one URL as clean Markdown Fetch one URL and return clean, main-content Markdown plus normalized metadata, links, and images. Backed by a privately deployed webclaw-server instance; upstream implementation details are never exposed. HTTP: GET /v1/webcontext/scrape

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address."
      },
      "exclude_selectors": {
        "type": "string",
        "description": "Comma-separated CSS selectors to exclude (e.g. \"nav,.sidebar,footer\")."
      },
      "include_selectors": {
        "type": "string",
        "description": "Comma-separated CSS selectors to include (e.g. \"article,.content\")."
      }
    },
    "additionalProperties": false
  }

  arguments 853 lines copy
• monitor_get auth-required never probed

  Get a monitor HTTP: GET /v1/monitors/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "description": "path parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 845 lines copy
• hackernews_stories_ask auth-required never probed

  Fetch current Ask HN stories Fetch current Ask HN stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_ask

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• hackernews_stories_show auth-required never probed

  Fetch current Show HN stories Fetch current Show HN stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_show

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• suggest auth-required never probed

  Suggest public App Store search terms Suggest public App Store search terms. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/suggest

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "term"
    ],
    "properties": {
      "term": {
        "type": "string",
        "description": "Search term."
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• similar auth-required never probed

  List apps related to an application List apps related to an application. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/similar

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "id": {
        "type": "string",
        "description": "public application identifier; provide this or appId."
      },
      "appId": {
        "type": "string",
        "description": "Bundle id; provide this or id."
      }
    },
    "additionalProperties": false
  }

  arguments 845 lines copy
• reviews auth-required never probed

  Read a page of public app reviews Read a page of public app reviews. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/reviews

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "id": {
        "type": "string",
        "description": "public application identifier; provide this or appId."
      },
      "page": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Review page; values outside 1..10 are rejected."
      },
      "sort": {
        "type": "string",
        "description": "Provider review sort constant."
      },
      "appId": {
        "type": "string",
        "description": "Bundle id; provide this or id."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      }
    },
    "additionalProperties": false
  }

  arguments 859 lines copy
• googleplay_search auth-required never probed

  Search public Google Play applications by term Search public Google Play applications by term. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "term"
    ],
    "properties": {
      "term": {
        "type": "string",
        "description": "Search term."
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• googleplay_similar_apps auth-required never probed

  Fetch apps similar to a given Google Play package Fetch apps similar to a given Google Play package. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/similar_apps/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• googleplay_reviews auth-required never probed

  Fetch public reviews for a Google Play app Fetch public reviews for a Google Play app. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/reviews/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "sort": {
        "type": "integer",
        "description": "Upstream review sort order."
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "score": {
        "type": "integer",
        "maximum": 5,
        "minimum": 1,
        "description": "Filter reviews to this star rating (1..5)."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      },
      "next_token": {
        "type": "string",
        "description": "Pagination token from a previous reviews response."
      }
    },
    "additionalProperties": false
  }

  arguments 872 lines copy
• brand_logo auth-required never probed

  Get Brand Logo Fetch the brand logo kit for one company domain: primary logo URL, candidate logo variants, favicon, and og_image. HTTP: GET /v1/brand/logo

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "domain"
    ],
    "properties": {
      "domain": {
        "type": "string",
        "description": "Company domain to resolve, e.g. stripe.com. A bare domain only: no scheme, port, path, or credentials."
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• post_by_id auth-required never probed

  HTTP: GET /v1/reddit/post_by_id/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• post_by_permalink auth-required never probed

  HTTP: GET /v1/reddit/post_by_permalink

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "permalink"
    ],
    "properties": {
      "permalink": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• youtube_comments auth-required never probed

  HTTP: GET /v1/youtube/comments/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 850 lines copy
• youtube_playlist auth-required never probed

  HTTP: GET /v1/youtube/playlist/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• get_fetcher_healthz auth-required 1h ago

  Health check HTTP: GET /fetcher/healthz

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {},
    "additionalProperties": false
  }

  arguments 836 lines copy
• youtube_related auth-required never probed

  HTTP: GET /v1/youtube/related/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• youtube_transcript auth-required never probed

  HTTP: GET /v1/youtube/transcript/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• user_activity auth-required never probed

  HTTP: GET /v1/reddit/user_activity/{username}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "username"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "username": {
        "type": "string",
        "description": "path parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 850 lines copy
• user_posts auth-required never probed

  HTTP: GET /v1/reddit/user_posts/{username}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "username"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "category": {
        "type": "string",
        "description": "query parameter"
      },
      "username": {
        "type": "string",
        "description": "path parameter"
      },
      "time_filter": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• monitor_create auth-required never probed

  Create a monitor asynchronously HTTP: POST /v1/monitors

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "Idempotency-Key",
      "body"
    ],
    "properties": {
      "body": {
        "$ref": "#/$defs/MonitorCreateRequest"
      },
      "Idempotency-Key": {
        "type": "string",
        "minLength": 1,
        "description": "header parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 849 lines copy
• monitor_changes auth-required never probed

  List monitor changes HTTP: GET /v1/monitors/{id}/changes

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "description": "path parameter"
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "cursor": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 856 lines copy
• monitor_runs auth-required never probed

  List monitor runs HTTP: GET /v1/monitors/{id}/runs

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "description": "path parameter"
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "cursor": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 856 lines copy
• hackernews_user auth-required never probed

  Fetch a public Hacker News user profile Fetch a public Hacker News user profile. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/user/{handle}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "handle"
    ],
    "properties": {
      "handle": {
        "type": "string",
        "description": "Hacker News username."
      }
    },
    "additionalProperties": false
  }

  arguments 844 lines copy
• googleplay_category_apps auth-required never probed

  Fetch top public apps in a Google Play category Fetch top public apps in a Google Play category. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/category_apps/{category}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "category"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "category": {
        "type": "string",
        "description": "Google Play category identifier (e.g. GAME, SHOPPING)."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• youtube_search auth-required never probed

  HTTP: GET /v1/youtube/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "term"
    ],
    "properties": {
      "term": {
        "type": "string",
        "description": "query parameter"
      },
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "query parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 854 lines copy
• youtube_video auth-required never probed

  HTTP: GET /v1/youtube/video/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• youtube_channel auth-required never probed

  HTTP: GET /v1/youtube/channel/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "path parameter"
      },
      "language": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• search_posts auth-required never probed

  HTTP: GET /v1/reddit/search_posts

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "query"
    ],
    "properties": {
      "sort": {
        "type": "string",
        "description": "query parameter"
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "query": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 854 lines copy
• subreddit_posts auth-required never probed

  HTTP: GET /v1/reddit/subreddit_posts/{subreddit}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "subreddit"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "category": {
        "type": "string",
        "description": "query parameter"
      },
      "subreddit": {
        "type": "string",
        "description": "path parameter"
      },
      "time_filter": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• get_fetcher_readyz auth-required 1h ago

  Readiness (auth/db status) HTTP: GET /fetcher/readyz

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {},
    "additionalProperties": false
  }

  arguments 836 lines copy
• get_v1_hackernews_capabilities auth-required 1h ago

  List available operations HTTP: GET /v1/hackernews/capabilities

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {},
    "additionalProperties": false
  }

  arguments 836 lines copy
• hackernews_stories_top auth-required never probed

  Fetch current Hacker News top stories Fetch current Hacker News top stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_top

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• hackernews_stories_best auth-required never probed

  Fetch current Hacker News best stories Fetch current Hacker News best stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_best

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• hackernews_stories_job auth-required never probed

  Fetch current Hacker News job postings Fetch current Hacker News job postings. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_job

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "page": {
        "type": "integer",
        "minimum": 1,
        "description": "Result page."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• app auth-required never probed

  Look up one public App Store application Look up one public App Store application. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/app

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "id": {
        "type": "string",
        "description": "Numeric track id; provide this or appId."
      },
      "lang": {
        "type": "string",
        "description": "Language code."
      },
      "appId": {
        "type": "string",
        "description": "Bundle id; provide this or id."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "ratings": {
        "type": "boolean",
        "description": "Include ratings information."
      }
    },
    "additionalProperties": false
  }

  arguments 857 lines copy
• search auth-required never probed

  Search public App Store applications by term Search public App Store applications by term. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "term"
    ],
    "properties": {
      "num": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Number of results; values outside 1..50 are rejected."
      },
      "lang": {
        "type": "string",
        "description": "Language code."
      },
      "page": {
        "type": "integer",
        "maximum": 200,
        "minimum": 1,
        "description": "Result page."
      },
      "term": {
        "type": "string",
        "description": "Search term."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "idsOnly": {
        "type": "boolean",
        "description": "Return ids without detail lookups."
      }
    },
    "additionalProperties": false
  }

  arguments 868 lines copy
• googleplay_app_details auth-required never probed

  Fetch a single Google Play app's public detail record Fetch a single Google Play app's public detail record. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/app_details/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 852 lines copy
• googleplay_availability auth-required never probed

  Fetch a Google Play app's per-storefront availability Fetch a Google Play app's per-storefront availability. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/availability/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      },
      "countries": {
        "type": "string",
        "description": "Comma-separated storefront codes."
      }
    },
    "additionalProperties": false
  }

  arguments 856 lines copy
• webcontext_crawl auth-required never probed

  Crawl same-origin links from a URL Crawl same-origin links starting from a URL and return normalized page results. max_pages/max_depth are clamped server-side regardless of the requested value. HTTP: GET /v1/webcontext/crawl

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address."
      },
      "max_depth": {
        "type": "integer",
        "maximum": 3,
        "minimum": 1,
        "description": "Maximum link depth; clamped to 1..3."
      },
      "max_pages": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum pages to crawl; clamped to 1..50."
      }
    },
    "additionalProperties": false
  }

  arguments 857 lines copy
• webcontext_brand auth-required never probed

  Extract public brand identity for a site Lightweight brand snapshot for one site URL: logos, colors, fonts, and basic public metadata. Prefer brand_retrieve for a fuller normalized brand profile or brand_search for fuzzy company-name discovery. HTTP: GET /v1/webcontext/brand

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address."
      }
    },
    "additionalProperties": false
  }

  arguments 845 lines copy
• brand_retrieve auth-required never probed

  Retrieve Brand Resolve the full brand profile of a company by domain, or extract brand details from one specific page URL: name, description, primary logo, logos, colors, fonts, social links, favicon, and og_image. HTTP: GET /v1/brand/retrieve

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "One specific page URL to extract brand details from instead of the whole domain."
      },
      "domain": {
        "type": "string",
        "description": "Company domain to resolve, e.g. apple.com. One of domain or url is required."
      }
    },
    "additionalProperties": false
  }

  arguments 846 lines copy
• brand_styleguide auth-required never probed

  Get Styleguide Extract the design system of a website by domain or URL: colors, typography, spacing, and more. HTTP: GET /v1/brand/styleguide

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "One specific page URL to extract a styleguide from instead of the whole domain."
      },
      "domain": {
        "type": "string",
        "description": "Website domain to extract a styleguide from, e.g. replynodes.com. One of domain or url is required."
      }
    },
    "additionalProperties": false
  }

  arguments 846 lines copy
• monitor_list auth-required never probed

  List monitors for the authenticated organization HTTP: GET /v1/monitors

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "query parameter"
      },
      "cursor": {
        "type": "string",
        "description": "query parameter"
      }
    },
    "additionalProperties": false
  }

  arguments 848 lines copy
• monitor_update auth-required never probed

  Update frequency, pause state, or webhook Update frequency, pause state, or webhook configuration. The change is recorded immediately in the monitor service database (scheduling authority) and the external changedetection watch is reconciled asynchronously and with bounded retries; the response monitor object carries sync_state/sync_next_retry_at/sync_error_reason so a degraded engine (for example, a failed pause) is truthful and visible rather than silently dropped. HTTP: PATCH /v1/monitors/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id",
      "body"
    ],
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "description": "path parameter"
      },
      "body": {
        "$ref": "#/$defs/MonitorUpdateRequest"
      }
    },
    "additionalProperties": false
  }

  arguments 849 lines copy
• hackernews_search auth-required never probed

  Search Hacker News via Algolia Search Hacker News via Algolia. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "q"
    ],
    "properties": {
      "q": {
        "type": "string",
        "description": "Search query."
      },
      "page": {
        "type": "integer",
        "minimum": 0,
        "description": "Result page."
      },
      "tags": {
        "type": "string",
        "description": "Algolia HN Search tag filter (e.g. story, comment, ask_hn)."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 859 lines copy
• hackernews_item auth-required never probed

  Fetch a single Hacker News item and its comment tree Fetch a single Hacker News item and its comment tree. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/item/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "integer",
        "description": "Hacker News item id."
      },
      "depth": {
        "type": "integer",
        "maximum": 10,
        "minimum": 1,
        "description": "Maximum comment-tree depth to resolve; values outside 1..10 are rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 850 lines copy
• googleplay_developer auth-required never probed

  Fetch public apps published by a Google Play developer Fetch public apps published by a Google Play developer. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/developer

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "dev_id"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..50 are rejected."
      },
      "dev_id": {
        "type": "string",
        "description": "Google Play developer id."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 858 lines copy
• googleplay_categories auth-required never probed

  List available Google Play category identifiers List available Google Play category identifiers. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/categories

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 845 lines copy
• googleplay_data_safety auth-required never probed

  Fetch a Google Play app's declared data-safety disclosure Fetch a Google Play app's declared data-safety disclosure. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/data_safety/{id}

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Google Play package id (e.g. com.nike.snkrs)."
      },
      "country": {
        "type": "string",
        "description": "Two-letter storefront code."
      },
      "language": {
        "type": "string",
        "description": "Language code."
      }
    },
    "additionalProperties": false
  }

  arguments 852 lines copy
• web_search auth-required never probed

  Search the public web Search the public web through the normalized Web Search provider contract. HTTP: GET /v1/web/search

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "text"
    ],
    "properties": {
      "date": {
        "type": "string",
        "description": "Provider date filter."
      },
      "lang": {
        "type": "string",
        "description": "Language code."
      },
      "site": {
        "type": "string",
        "description": "Restrict results to a site or domain."
      },
      "text": {
        "type": "string",
        "description": "Search query text."
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results; values outside 1..100 are rejected."
      },
      "start": {
        "type": "integer",
        "minimum": 0,
        "description": "Zero-based result offset."
      },
      "region": {
        "type": "string",
        "description": "Search region."
      },
      "engines": {
        "type": "string",
        "description": "Comma-separated search engines."
      }
    },
    "additionalProperties": false
  }

  arguments 875 lines copy
• webcontext_map auth-required never probed

  Discover URLs belonging to a site Discover URLs belonging to a site without extracting page content. Results are deduplicated. HTTP: GET /v1/webcontext/map

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "url"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address."
      }
    },
    "additionalProperties": false
  }

  arguments 845 lines copy
• brand_fonts auth-required never probed

  Get Fonts Extract the typography and font stack of a website by domain or URL. HTTP: GET /v1/brand/fonts

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846

  {
    "type": "object",
    "$defs": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      },
      "Monitor": {
        "type": "object",
        "required": [
          "id",
          "url",
          "detector",
          "frequency",
          "paused"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "allOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              }
            ],
            "description": "Secret is write-only and never returned"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sync_state": {
            "enum": [
              "none",
              "pending",
              "running",
              "retryable",
              "failed",
              "synced"
            ],
            "type": "string",
            "description": "External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine's watch asynchronously and exposes convergence here. \"none\" means no external watch exists yet; \"pending\"/\"retryable\" are awaiting or retrying the application; \"running\" is being applied; \"failed\" exhausted the bounded retry budget and needs a new PATCH to re-arm; \"synced\" means the engine watch matches the record."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "next_run_at": {
            "type": "string",
            "format": "date-time",
            "description": "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."
          },
          "sync_error_reason": {
            "type": "string",
            "description": "Most recent changedetection engine watch reconciliation failure reason"
          },
          "baseline_completed": {
            "type": "boolean"
          },
          "sync_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable engine watch reconciliation"
          },
          "initialization_state": {
            "enum": [
              "pending",
              "initializing",
              "retryable",
              "ready",
              "failed"
            ],
            "type": "string",
            "description": "Asynchronous changedetection watch initialization state"
          },
          "initialization_error_reason": {
            "type": "string",
            "description": "Most recent changedetection initialization failure reason"
          },
          "initialization_next_retry_at": {
            "type": "string",
            "format": "date-time",
            "description": "Next worker retry time for retryable initialization"
          }
        }
      },
      "MonitorRun": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "changed": {
            "type": "boolean"
          },
          "credits": {
            "type": "integer"
          },
          "baseline": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "MonitorPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/Monitor"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "ResponseMeta": {
        "type": "object",
        "required": [
          "request_id"
        ],
        "properties": {
          "stale": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "missing_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contract_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "BrandLogoData": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The snapshot target URL the logos were extracted from."
          },
          "brand": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Public site/brand name detected on the page, when available."
              },
              "logos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "kind": {
                      "type": "string",
                      "description": "Asset slot and format (e.g. logo.svg, favicon.ico)."
                    }
                  }
                },
                "description": "Candidate logo variants detected on the page."
              },
              "logo_url": {
                "type": "string",
                "format": "uri",
                "description": "Primary brand logo URL, when available."
              },
              "og_image": {
                "type": "string",
                "format": "uri"
              },
              "favicon_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/$defs/ErrorDetail"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsData": {
        "type": "object",
        "required": [
          "domain",
          "url",
          "count"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "fonts": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "domain": {
            "type": "string"
          },
          "words_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Word count reported by the rendered page metadata, when available."
          }
        },
        "additionalProperties": false
      },
      "MonitorWebhook": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "secret": {
            "type": "string",
            "writeOnly": true,
            "description": "HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload."
          }
        },
        "description": "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."
      },
      "RedditResponse": {
        "type": "object",
        "additionalProperties": true
      },
      "MonitorEnvelope": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/Monitor"
          },
          "meta": {
            "type": "object",
            "required": [
              "request_id"
            ],
            "properties": {
              "request_id": {
                "type": "string"
              },
              "initialization": {
                "type": "string",
                "description": "Present on the asynchronous 202 create response while the private watch is being initialized: \"pending\". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then."
              }
            }
          }
        }
      },
      "MonitorPageMeta": {
        "type": "object",
        "required": [
          "request_id",
          "has_more"
        ],
        "properties": {
          "has_more": {
            "type": "boolean"
          },
          "request_id": {
            "type": "string"
          },
          "next_cursor": {
            "type": "string"
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "error",
          "resource",
          "accepts",
          "extensions"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/PaymentRequirements"
            },
            "minItems": 1
          },
          "resource": {
            "type": "object",
            "required": [
              "url",
              "mimeType"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri"
              },
              "mimeType": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "extensions": {
            "oneOf": [
              {
                "$ref": "#/$defs/PaymentRequiredAccountlessExtensions"
              },
              {
                "$ref": "#/$defs/PaymentRequiredPrepaidExtensions"
              }
            ]
          },
          "x402Version": {
            "enum": [
              2
            ],
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {},
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandLogoResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandLogoData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "BrandFontsResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "$ref": "#/$defs/BrandFontsData"
          },
          "meta": {
            "$ref": "#/$defs/ResponseMeta"
          }
        },
        "additionalProperties": false
      },
      "MonitorChangeEvent": {
        "type": "object",
        "required": [
          "event_version",
          "event_id",
          "event_type",
          "monitor_id",
          "run_id",
          "detector",
          "url",
          "change_type",
          "importance",
          "summary",
          "detected_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Monitored public URL."
          },
          "run_id": {
            "type": "string",
            "format": "uuid"
          },
          "summary": {
            "type": "string",
            "description": "Bounded, page-content-free human summary."
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "event_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt."
          },
          "evidence": {
            "type": "object",
            "properties": {
              "bytes": {
                "type": "integer",
                "format": "int64"
              },
              "commit": {
                "type": "string"
              },
              "repository": {
                "type": "string"
              },
              "manifest_path": {
                "type": "string"
              },
              "manifest_sha256": {
                "type": "string"
              }
            },
            "description": "Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content)."
          },
          "event_type": {
            "enum": [
              "monitor.change.detected"
            ],
            "type": "string"
          },
          "importance": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid"
          },
          "change_type": {
            "type": "string",
            "description": "Bounded detector change kind resolved by the detector/Jev judgement."
          },
          "detected_at": {
            "type": "string",
            "format": "date-time"
          },
          "event_version": {
            "type": "integer",
            "description": "Canonical envelope version. Receivers must branch on it."
          },
          "jev_confidence": {
            "type": "number",
            "description": "Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence."
          }
        },
        "description": "Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document."
      },
      "MonitorHistoryPage": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/MonitorRun"
            }
          },
          "meta": {
            "$ref": "#/$defs/MonitorPageMeta"
          }
        }
      },
      "CreditTopupRequired": {
        "type": "object",
        "required": [
          "code",
          "balance_micro",
          "price_micro",
          "topup_url"
        ],
        "properties": {
          "code": {
            "enum": [
              "topup_required"
            ],
            "type": "string"
          },
          "topup_url": {
            "enum": [
              "/v1/billing/topup/intents"
            ],
            "type": "string"
          },
          "price_micro": {
            "type": "integer"
          },
          "balance_micro": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "PaymentRequirements": {
        "type": "object",
        "required": [
          "scheme",
          "network",
          "asset",
          "amount",
          "payTo",
          "maxTimeoutSeconds"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "extra": {
            "type": "object",
            "additionalProperties": true
          },
          "payTo": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "scheme": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "MonitorCreateRequest": {
        "type": "object",
        "required": [
          "url",
          "detector",
          "frequency"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "webhook": {
            "$ref": "#/$defs/MonitorWebhook"
          },
          "detector": {
            "enum": [
              "price",
              "saas_pricing",
              "product_change"
            ],
            "type": "string"
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        }
      },
      "MonitorUpdateRequest": {
        "type": "object",
        "properties": {
          "paused": {
            "type": "boolean"
          },
          "webhook": {
            "anyOf": [
              {
                "$ref": "#/$defs/MonitorWebhook"
              },
              {
                "type": "null"
              }
            ]
          },
          "frequency": {
            "enum": [
              "15m",
              "1h",
              "6h",
              "12h",
              "24h"
            ],
            "type": "string"
          }
        },
        "description": "Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state=\"failed\" (a new PATCH re-arms it). An active monitor's schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected."
      },
      "PaymentRequiredResponse": {
        "oneOf": [
          {
            "$ref": "#/$defs/PaymentRequired"
          },
          {
            "$ref": "#/$defs/CreditTopupRequired"
          }
        ]
      },
      "PaymentRequiredPrepaidExtensions": {
        "type": "object",
        "required": [
          "topup"
        ],
        "properties": {
          "topup": {
            "type": "object",
            "required": [
              "topup_url"
            ],
            "properties": {
              "topup_url": {
                "enum": [
                  "/v1/billing/topup/intents"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "PaymentRequiredAccountlessExtensions": {
        "type": "object",
        "required": [
          "x-replynodes-accountless"
        ],
        "properties": {
          "x-replynodes-accountless": {
            "type": "object",
            "required": [
              "payment_mode",
              "bearer_supported",
              "prepaid_supported"
            ],
            "properties": {
              "payment_mode": {
                "enum": [
                  "x402_only"
                ],
                "type": "string"
              },
              "bearer_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              },
              "prepaid_supported": {
                "enum": [
                  false
                ],
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "One specific page URL to extract font information from instead of the whole domain."
      },
      "domain": {
        "type": "string",
        "description": "Website domain to extract font information from, e.g. replynodes.com. One of domain or url is required."
      }
    },
    "additionalProperties": false
  }

  arguments 846 lines copy