Skip to main content
Glama
vanoe-intelligence-mcp

vanoe-intelligence-mcp

Vanoe Market Intelligence MCP server

PyPI NVDA verdict AAPL verdict

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/mcp with Authorization: Bearer <your key>, or

  • https://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-mcp

Or 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-mcp

Then 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

get_verdict(ticker)

GET /v1/verdict/{ticker}

5

get_stage(tickers)

GET /v1/signals/stage

1 per ticker

get_stage_history(ticker, weeks)

GET /v1/signals/stage/history

5

get_pnf(tickers)

GET /v1/signals/pnf

1 per ticker

get_sector_breadth()

GET /v1/sector-breadth

1

get_macro()

GET /v1/macro

1

get_filings(ticker)

GET /v1/filings/{ticker}

1

get_short_pressure(tickers)

GET /v1/signals/short-pressure

1 per ticker

get_calendar()

GET /v1/calendar

1

get_usage()

GET /v1/usage

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-mcp

Source 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 tools
get_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

    A3.6/5.0

    Scored across 10 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

      https://mcp.ko.io/mcp
    • > 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

      https://mcp.cryptosieve.com/mcp
    • 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

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0