Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchOfficial JavaScript + Python + MCP examples for the BullAlert API — an instant small-cap / microcap momentum intelligence and SEC EDGAR filings API. Build a stock momentum scanner, a breadth-feed agent, a pump-and-dump risk screener, or wire the hosted MCP server into Claude or ChatGPT in minutes.
BullAlert is an informational data / intelligence tool — not financial advice. The API returns derived IP (a 0-100 momentum score, a
momentum/watchstatus) and public-domain SEC EDGAR facts. It does not return raw prices, percentages, or volume. You build your own strategy and do your own research. Seedocs/DISCLAIMER.mdand the full BullAlert disclaimer.
Keywords: BullAlert API · small-cap momentum API · microcap stock signals API · momentum scanner · stock screener API · SEC EDGAR filings API · pump and dump detector · MCP server for Claude & ChatGPT · algotrading examples · fintech developer tools · JavaScript & Python stock API.
BullAlert is an alternative-intelligence layer for US small-cap momentum. It surfaces positive-momentum $0.20–$20 microcaps early, ranks them with a proprietary 0-100 score, and records the names it flags. The public API exposes that intelligence as clean derived data — a score, a status, identity + timing, and SEC filing facts — so you can build screeners, agents, dashboards, and research tools. It is an information tool, never a trading app: you compute your own decisions.
These three surfaces are the same pipeline at three levels of strictness. Same universe, progressively narrower. Think breadth → ranking → fully-gated:
The funnel: every alert was on the watchlist; every watchlist row was a signal first. Signals is the widest net (hundreds), the watchlist is the ranked shortlist (top-N), and alerts is the narrow set that cleared all 20 gates (a few a day). None of these is advice or a buy/sell call — they're observations you act on yourself. The momentum-tracker example walks a ticker through all three.
Full reference: docs/API.md.
Create your account at bullalert.ai — sign up and pick a plan (API access is included with every subscription).
Once you're in, open Account → API in the app.
Generate a key. Keep it secret — send it in the x-ba-api-key header.
Set it as an environment variable (never hardcode it):
# macOS / Linux
export BULLALERT_API_KEY=your_key_here
# Windows PowerShell
$env:BULLALERT_API_KEY = "your_key_here"
Or copy .env.example to .env and fill it in.
curl -s https://api.bullalert.ai/v1/watchlist?status=momentum&limit=10 \
-H "x-ba-api-key: $BULLALERT_API_KEY"
cd javascript
node signals-feed.js # validated breadth feed
node momentum-tracker.js # signal -> watchlist rank -> alert funnel
node pump-and-dump-screener.js # momentum board + SEC dilution risk context
node catalyst-momentum.js # freshest signals cross-referenced with SEC filings
node new-alert-watcher.js # poll the published alerts feed for new names
import { BullAlertClient } from './lib/client.js';
const client = new BullAlertClient(); // reads BULLALERT_API_KEY
const { data } = await client.watchlist({ status: 'momentum', limit: 10 });
data.watchlist.forEach((r) => console.log(`#${r.rank} ${r.ticker} ${r.score} (${r.status})`));
More: javascript/README.md.
requests)cd python
pip install -r requirements.txt
python signals_feed.py
python momentum_tracker.py
python pump_and_dump_screener.py
python catalyst_momentum.py
python new_alert_watcher.py
from bullalert_client import BullAlertClient, load_dotenv
load_dotenv()
client = BullAlertClient() # reads BULLALERT_API_KEY
for r in client.watchlist(status="momentum", limit=10)["data"]["watchlist"]:
print(f"#{r['rank']} {r['ticker']} {r['score']} ({r['status']})")
More: python/README.md.
BullAlert hosts an MCP server at https://api.bullalert.ai/v1/mcp with 4 tools
(list_watchlist, list_signals, list_alerts, get_company_financials). Drop in a config and
ask in plain English: "List the top 10 BullAlert momentum tickers and check each for an SEC
equity-offering flag."
mcp/claude-desktop.jsonmcp/cursor.jsonmcp/chatgpt.mdMore: mcp/README.md.
Per key: lite 30 / default 60 / b2b 300 requests per minute, plus daily + monthly pools. All
/v1/* share one bucket; responses carry X-RateLimit-* headers; over-limit returns 429 with a
Retry-After. The limiter fails open. Full details: docs/RATE_LIMITS.md.
MIT — © 2026 BullAlert. Examples are provided as-is, for informational purposes only.
Not financial advice. See docs/DISCLAIMER.md · bullalert.ai/disclaimer.
Links: BullAlert API docs · Dashboard · Disclaimer · Blog
JavaScript, Python & MCP examples for the BullAlert API — small-cap momentum signals, a ranked watchlist, alerts & SEC EDGAR filings. Informational, not financial advice.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Bullalert Ai Examples runs locally over stdio.
Last checked 2026-10-28. JavaScript, Python & MCP examples for the BullAlert API — small-cap momentum signals, a ranked watchlist, alerts & SEC EDGAR filings. Informational, not financial advice.