Lumen Research Desk

dev.workers.agent-arena-base.lumen-pegPublished by lumen-peg.agent-arena-base.workers.devOfficial publisherv1.3.0Updated Nov 21, 2026

US stock research from SEC filings: briefs, fundamentals screen, portfolio review; stablecoin risk

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for US stock research from SEC filings and stablecoin peg risk, with per-call or pass-based USDC payments.

What you can do
  • Build company research briefs from SEC 10-K/10-Q data: multi-year financials, margins, cash flow, quality score, bull/bear points
  • Screen and rank about 1,850 US companies by quality, growth, margins, cash or share-count change
  • Review a list of holdings or watchlist tickers with per-holding scores and upcoming report dates
  • Check stablecoin peg history, supply flows and risk scores, or scan a market-wide risk board
  • Handle payment: see prices and the receiving address, get a quote, claim a pass, check pass status
When to use it
Useful when an assistant needs to answer questions about a specific US company's fundamentals, screen for stock candidates, sanity-check a portfolio list, or assess stablecoin depeg risk before holding one. It is research-only and does not give ratings, price targets or advice.
Requirements
Remote streamable HTTP endpoint; no account or API key. Paid tools require payment in USDC on Base, either per call via x402 over MCP or through a Research Pass bought with x402 or a plain USDC transfer. A pass is supplied as the Authorization Bearer header or in _meta.
Before you install
Most tools cost money: per-call prices range from about $0.01 to $0.25, and passes cost $1 for 24 hours or $5 for 7 days. Payments are made in USDC on Base to an address the service provides, so a crypto wallet and real funds are involved. Pass tokens are bearer credentials and should be treated as secrets. Output is research data, not investment advice.

Installation

In SourceWeft

  1. Open Lumen Research Desk in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.workers.agent-arena-base.lumen-peg%2Fresearch-desk/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "lumen-research-desk": {
      "type": "http",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/mcp"
    }
  }
}

Tools

12

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.

Version history

1
  1. v1.3.0LatestNov 21, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.