vanoe-intelligence-mcp
This server lets an MCP-capable AI assistant query Vanoe market-intelligence data per ticker, sector, or macro backdrop, with every call metered against your Vanoe API key.
Composite verdicts:
get_verdictreturns a 0–100 score, a accumulate/hold/distribute/avoid rating, and plain-English rationale for any ticker.Trend-stage analysis:
get_stageclassifies up to 50 tickers into basing/advancing/topping/declining;get_stage_historygives a backtest-safe weekly stage series (default 104 weeks, max 520).Point & Figure signals:
get_pnfshows buy/sell signals, breakout patterns, and relative strength vs SPY for up to 50 tickers.Sector breadth:
get_sector_breadthshows bullish-percent breadth by sector.Macro regime:
get_macroreports risk-on/neutral/risk-off regime, rates, inflation, yield curve, and positioning.SEC filings:
get_filingsreturns recent insider Form 4 transactions and 8-K filings for a ticker.Short pressure:
get_short_pressuregives FINRA short-sale volume, averages/trend, and the latest short-interest report for up to 50 tickers.Macro calendar:
get_calendarlists upcoming FOMC, CPI, payrolls, and similar events (default 10 days, max 60).Usage tracking:
get_usageshows current billing-period usage and remaining credits, free of charge.Error-safe design: tools never raise; failures return structured error objects with code, message, and HTTP status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vanoe-intelligence-mcp What's the verdict on NVDA and why?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vanoe Market Intelligence MCP server
Get a free API key in ten seconds: https://api.vanoe.ai/signup?src=mcp-readme — 1,000 credits a month, no card. The key page also prints the hosted MCP URL to paste into Claude.ai or ChatGPT as a connector.
Exposes the Vanoe Market Intelligence API as tools any MCP-capable AI assistant (Claude Desktop, Claude Code, Cursor, etc.) can call directly: a composite 0–100 verdict per ticker, trend-stage analysis (current and a backtest-safe weekly history), Point & Figure signals, sector breadth, the macro risk regime, SEC insider and 8-K filings, the macro calendar, and your usage.
This is a thin authenticated client, not a free tier: every tool call is a real, metered call against your plan using your own API key, exactly like calling the REST API yourself. Get a free key (1,000 credits a month, no card) here: https://api.vanoe.ai/signup?src=mcp-readme
Informational data only. Not financial advice. See https://api.vanoe.ai/terms.
Hosted endpoint (no install)
The same tools are served over MCP's streamable HTTP transport by the API itself, for clients that take a URL (Claude.ai custom connectors, ChatGPT, hosted agent platforms):
https://api.vanoe.ai/mcpwithAuthorization: Bearer <your key>, orhttps://api.vanoe.ai/mcp/k/<your key>for clients that cannot send headers (the key page after signup prints this URL; treat it like a password).
Stateless, JSON responses, metered exactly like the REST API. Use the package below when you want the server to run on your own machine.
Related MCP server: Financial Modeling Prep MCP Server
Claude Desktop: one-click install
Download vanoe-market-intelligence.mcpb
and open it with Claude Desktop (macOS or Windows). It asks for your API key
once, stores it securely, and installs the server itself using the uv
runtime. Source of the bundle is in mcpb/; rebuild with
npx @anthropic-ai/mcpb pack mcpb vanoe-market-intelligence.mcpb.
Install
No install step is needed with uv — uvx fetches
and runs the package on demand:
uvx vanoe-intelligence-mcpOr install it permanently with pipx install vanoe-intelligence-mcp or
pip install vanoe-intelligence-mcp, which puts a vanoe-intelligence-mcp
command on your PATH.
Configure your MCP client
Set one environment variable, VANOE_API_KEY. VANOE_API_BASE_URL is optional
and defaults to https://api.vanoe.ai.
Claude Desktop (claude_desktop_config.json) and most other clients:
{
"mcpServers": {
"vanoe": {
"command": "uvx",
"args": ["vanoe-intelligence-mcp"],
"env": { "VANOE_API_KEY": "sk_live_your_key_here" }
}
}
}Claude Code:
claude mcp add vanoe -e VANOE_API_KEY=sk_live_your_key_here -- uvx vanoe-intelligence-mcpThen ask your assistant things like "What's the verdict on NVDA and why?", "Which stage are AAPL, MSFT and AMD in?", or "Is the macro regime risk-on right now?" — it will call the tools below.
Tools
Tool | API call | Credits |
|
| 5 |
|
| 1 per ticker |
|
| 5 |
|
| 1 per ticker |
|
| 1 |
|
| 1 |
|
| 1 |
|
| 1 per ticker |
|
| 1 |
|
| 0 |
Tools never raise. Any failure — missing key, network error, quota exceeded,
an unknown ticker — comes back as {"error": {"code", "message", "http_status"}} carrying the API's own message, so the assistant can explain
what happened instead of crashing the call.
Webhook management is deliberately not exposed: it is account administration, not something to do mid-conversation. Use the REST API for that.
Development
git clone https://github.com/vanoe-ai/vanoe-intelligence-mcp.git
cd vanoe-intelligence-mcp
python -m venv .venv && . .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e '.[test]'
pytest tests
VANOE_API_BASE_URL=http://localhost:8000 VANOE_API_KEY=sk_live_… vanoe-intelligence-mcpSource lives at https://github.com/vanoe-ai/vanoe-intelligence-mcp; issues and
pull requests welcome. If you also run the API server locally, install this
in its own virtualenv, separate from the API server's own
requirements.txt: the mcp SDK pulls in a newer starlette than the API's
FastAPI pin tolerates, and sharing one environment breaks the API server with
Router.__init__() got an unexpected keyword argument 'on_startup'. End users
never hit this (the MCP server runs on their machine, next to their assistant).
tests/manual_e2e_smoke.py runs the real server as a subprocess over stdio
against a reachable API with a real key; it is not part of pytest.
The MCP Python SDK is on v2: the server class is
mcp.server.mcpserver.MCPServer (older tutorials show FastMCP at a
different import path).
Releasing
python -m build
twine upload dist/*Bump version in pyproject.toml first. The older INTEL_API_KEY /
INTEL_API_BASE_URL variable names are still accepted for compatibility.
Available Tools
10 toolsget_calendarA
Upcoming macro events (FOMC, CPI, payrolls) within a look-ahead window in days (default 10, max 60).
Inputs: within_days. Returns: result
get_filingsB
Recent SEC insider transactions (Form 4) and 8-K filings for one ticker.
Inputs: ticker (required). Returns: result
get_macroA
Macro regime (risk_on/neutral/risk_off), rates, inflation, yield curve, positioning.
Inputs: no named parameters. Returns: result
get_pnfB
Point & Figure signal, breakout pattern, and relative strength vs SPY, for up to 50 tickers. Pass tickers as a comma-separated string.
Inputs: tickers (required). Returns: result
get_sector_breadthA
Bullish-percent breadth by sector — the % of names in each sector on a Point & Figure buy signal.
Inputs: no named parameters. Returns: result
get_short_pressureA
Short pressure for up to 50 tickers: FINRA daily short-sale volume (share of volume sold short, latest, 10-day average, trend; market norm roughly 40-55%) plus the latest short-interest report (shares short, days to cover, change). Pass tickers as a comma-separated string.
Inputs: tickers (required). Returns: result
get_stageA
Stage analysis (1=Basing, 2=Advancing, 3=Topping, 4=Declining) for up to 50 tickers. Pass tickers as a comma-separated string, e.g. 'AAPL,MSFT,NVDA'.
Inputs: tickers (required). Returns: result
get_stage_historyA
Historical weekly trend-stage series for one ticker, walk-forward computed (no lookahead) — the only commercial source of trend stages as a backtest-safe data series. weeks defaults to 104, max 520.
Inputs: ticker (required), weeks. Returns: result
get_usageA
Your current billing-period usage and remaining credit quota on your plan. Free — never counts against quota.
Inputs: no named parameters. Returns: result
get_verdictA
Composite verdict for one ticker: fuses trend stage, Point & Figure, insider-transaction clusters, and macro regime into a 0-100 score, an accumulate/hold/distribute/avoid enum, and a plain-English rationale. One call replaces separately calling stage, pnf, filings, and macro.
Inputs: ticker (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools are distinct, but get_verdict clearly overlaps with get_stage, get_pnf, get_filings, and get_macro, as its description explicitly says it replaces calling them separately. An agent may still choose individual tools for customization, but the boundary is blurred.
All 10 tools follow a consistent get_<noun> pattern (get_macro, get_stage, get_short_pressure, etc.), making the naming predictable and easy to scan.
10 tools is well within the ideal 3-15 range for a financial intelligence server. The count feels slightly heavy due to the composite verdict tool, but no tool seems entirely redundant.
Covers macro, technicals, short data, filings, breadth, calendar, and account usage with good CRUD-like coverage for the domain. Minor gaps exist, such as no tool for historical filing retrieval or custom date ranges on most endpoints, but core workflows are supported.
Maintenance
Related MCP Connectors
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
> TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a strategy with walk-forward validation, scan for smart-money and volume signals, or get a one-prompt morning market brief. In clients that support MCP Apps, price charts and the Markets panel are drawn right in the chat. > 40+ tools covering crypto (real-time), stocks, ETFs, FX, futures and commodities across major global exchanges. > Hosted, nothing to install: Pro $9/month (2,500 tool calls) or Pro+ $29/month (10,000). Paid upfront with a 14-day money-back guarantee; your API key arrives right after checkout. > Built on the open-source tradingview-mcp core (MIT, ~5k GitHub stars): self-host it free, or use the hosted version with zero ops. > For research and education, not financial advice. Not affiliated with TradingView
The full TraderMatrix market-data connector for Claude, Cursor and any MCP client. 51 tools: scored and tiered unusual options activity, dealer gamma (GEX), Apex levels and gamma pockets, IV rank, sector flow, dark-pool net-notional rollups, market health and macro regime, gap-continuation and breakout signals, wheel and CSP screeners, a one-call ticker snapshot, and your own watchlists. Needs a TraderMatrix API key (OAuth sign-in works for Claude web and mobile). A free, no-key connector with the gapper scanner and Market Health tools is listed separately as TraderMatrix Free.
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI models to access real-time financial market data including stock quotes, fundamentals, daily prices, symbol search, and market status via the Alpha Vantage API. Works with any MCP-compatible client like Claude Desktop for natural language interaction.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through a standardized MCP interface. It provides 250+ tools across categories such as financial statements, quotes, technical indicators, ETFs, crypto, forex, commodities, economics, and SEC filings.360 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering equities, ETFs, crypto, forex, commodities, economics, and more. Supports dynamic or static toolsets over HTTP/SSE for integration with MCP clients.360 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, and economics. Supports dynamic, static, or full toolset loading over HTTP/SSE for Claude and other MCP clients.360 npmApache 2.0