Guides · Vanoe Market Intelligence API

Use stock signals from Claude, ChatGPT or any MCP client

The API ships as a Model Context Protocol server, so an assistant can call it as a set of tools rather than you copying JSON around. There are two ways in: a hosted endpoint that needs nothing installed, and an open-source package for clients that run tools locally.

Hosted endpoint (nothing to install)

Get a free key at /signup. The key page prints a ready-made connector URL of the form https://api.vanoe.ai/mcp/k/<your key>. In Claude.ai: Settings → Connectors → Add custom connector → paste the URL. In ChatGPT: Settings → Apps & connectors → Create, with the same URL. Clients that can send headers can use https://api.vanoe.ai/mcp with Authorization: Bearer <key> instead. Treat the URL with the key in it like a password.

Claude Desktop: one-click install

Download vanoe-market-intelligence.mcpb and open it with Claude Desktop on macOS or Windows. It asks for your API key once, stores it securely, and installs the server itself. No terminal needed.

Local package (Claude Code, Cursor, other clients)

The same tools as an installable package on PyPI, MIT licensed:

claude mcp add vanoe -e VANOE_API_KEY=sk_live_… -- uvx vanoe-intelligence-mcp

For Claude Desktop add to claude_desktop_config.json:

{"mcpServers": {"vanoe": {"command": "uvx", "args": ["vanoe-intelligence-mcp"],
  "env": {"VANOE_API_KEY": "sk_live_…"}}}}

Source: github.com/peeroren/vanoe-intelligence-mcp. Listed in the official MCP registry as io.github.peeroren/vanoe-intelligence-mcp.

What you can ask

"What's the verdict on NVDA and why?" · "Which of AAPL, MSFT and AMD are in Stage 2?" · "Is the macro regime risk-on right now?" · "Have any TSLA insiders bought recently?" · "What macro events are coming this week?" The assistant picks the tool, the API answers, and every call is metered against your own key exactly like a REST call, nothing hidden.

Request

# Claude Code
claude mcp add vanoe -e VANOE_API_KEY=sk_live_… -- uvx vanoe-intelligence-mcp

# Any MCP client that takes a URL (Claude.ai, ChatGPT)
https://api.vanoe.ai/mcp/k/sk_live_…

Response

# tools exposed to the assistant
get_verdict(ticker)            get_stage(tickers)        get_stage_history(ticker, weeks)
get_pnf(tickers)               get_sector_breadth()      get_macro()
get_filings(ticker)            get_calendar(within_days) get_usage()

Cost: Same as the REST endpoints behind each tool: a verdict is 5 credits, most signals 1 per ticker, usage is free.

Fields

get_verdict	GET /v1/verdict/{ticker}
get_stage / get_pnf	batch, comma-separated tickers
get_usage	credits used and remaining, free

Questions

Do I need to run anything on my computer?

Not for Claude.ai or ChatGPT: paste the hosted URL. Claude Desktop and Claude Code can use the same hosted URL or run the package locally with uvx.

Is it safe to put my key in the URL?

The URL is only ever sent over HTTPS to api.vanoe.ai and is not written to the server's request logs, but anyone who has the URL has your key, so keep it private and use the recovery page to rotate it if it leaks.

Does the assistant get a free ride?

No. Every tool call is a metered call against your plan, exactly like calling the REST API yourself.

Try it

Free tier: 1,000 credits a month, no card. Every response is informational data only, not financial advice.

Get a free API key API reference