longwatch-dev MCP API

openapi: 3.2.0
info:
  title: longwatch MCP API
  version: 1.0.1
  description: Experimental checks for public pages, RSS, price thresholds, SEC filings, and x402 challenges.
  contact:
    email: contact@coinop.dev
  x-guidance: For a managed check between runs, call create_watch, persist watch_id, key, and cursor, then call poll_alerts with since=<last cursor>. check_now (GET /check) is a current snapshot with no cursor. GET /demo is a free NVDA sample. POST /try is a free 24h watch for evaluating the cursor loop.
  x-use-cases:
  - keep watching a source between scheduled agent runs
  - tell me what I missed since I last ran
  - periodically check a supported source without operating my own poller
  - alert me when a web page changes
  - monitor a competitor's pricing page for changes
  - watch a docs or status page for updates
  - detect when a government or regulatory page is updated
  - get notified about new items in an RSS feed
  - alert me when bitcoin crosses a price threshold
  - notify me when a crypto price moves more than 5% in a day
  - watch a company for new SEC filings
  - alert me when a company files an 8-K
  - tell me when a corporate insider buys or sells stock
  - track Form 4 insider transactions for a ticker
  - get the latest Form 4 insider trades for NVDA
  - decode the latest 8-K items for a ticker
  - check a company's recent SEC filings right now
  - see a web page's current text without watching it
  - monitor an x402 API for downtime or payment challenge changes
  - alert me when an x402 endpoint changes price, network, scheme, or recipient
  - validate an x402 payment challenge without paying the target endpoint
servers:
- url: https://longwatch.dev
tags:
- name: MCP
paths:
  /mcp:
    post:
      summary: MCP endpoint (Streamable HTTP) — same capabilities as the REST routes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  const: '2.0'
                id:
                  type:
                  - number
                  - string
                method:
                  type: string
                  description: initialize | tools/list | tools/call
                params:
                  type: object
                  properties:
                    name:
                      type: string
                      description: tool name for tools/call
                    arguments:
                      type: object
                      description: tool arguments
              required:
              - jsonrpc
              - method
            example:
              jsonrpc: '2.0'
              id: 1
              method: tools/call
              params:
                name: check_now
                arguments:
                  type: edgar
                  ticker: NVDA
                  forms:
                  - 8-K
                  - '4'
      description: 'JSON-RPC MCP endpoint (Streamable HTTP). Priced per tool: check_now $0.001, create_watch $0.005, check_web_page $0.001, watch_web_page $0.005, check_rss_feed $0.001, watch_rss_feed $0.005, check_crypto_price $0.001, watch_crypto_price $0.005, check_sec_filings $0.001, watch_sec_filings $0.005, check_insider_trades $0.001, watch_insider_trades $0.005, check_x402_endpoint $0.001, watch_x402_endpoint $0.005, poll_alerts $0.005, try_watch free, poll_trial free, delete_watch free. initialize and tools/list are free; payment is charged only when a tool runs, so a bare probe of this URL will not return 402.'
      operationId: mcp
      tags:
      - MCP
      responses:
        '200':
          description: JSON-RPC result
        '402':
          description: Payment required
      security: []
x-tags:
- website monitoring
- sec-filings
- rss
- price-alerts
- x402 monitoring