Monitor a new page
add_sourceStart monitoring a web page for the user. One page per URL: if the account already monitors this URL — under any instructions — no second page is started. The settings this call carries are applied to the page that already exists instead, and the response says which case you got: created is true for a new page, false for one that was already monitored, where updatedSettings lists what this call changed on it. Each check spends one credit per page it reads — the source page, plus each item page it follows.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "add_source"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page URL to monitor. | |
| userPrompt | No | Optional instructions for what changes matter. On a page already monitored this replaces its instructions; pass null to clear them. A changed prompt there re-learns how the page is read: one credit if the re-learn succeeds, skipped at zero balance (the prompt still saves). | |
| monitoringFrequency | No | Minutes between checks, from 30 to 10080; anything outside that range is refused rather than quietly changed. Checks run on a scheduler tick, so the cadence actually in effect can be slower than the one stored — read `effectiveMonitoringFrequency` from get_source or list_sources for it. Defaults to 60. | |
| notificationsEnabled | No | Whether to notify on changes (default false). |