Longwatch MCP server

check_crypto_price

Check a CoinGecko asset price and whether it currently meets a USD threshold or 24-hour move condition. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
coin*	string	CoinGecko id, e.g. bitcoin
above	number
below	number
move_pct_24h	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "CoinGecko id, e.g. bitcoin"
    },
    "above": {
      "type": "number"
    },
    "below": {
      "type": "number"
    },
    "move_pct_24h": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

check_insider_trades

Get recent Form 4 insider transactions for a ticker or CIK, parsed into buyer/seller, shares, value, transaction type, and 10b5-1 status. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number
ticker	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cik": {
      "type": "number"
    },
    "ticker": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

check_now

This-session snapshot only — no watch, no cursor. Use when you will not come back. Required by type: url/rss/x402 need url; price needs coin plus above, below, or move_pct_24h; edgar needs ticker or cik. 8-K items are decoded, Form 4 trades parsed, and x402 probes validate the unpaid 402 challenge without sending payment. If the job spans runs, create_watch instead and persist watch_id + key. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number	edgar: SEC CIK, as an alternative to ticker
url	string	url\|rss\|x402: public URL
body	object
coin	string	price: CoinGecko id, e.g. 'bitcoin'
type*	string	source type
above	number	price: threshold to compare against
below	number	price: threshold to compare against
forms	array	edgar: form filter, e.g. ["8-K","4"]

check_rss_feed

Read the latest items from a public RSS or Atom feed now. Use for a one-session lookup. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string	public RSS or Atom feed URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "public RSS or Atom feed URL"
    }
  },
  "additionalProperties": false
}

check_sec_filings

Get recent SEC filings for a ticker or CIK now, with decoded 8-K items and parsed Form 4 transactions. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number
forms	array
ticker	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cik": {
      "type": "number"
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ticker": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

check_web_page

Fetch a public web page now and return normalized text metadata. Use for a one-session lookup. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string	public http(s) page URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "public http(s) page URL"
    }
  },
  "additionalProperties": false
}

check_x402_endpoint

Send an unpaid request and validate the endpoint's HTTP 402 challenge, accepted networks, scheme, amount, and recipient. The target probe does not attach payment. Costs $0.001 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string
body	object
method	string
expected_scheme	string
expected_network	string
expected_amount_atomic	string \| number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "body": {
      "type": "object",
      "additionalProperties": {}
    },
    "method": {
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE",
        "HEAD"
      ],
      "type": "string"
    },
    "expected_scheme": {
      "type": "string"
    },
    "expected_network": {
      "type": "string"
    },
    "expected_amount_atomic": {
      "type": [
        "string",
        "number"
      ]
    }
  },
  "additionalProperties": false
}

create_watch

Keep watching a source between agent runs and alert when it changes. Persist watch_id and key; later poll_alerts with since=<last cursor> returns only what you missed. Required by type: url/rss/x402 need url; price needs coin plus a threshold; edgar needs ticker or cik. Create includes the baseline and 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number	edgar: SEC CIK, as an alternative to ticker
url	string	url\|rss\|x402: public URL to watch
body	object
coin	string	price: CoinGecko id, e.g. 'bitcoin'
type*	string	watch type
above	number	price: alert when USD price crosses above this
below	number	price: alert when USD price crosses below this
forms	array	edgar: form filter, e.g. ["8-K","4"]

delete_watch

Stop and delete a watch. Free. Free — no payment required.

Argument	Type	Description
key*	string	key returned by create_watch
watch_id*	string	watch_id to delete

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "watch_id",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "key returned by create_watch"
    },
    "watch_id": {
      "type": "string",
      "description": "watch_id to delete"
    }
  },
  "additionalProperties": false
}

poll_alerts

What is new since your last run. Pass since={last seq you saw}; the response carries a new cursor. New paid watches include 7 days of polling. After that window, one $0.005 paid poll renews the next 7 days. Polling keeps the watch alive; beta watches remain free. Free through the watch's included polling window; after that, one $0.005 USDC x402 payment renews 7 days. No API key or account.

Argument	Type	Description
key*	string	key returned by create_watch
since	number	highest alert seq already seen; 0 on first poll
watch_id*	string	watch_id returned by create_watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "watch_id",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "key returned by create_watch"
    },
    "since": {
      "type": "number",
      "description": "highest alert seq already seen; 0 on first poll"
    },
    "watch_id": {
      "type": "string",
      "description": "watch_id returned by create_watch"
    }
  },
  "additionalProperties": false
}

poll_trial

Poll a trial watch created by try_watch. Free. Pass since={last seq you saw}; the response carries a new cursor. Once the trial expires, create a paid watch with create_watch; paid creation includes 7 days of polling and can be renewed. Free — no payment required.

Argument	Type	Description
key*	string	key returned by try_watch
since	number	highest alert seq already seen; 0 on first poll
watch_id*	string	watch_id returned by try_watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "watch_id",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "key returned by try_watch"
    },
    "since": {
      "type": "number",
      "description": "highest alert seq already seen; 0 on first poll"
    },
    "watch_id": {
      "type": "string",
      "description": "watch_id returned by try_watch"
    }
  },
  "additionalProperties": false
}

try_watch

Create a free trial watch — no payment, no wallet, no account. Same watch types as create_watch (url, rss, price, edgar, x402). The trial runs for 24h, one at a time per caller, and cannot use webhooks. Use this first to see what the alerts look like before paying. Free — no payment required.

Argument	Type	Description
cik	number	edgar: SEC CIK, as an alternative to ticker
url	string	url\|rss\|x402: public URL to watch
body	object
coin	string	price: CoinGecko id, e.g. 'bitcoin'
type*	string	watch type
above	number	price: alert when USD price crosses above this
below	number	price: alert when USD price crosses below this
forms	array	edgar: form filter, e.g. ["8-K","4"]
method	string
ticker	string	edgar: stock ticker, e.g. 'NVDA'

watch_crypto_price

Monitor a crypto price between agent runs and alert once when it crosses a threshold, with hysteresis before re-arming. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
coin*	string	CoinGecko id, e.g. bitcoin
above	number
below	number
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
move_pct_24h	number
idempotency_key	string	unique retry key; the same key and input return the original watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "CoinGecko id, e.g. bitcoin"
    },
    "above": {
      "type": "number"
    },
    "below": {
      "type": "number"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "move_pct_24h": {
      "type": "number"
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    }
  },
  "additionalProperties": false
}

watch_insider_trades

Monitor a company between agent runs for new Form 4 insider buys, sells, grants, and tax withholding. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number
ticker	string
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
idempotency_key	string	unique retry key; the same key and input return the original watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cik": {
      "type": "number"
    },
    "ticker": {
      "type": "string"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    }
  },
  "additionalProperties": false
}

watch_rss_feed

Monitor an RSS or Atom feed between agent runs and alert once per new item. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string	public RSS or Atom feed URL
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
idempotency_key	string	unique retry key; the same key and input return the original watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "public RSS or Atom feed URL"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    }
  },
  "additionalProperties": false
}

watch_sec_filings

Monitor a company between agent runs for new SEC filings, decoded 8-K events, and parsed Form 4 trades. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
cik	number
forms	array
ticker	string
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
idempotency_key	string	unique retry key; the same key and input return the original watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cik": {
      "type": "number"
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ticker": {
      "type": "string"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    }
  },
  "additionalProperties": false
}

watch_web_page

Monitor a public web page between agent runs and alert with added and removed text when it changes. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string	public http(s) page URL
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
idempotency_key	string	unique retry key; the same key and input return the original watch

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "public http(s) page URL"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    }
  },
  "additionalProperties": false
}

watch_x402_endpoint

Monitor an x402 endpoint for downtime and changes to its payment challenge, price, network, scheme, or recipient. Target probes do not attach payment. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Argument	Type	Description
url*	string
body	object
method	string
webhook	object	optional HTTPS endpoint for signed push alerts; polling still works
expected_scheme	string
idempotency_key	string	unique retry key; the same key and input return the original watch
expected_network	string
expected_amount_atomic	string \| number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "body": {
      "type": "object",
      "additionalProperties": {}
    },
    "method": {
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE",
        "HEAD"
      ],
      "type": "string"
    },
    "webhook": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "description": "optional HTTPS endpoint for signed push alerts; polling still works",
      "additionalProperties": false
    },
    "expected_scheme": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "unique retry key; the same key and input return the original watch"
    },
    "expected_network": {
      "type": "string"
    },
    "expected_amount_atomic": {
      "type": [
        "string",
        "number"
      ]
    }
  },
  "additionalProperties": false
}

Longwatch

Try it

check_crypto_price

Longwatch

Try it

check_crypto_price

Tools (18)