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" } } }
| Tool | Description |
|---|---|
create_account no key | Create 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 key | Recent 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 key | Latest FX rate (ECB reference, daily) or crypto price (Coinbase public rates). Stock quotes are not provided (licensing) – use a price alert instead. |
get_account | Account info: default channels, webhook signing secret, alert counts. |
update_account | Set default notification channels (used by alerts without their own channels) and/or label. |
create_alert | Create 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_alerts | Bulk 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_alerts | List your alerts with status (active / triggered / paused / expired), data_status and last trigger. |
update_alert | Update one alert by id or external_id (target, condition, forms, note, channels, repeat, status=active to re-arm or paused). |
delete_alert | Delete one alert by id or external_id. |
list_events | Your 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_notification | Send a test notification to given channels (or your default channels). |
delete_account | Permanently 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
- stock – Delayed stock prices from a licensed source. Notifications report that your condition was met (derived signal); raw quotes are not redistributed. e.g.
AAPL, MSFT, SAP.XETRA - crypto – Coinbase public exchange rates, any BASE-QUOTE pair. Checked every 5 min. e.g.
BTC-USD, ETH-EUR - fx – ECB euro reference rates, updated once per business day (~16:00 CET). e.g.
EUR/CZK, USD/JPY - filing – SEC EDGAR submissions, checked ~every 10 minutes. Default forms: 8-K, 10-K, 10-Q, 6-K, 20-F, S-1, SC 13D, SC 13G, 4, DEF 14A.
["*"]= all.
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.