Avanza Mcp

Avanza MCP Server

[](https://github.com/AnteWall/avanza-mcp/actions/workflows/ci.yml)

A Model Context Protocol (MCP) server providing access to Avanza's public API. Get real-time Swedish stock quotes, fund information, charts, and comprehensive market data.

🚀 Features

• Fetch instrument info (stocks, ETFs, funds)
• Real-time price quotes & order book depth
• Historical price charts & financial ratios
• Fund performance & ESG metrics
• Screening and comparison prompts

Installation for MCP Clients

Claude Desktop

Add the following to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "avanza": {
      "command": "uvx",
      "args": ["--prerelease=allow", "avanza-mcp"]
    }
  }
}

Restart Claude Desktop after saving the configuration.

Cursor

Cursor supports MCP servers via its settings.

1. Open Cursor Settings
2. Navigate to AI → MCP Servers
3. Add a new MCP server with the following configuration:

{
  "name": "avanza",
  "command": "uvx",
  "args": ["--prerelease=allow", "avanza-mcp"]
}

Once added, Cursor can query Avanza market data directly in chat and inline prompts.

Visual Studio Code

VS Code can use Avanza MCP Server through MCP-compatible extensions or custom AI tooling.

1. Ensure you have Python 3.10+ installed
2. Ensure uv is installed: https://docs.astral.sh/uv/
3. Add the following MCP server configuration to your MCP-enabled extension or tool:

{
  "mcpServers": {
    "avanza": {
      "command": "uvx",
      "args": ["--prerelease=allow", "avanza-mcp"]
    }
  }
}

Reload the VS Code window after updating the configuration.

> Note: MCP support depends on the specific extension you are using. Refer to your extension’s documentation for MCP setup details.

⚠️ Disclaimer

This is an unofficial API client/MCP Server. Not affiliated with Avanza Bank AB. The underlying API can be taken down or changed without warning at any point in time.

The author of this software is not responsible for any indirect damages (foreseeable or unforeseeable), such as, if necessary, loss or alteration of or fraudulent access to data, accidental transmission of viruses or of any other harmful element, loss of profits or opportunities, the cost of replacement goods and services or the attitude and behavior of a third party.

🛠️ MCP Tools

Search & Discovery

| Tool | Description | |------|-------------| | search_instruments | Find stocks, funds, ETFs by name or symbol | | get_instrument_by_order_book_id | Look up instruments by order book ID |

Stock Analysis

| Tool | Description | |------|-------------| | get_stock_info | Complete stock information with fundamentals | | get_stock_quote | Real-time price and volume data | | get_stock_analysis | Financial ratios by year and quarter | | get_stock_chart | Historical OHLC price data | | get_orderbook | Order book depth with bid/ask levels | | get_marketplace_info | Trading hours and market status | | get_recent_trades | Latest executed trades | | get_broker_trade_summary | Broker buy/sell activity | | get_dividends | Historical dividend data | | get_company_financials | Annual and quarterly financial statements |

Fund Analysis

| Tool | Description | |------|-------------| | get_fund_info | Complete fund information with performance | | get_fund_sustainability | ESG scores and sustainability metrics | | get_fund_chart | Historical performance charts | | get_fund_chart_periods | Performance across all time periods | | get_fund_description | Detailed fund description | | get_fund_holdings | Portfolio allocation (country, sector, top holdings) |

Certificates

| Tool | Description | |------|-------------| | filter_certificates | Search and filter certificates with pagination | | get_certificate_info | Get detailed certificate information | | get_certificate_details | Get extended certificate details |

Warrants

| Tool | Description | |------|-------------| | filter_warrants | Search and filter warrants (turbos, minis) | | get_warrant_info | Get detailed warrant information | | get_warrant_details | Get extended warrant details |

ETFs

| Tool | Description | |------|-------------| | filter_etfs | Search and filter exchange-traded funds | | get_etf_info | Get detailed ETF information | | get_etf_details | Get extended ETF details |

Futures/Forwards

| Tool | Description | |------|-------------| | list_futures_forwards | List available futures and forwards | | get_future_forward_filter_options | Get available filter options | | get_future_forward_info | Get contract information | | get_future_forward_details | Get extended contract details |

Additional Data

| Tool | Description | |------|-------------| | get_number_of_owners | Get owner count for any instrument | | get_short_selling | Get short selling data for instruments | | get_marketmaker_chart | Get OHLC price chart data for traded products (certificates, warrants, ETFs) |

💡 MCP Prompts

Analysis Prompts

• analyze_stock - Comprehensive stock analysis workflow
• compare_funds - Multi-fund comparison template
• screen_dividend_stocks - Dividend stock screening

Workflow Prompts (Teach AI Efficient Data Fetching)

• search_and_analyze_instrument - Guide for finding and analyzing instruments efficiently
• filter_instruments_efficiently - Guide for filtering large datasets with pagination
• compare_multiple_instruments - Guide for comparing instruments efficiently
• explore_market_segment - Guide for exploring market segments
• get_historical_analysis - Guide for analyzing historical data
• screen_by_criteria - Guide for screening by custom criteria

📚 MCP Resources

Documentation Resources

• avanza://docs/usage - Comprehensive usage guide for AI assistants
• avanza://docs/quick-start - Quick reference for common tasks

Instrument Resources

• avanza://stock/{instrument_id} - Get stock information as markdown
• avanza://fund/{instrument_id} - Get fund information as markdown

> Note: The --prerelease=allow flag is required because this package depends on fastmcp 3.0 (currently in beta). This will no longer be needed once fastmcp 3.0 stable is released.

Usage in Claude Desktop

Once configured, you can ask Claude:

• "Search for Volvo stock on Avanza"
• "Get the latest stock quote for Ericsson"
• "Show me sustainable Swedish funds"
• "What's in the order book for H&M?"
• "Compare the performance of these three funds"
• "What dividends has SEB paid over the years?"
• "Show me the portfolio holdings for Avanza Global fund"

📄 License

MIT License - See [LICENSE.md](LICENSE.md) for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AnteWall
• Source: AnteWall/avanza-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.