# ValuEdge MCP [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://valuedge.app/connect  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/valuedge-mcp

## Description
Research public stocks with valuations, fundamentals, comparisons, and screening. Public research needs no sign-in; private ValuEdge data requires authorization.

## Tools
Capabilities this server exposes over MCP:

- **search_securities** — Use this when the user gives an ambiguous company name or ticker and you need to resolve it before valuation or comparison. Search is limited to the ValuEdge-supported security universe.
- **get_stock_valuation** — Use this when the user asks for one stock's ValuEdge fair value, current price, margin of safety, valuation method, assumptions, confidence, or valuation risk. official_fair_value_source identifies the upstream model/component, while valuation_method_label describes headline composition, so a DCF source can accompany a blended headline. specialist_model.fair_value_blend is the optional source-provided equity-model breakdown and may be null when unavailable; blending_applied is independently reconciled from valid top-level canonical DCF/multiples values and weights. Do not use it for a user's private portfolio.
- **get_stock_fundamentals** — Use this when the user asks for a stock's ValuEdge financial history, profitability, growth, balance-sheet evidence, business quality, or data coverage. An optional history_limit requests up to 30 periods of selected metrics, current EPS consensus for at most three future fiscal years where present, quarterly P/E samples from existing monthly observations, and bounded source-native annual income, balance-sheet, and cash-flow statement rows where the existing snapshot contains them. EPS is not normalized and past estimate revisions are unavailable. Selected metric trends remain distinct from the full annual statement JSON. Do not infer a trade instruction.
- **get_stock_technicals** — Use this when the user requests verified daily technical analysis of one confirmed stock: SMA 20/50/200, RSI 14, trend states, momentum, price performance, ATR, relative volume, and historical volatility. Requires ValuEdge OAuth and uses one unit from the existing account research/valuation allowance; the same ledger and plan limits apply to web and MCP. This is an end-of-day snapshot, not an intraday price feed. Do not claim MACD, chart patterns, support or resistance levels unless independently available. Never fill null indicators or issue buy/sell instructions.
- **compare_stocks** — Use this when the user asks to compare two to six confirmed stocks on current price, canonical fair value, margin of safety, confidence, valuation risk, and fair-value coverage. This tool compares valuation only; use get_stock_fundamentals separately for growth, profitability, or balance-sheet claims. Do not declare a universal winner or give buy, sell, or hold instructions.
- **screen_stocks** — Use this when the user asks to screen supported U.S.-listed stocks by valuation, growth, profitability, dividends, size, or quality. Search ValuEdge's bounded NYSE/NASDAQ research dataset using an available preset or supported filters. A signed-in ValuEdge account is required and account limits apply. Percentage inputs use decimal fractions (0.15 = 15%). Custom screens require market capitalization of at least 300 million in listing currency and a valid fair-value estimate. The server uses a 60-candidate window and at most 12 returned rows, so results are not an exhaustive market scan. Report applied criteria, available source dates, and missing coverage. This tool returns research data only and cannot place trades or modify accounts.
- **get_my_portfolio** — Use this when the authenticated user asks to review their own ValuEdge portfolio, holdings, market value, fair-value coverage, allocation, concentration, or risk context. Never accepts a user id and never returns another user's data.
- **analyze_my_portfolio** — Use this when the authenticated user asks for their own portfolio concentration, sector or currency allocation, fair-value coverage, or risk context. Explain evidence and limitations without giving buy, sell, or hold instructions.
- **list_my_portfolio_transactions** — List transaction IDs and exact position records in the signed-in user's portfolios. Only manual records can be edited; brokerage and imported records remain read-only. Use this before selecting a transaction to change or remove.
- **record_my_portfolio_transaction** — Record a historical or current manual BUY or SELL in the signed-in user's ValuEdge portfolio, without placing an actual trade. Creating a new portfolio through its first transaction consumes a portfolio slot. Enforce current plan limits. Never write to broker-synced portfolios.
- **edit_my_portfolio_transaction** — Adjust quantity and entry price of one exact manually recorded BUY transaction by its ID. This changes displayed manual holdings and is not a brokerage trade. Check the user's prior record and confirm the intended correction; synced and imported transactions cannot be changed.
- **remove_my_portfolio_transaction** — Permanently remove one exact owned manually recorded BUY or SELL transaction. Obtain explicit confirmation from the user and use the transaction ID from the ledger. Never remove imported or broker-synced records.
- **remove_my_portfolio_holding** — Permanently remove all manual transaction records for one holding in one portfolio. Ask for explicit user confirmation and list the affected history first. Mixed-source, legacy, CSV and synced broker holdings are blocked. This does not execute any sale or modify a broker.
- **get_my_watchlist** — Use this when the authenticated user asks to review their own ValuEdge watchlist, including current price, canonical fair value, margin of safety, quality signals, and data freshness. Never accepts a user id.
- **get_my_smart_alerts** — Use this when the authenticated user asks to review their own ValuEdge Smart Alerts and the valuation context behind them. Never exposes another user's alerts or changes alert state.
- **list_my_watchlists** — List the authenticated user's ValuEdge Watchlist folders, including the default folder's ID. This is read-only. Choose an ID before writing to a non-default folder.
- **add_to_my_watchlist** — Add one verified stock or ETF to my ValuEdge Watchlist. Requires explicit per-client Watchlist write permission granted in ValuEdge. If multiple active listings share a ticker, request exchange. Never modifies a portfolio or broker account.
- **remove_from_my_watchlist** — Remove a saved ValuEdge Watchlist item, not a holding or broker position. Use an owned row_id when available, or an exact ticker and optional folder ID. Requires explicit Watchlist write permission and client confirmation.
- **create_my_watchlist** — Create a named ValuEdge Watchlist folder. Requires per-client Watchlist write consent and an active Trial or Unlimited entitlement; this does not change holdings.
- **rename_my_watchlist** — Rename one owned ValuEdge Watchlist folder, leaving its contents and IDs intact. Requires separate OAuth client Watchlist write consent.
- **get_dividend_calendar** — Use this when the user asks for a stock's dividend calendar, historical payouts, ex-dividend dates, upcoming known payment dates, or dividend per share. Returns bounded source-observed events from ValuEdge Dividend Hub, with ex-date, payment date, per-share amount and market-data source. Dates and payouts are only shown if provided by the upstream service. Past events are not proof of future payouts. Never infer a declaration, dividend-capture opportunity, or projected cash payment.
- **get_my_dividend_tracker** — Use this when the signed-in user asks about Dividend Hub, portfolio dividend tracker, projected annual dividend income, yield, growth, payout coverage, dividend safety, or which holdings pay dividends. Uses the canonical holdings-backed dividend profile and its verified FX conversion; reports incomplete coverage without manufacturing amounts. This is account-scoped read-only research, not a trade or a confirmed payout record.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What ValuEdge MCP does

ValuEdge MCP exposes ValuEdge's stock research and account features through the Model Context Protocol. It covers supported securities, valuation estimates, financial fundamentals, verified end-of-day technical indicators, stock comparisons, bounded U.S.-listed stock screens, dividend information, and personal investing data.

Public research can be used without signing in. Account-scoped capabilities require ValuEdge authorization and are limited to the authenticated user's data. The server does not place trades, modify brokerage accounts, or provide trade instructions. Portfolio and research responses should be treated as evidence and context, including the stated coverage, source dates, and limitations.

## How it works

MCP clients connect to the hosted endpoint at `https://valuedge.app/mcp`. Use `search_securities` first when a company name or ticker is ambiguous, then pass a confirmed security to valuation, fundamentals, technical, comparison, or dividend tools.

Valuation tools return data such as price, fair value, margin of safety, valuation method, assumptions, confidence, and valuation risk. Fundamentals can optionally include bounded historical metrics, selected statement rows, available EPS consensus periods, and quarterly P/E observations. Technical analysis is an end-of-day snapshot with indicators such as SMA, RSI, ATR, relative volume, momentum, price performance, and historical volatility.

Authenticated portfolio tools are restricted to the signed-in user's account. Portfolio analysis covers holdings, allocation, concentration, fair-value coverage, and risk context. Watchlist and transaction changes require the relevant permissions or explicit confirmation, depending on the operation.

## Setup and configuration

Configure an MCP client with the hosted server URL:

```text
https://valuedge.app/mcp
```

Public stock research does not require a ValuEdge sign-in. Sign in and authorize ValuEdge when using private portfolio, watchlist, alert, transaction, dividend-tracker, screening, or technical-analysis capabilities. Technical analysis consumes one unit from the account's existing research or valuation allowance, and the same plan limits apply across ValuEdge web and MCP usage.

## Tools and capabilities

- Resolve ambiguous companies and tickers within ValuEdge's supported security universe.
- Retrieve individual-stock valuation, fundamentals, technical indicators, and dividend events.
- Compare two to six confirmed stocks on valuation-oriented measures.
- Screen supported NYSE and NASDAQ stocks by valuation, growth, profitability, dividends, size, or quality.
- Review personal portfolios, holdings, allocations, concentration, alerts, watchlists, and dividend tracking.
- Record, edit, or remove eligible manual portfolio transactions and manage watchlist folders and items.

## Limitations and notes

Stock screening uses a 60-candidate window and returns no more than 12 rows, so it is not an exhaustive market scan. Custom screens require a minimum market capitalization of 300 million in the listing currency and a valid fair-value estimate. Percentage filters use decimal values, such as `0.15` for 15%.

Technical data is end of day rather than an intraday feed. The server should not fill null indicators or infer MACD, chart patterns, support, or resistance. Fundamental history does not normalize EPS or provide past estimate revisions. Dividend events reflect source-observed data; historical payments do not establish future declarations or payouts.

Portfolio writes apply only to eligible manual records. Broker-synced, imported, CSV, and other blocked records cannot be edited or removed through the corresponding tools. Removing transactions or holdings is permanent and requires explicit confirmation. Creating a portfolio through its first manual transaction consumes a portfolio slot, and account plan limits apply.

_Full upstream README: https://allmcps.com/mcp/valuedge-mcp/readme_

