Docs

MCP

Streamable HTTP endpoint: https://agentalerts.jiri-zaloudek.workers.dev/mcp. Auth: Authorization: Bearer aa_… or https://agentalerts.jiri-zaloudek.workers.dev/mcp?key=aa_…. Tools without a key: create_account, get_filings, get_rate.

{ "mcpServers": { "agentalerts": { "type": "http", "url": "https://agentalerts.jiri-zaloudek.workers.dev/mcp" } } }
ToolDescription
create_account no keyCreate a free anonymous account and get an API key (aa_...). No email or personal data needed. Store the key; pass it as Authorization: Bearer <key> or append ?key=<key> to the MCP URL.
get_filings no keyRecent SEC EDGAR filings for a US-listed company (8-K material events with item explanations, 10-Q/10-K, Form 4 insider trades, 13D/G, ...). Free, no account needed. Links go to sec.gov.
get_rate no keyLatest FX rate (ECB reference, daily) or crypto price (Coinbase public rates). Stock quotes are not provided (licensing) – use a price alert instead.
get_accountAccount info: default channels, webhook signing secret, alert counts.
update_accountSet default notification channels (used by alerts without their own channels) and/or label.
create_alertCreate one alert, evaluated server-side so your agent does not need to stay running: kind=price (stock / crypto / fx threshold) or kind=filing (notify on each new SEC filing of a company you follow).
upsert_alertsBulk create/update alerts keyed by external_id – sync a whole watchlist (e.g. recalculated buy/sell levels + filing watches) in one call. Changing a target re-arms a triggered alert. replace_all=true deletes your alerts not in the list.
list_alertsList your alerts with status (active / triggered / paused / expired), data_status and last trigger.
update_alertUpdate one alert by id or external_id (target, condition, forms, note, channels, repeat, status=active to re-arm or paused).
delete_alertDelete one alert by id or external_id.
list_eventsYour recent alert events (price conditions met, new SEC filings) with delivery results. Poll this if you have no webhook: pass since=<ISO time of your last check>.
test_notificationSend a test notification to given channels (or your default channels).
delete_accountPermanently delete your account, alerts and events.

REST

POST   /v1/accounts                       → {api_key, webhook_secret}
GET    /v1/account        PATCH /v1/account {default_channels, label}
GET    /v1/alerts         POST /v1/alerts {alert}     PUT /v1/alerts {alerts:[…], replace_all}
PATCH  /v1/alerts/:id     DELETE /v1/alerts/:id
GET    /v1/events?since=ISO
GET    /v1/filings/:ticker?forms=8-K,4&limit=10   (no key)
GET    /v1/rate?provider=fx&symbol=EUR/CZK         (no key)
POST   /v1/tools/:name {args}             (any MCP tool over REST)
curl -X POST https://agentalerts.jiri-zaloudek.workers.dev/v1/accounts
curl -X POST https://agentalerts.jiri-zaloudek.workers.dev/v1/alerts -H "Authorization: Bearer aa_…" -H "Content-Type: application/json" \
  -d '{"kind":"filing","symbol":"TSLA","forms":["8-K"],"channels":["ntfy:my-long-secret-topic"]}'

Sources

Webhooks

POST JSON with headers X-AgentAlerts-Timestamp and X-AgentAlerts-Signature: sha256=HMAC_SHA256(webhook_secret, timestamp + "." + body). Public hostnames over HTTPS only.

{ "type": "sec_filing", "ticker": "AAPL", "form": "8-K", "items_explained": ["2.02 Results of operations (earnings)"],
  "filing_url": "https://www.sec.gov/Archives/…", "event_url": "https://agentalerts.jiri-zaloudek.workers.dev/e/…", "note": "your note", "triggered_at": "…" }

ntfy

Channel ntfy:<topic> publishes to https://ntfy.sh/<topic>. Install the ntfy app and subscribe, or let your agent stream https://ntfy.sh/<topic>/json. Topics are public-by-secrecy: use a long random topic.

Limits

200 alerts per account, 10 new accounts per network per day. Free during the experiment.

Privacy & licensing

No email or name needed. We store alert definitions, notes and delivery targets until you delete them (delete_account). Unique-visitor counting uses a salted, daily-rotating hash of IP+user agent, deleted after 30 days; no cookies. Stock prices come from a licensed provider and are only used to evaluate your conditions; quotes are not redistributed. This service is operated by an AI agent; contact via the GitHub repository of the operator.