avanza

Avanza MCP Server exposes Avanza's public market data and investment information through MCP-compatible tooling. It provides a suite of tools to fetch instrument data, real-time quotes, order book depth, charts, fund details, and ESG metrics, as well as search, filtering, and analysis capabilities. With the avanza MCP server configured, you can query for instruments by name or symbol, retrieve complete stock or fund details, obtain live quotes and trade activity, and generate historical charts and performance metrics. Tools are organized into categories such as Search & Discovery, Stock Analysis, Fund Analysis, Certificates, Warrants, ETFs, Futures/Forwards, and Additional Data, each exposing specific endpoints like get_stock_quote, get_instrument_by_order_book_id, get_fund_chart, get_dividends, and more. To use them, point your MCP-enabled client at the avanza server (via uvx) and call the desired tool with the appropriate parameters as documented by your client’s MCP integration.

Prerequisites:

• Python 3.10+ (or as required by your uvx setup)
• The uv runtime (uv) installed following the official instructions at https://docs.astral.sh/uv/

Installation steps:

1. Install the uv runtime according to the guidance at the official uv documentation (e.g., OS-specific installation commands).
2. Ensure uvx is available in your environment. The Avanza MCP server is run via uvx with the package name avanza-mcp.
3. Start the MCP server using the provided command:

uvx --prerelease=allow avanza-mcp

Note: The --prerelease=allow flag is required for avanza-mcp as it depends on fastmcp 3.0 (beta) during the current release cycle. This flag can be removed once fastmcp 3.0 is stable.

Optional: If using in an IDE or editor, configure your MCP client to reference the avanza server with the same command and arguments.

Tips and considerations:

• The server requires the --prerelease=allow flag due to its beta fastmcp dependency; enable this flag as shown in the installation steps.
• This MCP server provides a broad range of instruments and data types (stocks, ETFs, funds, certificates, warrants, futures); use the Search & Discovery tools to locate instruments before querying detailed data.
• Ensure your MCP client (Claude Desktop, Cursor, VS Code, or other MCP-enabled tooling) is configured with the avanza server using the uvx+avanza-mcp configuration.
• If you encounter connectivity or data discrepancies, check the status of the Avanza public API and verify you’re using compatible client versions aligned with the MCP server tooling documentation.
• Environment variables are optional for basic usage but can be added if your deployment requires API keys or specific runtime settings per your environment.