English Français العربية

io.github.vanoe-ai/vanoe-intelligence-mcp

Official registry Finance and payments

Stock verdicts, trend stage, P&F, breadth, macro regime, SEC filings. Free key: api.vanoe.ai/signup

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package vanoe-intelligence-mcp
Claude Code 
claude mcp add vanoe-intelligence-mcp -e 'VANOE_API_KEY=<your vanoe_api_key>' -e 'VANOE_API_BASE_URL=https://api.vanoe.ai' -- uvx vanoe-intelligence-mcp==0.1.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vanoe-intelligence-mcp": {
            "command": "uvx",
            "args": [
                "vanoe-intelligence-mcp==0.1.6"
            ],
            "env": {
                "VANOE_API_KEY": "<your vanoe_api_key>",
                "VANOE_API_BASE_URL": "https://api.vanoe.ai"
            }
        }
    }
}

Environment variables

  • VANOE_API_KEY required secret Your Vanoe Market Intelligence API key (free at https://api.vanoe.ai/signup)
  • VANOE_API_BASE_URL API base URL; only override for a self-hosted or local instance

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Vanoe Market Intelligence MCP server
  2. Hosted endpoint (no install)
  3. Claude Desktop: one-click install
  4. Install
  5. Configure your MCP client
  6. Tools
  7. Development
  8. Releasing

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/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.

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

ToolAPI callCredits
get_verdict(ticker)GET /v1/verdict/{ticker}5
get_stage(tickers)GET /v1/signals/stage1 per ticker
get_stage_history(ticker, weeks)GET /v1/signals/stage/history5
get_pnf(tickers)GET /v1/signals/pnf1 per ticker
get_sector_breadth()GET /v1/sector-breadth1
get_macro()GET /v1/macro1
get_filings(ticker)GET /v1/filings/{ticker}1
get_short_pressure(tickers)GET /v1/signals/short-pressure1 per ticker
get_calendar()GET /v1/calendar1
get_usage()GET /v1/usage0

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.

Frequently asked questions

What is io.github.vanoe-ai/vanoe-intelligence-mcp?

Stock verdicts, trend stage, P&F, breadth, macro regime, SEC filings. Free key: api.vanoe.ai/signup

How do I install io.github.vanoe-ai/vanoe-intelligence-mcp?

It runs on your machine. In Claude Code: claude mcp add vanoe-intelligence-mcp -e 'VANOE_API_KEY=<your vanoe_api_key>' -e 'VANOE_API_BASE_URL=https://api.vanoe.ai' -- uvx vanoe-intelligence-mcp==0.1.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.vanoe-ai/vanoe-intelligence-mcp need an API key?

Yes. It expects VANOE_API_KEY, which you set in its configuration.

Is io.github.vanoe-ai/vanoe-intelligence-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.vanoe-ai/vanoe-intelligence-mcp?

It is published by vanoe-ai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.