Avanza MCP Server

Read-only access to Avanza's public market data from your MCP client. No Avanza account required.

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.

Features

• Stocks, funds, ETFs, certificates, warrants and futures/forwards.
• Quotes, charts, financial ratios, dividends, order books and ownership data.
• Fund performance, fees, holdings, sustainability and research prompts.

Setup

Requires uv and Python 3.12+. Local clients launch the server over stdio.

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

claude mcp add avanza -- uvx avanza-mcp

{
  "servers": {
    "avanza": {
      "type": "stdio",
      "command": "uvx",
      "args": ["avanza-mcp"]
    }
  }
}

{
  "mcp": {
    "avanza": {
      "type": "local",
      "command": ["uvx", "avanza-mcp"],
      "enabled": true
    }
  }
}

uv sync
uv run fastmcp run src/avanza_mcp/__init__.py:mcp --transport http

import asyncio
from fastmcp import Client
from avanza_mcp import mcp

async def main():
    async with Client(mcp) as client:
        result = await client.call_tool(
            "search_instruments", {"query": "Volvo", "instrument_type": "stock"}
        )
        print(result.structured_content)

asyncio.run(main())

If a desktop client cannot find uvx, use its absolute executable path. See DEVELOPMENT.md for running from source and tests.

Tools

All 34 tools are read-only. Search first to obtain an order_book_id; history tools expose pagination. Data is latest available, not guaranteed live.

Prompts

• analyze_stock(stock_symbol) - Research a stock's fundamentals and price history.
• compare_funds(fund_names) - Compare two or more supplied funds.
• screen_dividend_stocks(candidates, min_yield=3.0) - Screen supplied stocks by dividend yield.

Resources

• avanza://docs/usage - Tool usage guide.
• avanza://docs/quick-start - Common workflows.
• avanza://stock/{order_book_id} - Stock summary as Markdown.
• avanza://fund/{order_book_id} - Fund summary as Markdown.

License

MIT