equity_research_brief
Equity research brief on one US-listed company (SEC filings) ($0.25)
Use when writing a stock thesis, an investment memo, a watchlist note or answering "is this company any good?". Up to 4 fiscal years of revenue, gross/operating/net margin, free cash flow, R&D, stock comp, buybacks and dividends; growth (YoY, CAGR, margin change, share-count change); latest quarter vs year-ago; balance sheet (cash, debt, net cash, current ratio, ROE); per-share figures; a 0-100 fundamental quality score with every component; bull, bear and watch points each quoting the number behind it; SEC filing links. Optional price= adds market cap, P/E, P/S, P/FCF, EV/Sales and yields. ticker = symbol, company name or CIK (default AAPL); about 1,850 US companies with revenue >= $750M or assets >= $10B. Not covered = error, not charged. No ratings or recommendations. PAID: $0.25 per call, no account. Pay with x402 over MCP (USDC on Base), or with a Research Pass (header Authorization: Bearer lp1...). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/equity/brief.
Parameterspriceticker
stock_screen
Daily fundamentals stock screen (about 1,850 US companies) ($0.05)
Use for a daily stock screen or to find candidates: rank by quality, growth, op_margin, fcf_margin, roe, net_cash, shrink (biggest share-count reduction), quarter_growth or revenue; filter by min revenue, growth, margins, quality, positive FCF, net cash, exchange; top 1-100. Each row: ticker, revenue, YoY and CAGR, latest-quarter growth, operating and FCF margin, ROE, net cash, share-count change, quality score. Data: SEC XBRL filings. PAID: $0.05 per call, no account. Pay with x402 over MCP (USDC on Base), or with a Research Pass (header Authorization: Bearer lp1...). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/equity/screen.
Parameterstopsortexchangenet_cashmin_qualitypositive_fcfmin_growth_pctmin_revenue_usdmin_op_margin_pctmin_fcf_margin_pct
portfolio_review
Portfolio / watchlist review: up to 25 US stocks in one call (SEC filings) ($1.00)
Use when someone shares a list of stocks they hold or watch and asks "how healthy is this portfolio?", "what should I look at first?" or "which of these report next?". tickers = comma list (1-25), weights = optional numbers in the same order. Returns per-holding quality score, growth, margins, free cash flow, net cash, dilution and red flags with severity; portfolio-weighted quality, growth and margins; share of weight in loss-makers, negative FCF, net debt; concentration; a review-first list ranked by weight x flag severity; strongest holdings; an estimated reporting calendar; CSV. Charged only if covered holdings carry >= 50% of the weight. Counts as 10 calls on a Research Pass. Research only, no recommendations. PAID: $1.00 per call, no account. Pay with x402 over MCP (USDC on Base), or with a Research Pass (header Authorization: Bearer lp1...). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/equity/portfolio.
Parameterstickersweights
stablecoin_report
Stablecoin due-diligence report (90-day peg history) ($0.04)
Before holding or accepting one stablecoin in size: 90-day daily and 7-day hourly peg history (worst print, days off peg), supply rank and 1/7/30-day mint and redemption flows, chain split, peers, every risk component explained, plain-English summary. coin = ticker, name or CoinGecko id (default USDe). PAID: $0.04 per call, no account. Pay with x402 over MCP (USDC on Base), or with a Research Pass (header Authorization: Bearer lp1...). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/stablecoins/report.
Parameterscoin
stablecoin_risk_board
Risk board of every USD stablecoin ($0.01)
Before parking funds in a stablecoin or as a daily depeg / bank-run monitor: every USD stablecoin above $10M with price, peg deviation (bp), 1d/7d/30d supply change and net flows, mechanism, chains, 0-100 risk score, tier, flags and market-wide alerts. PAID: $0.01 per call, no account. Pay with x402 over MCP (USDC on Base), or with a Research Pass (header Authorization: Bearer lp1...). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/stablecoins/board.
Parameterstopsortsymbolsmin_supply_usd
buy_research_pass_day
Buy a 24-hour Research Pass ($1, up to 40 calls) ($1.00)
For research sessions: one x402 payment of $1 returns a pass token that unlocks every paid tool here for 24 hours (up to 40 successful calls; four briefs alone list at $1). Then set the MCP client header "Authorization: Bearer <pass>" or pass _meta["lumen/pass"]. PAID: $1.00, no account. Pay with x402 over MCP (USDC on Base). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/pass/day.
Takes no parameters.
buy_research_pass_week
Buy a 7-day Research Pass ($5, up to 300 calls) ($5.00)
One x402 payment of $5 returns a pass token that unlocks every paid tool here for 7 days (up to 300 successful calls). Then set the MCP client header "Authorization: Bearer <pass>" or pass _meta["lumen/pass"]. PAID: $5.00, no account. Pay with x402 over MCP (USDC on Base). An unpaid call returns the payment terms and charges nothing; bad input is rejected before any payment; failed work is never charged. Same data as GET /v1/pass/week.
Takes no parameters.
payment_options
How to pay (free)
FREE. Prices, the receiving address, the x402-over-MCP retry format, and how to use a Research Pass instead (bought once with x402 or with a plain USDC transfer on Base, no x402 client needed).
Takes no parameters.
equity_coverage_check
Is this company covered? (free)
FREE. Whether a company is in the equity universe, its latest fiscal year end and filing dates, before paying for equity_research_brief.
Parameterstickerrequired
pass_quote
Buy a Research Pass with a plain USDC transfer: get a quote (free)
FREE, no x402 needed. Returns a quote and the USDC amount to send on Base to this service. After sending, call pass_claim with the quote and the transaction hash to receive the pass token.
Parametersfromplan
pass_claim
Claim the Research Pass after your transfer (free)
FREE. After the transfer has landed on Base, returns your lp1.… pass (claiming again returns the same pass). Then set the MCP header "Authorization: Bearer <pass>" or pass _meta["lumen/pass"].
Parameterstxrequiredquoterequired
pass_status
Calls and time left on your pass (free)
FREE. Plan, expiry and calls left on the pass sent as the MCP header "Authorization: Bearer lp1..." (or _meta["lumen/pass"]).
Takes no parameters.