Avanza MCP Server

Read-only access to Avanza market and optional account data from your MCP client. Public tools require no Avanza account.

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.
• Optional local BankID authentication for read-only accounts, holdings and activity.

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.

Experimental Account Access

Authenticated access is disabled by default. Enable it by adding AVANZA_MCP_AUTH=1 to the local MCP server environment. For example, OpenCode uses:

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

Restart OpenCode after changing its configuration.

Authentication Flow

1. A temporary page opens on 127.0.0.1 and asks for consent.
2. After approval, scan the locally rendered QR code with BankID.
3. Avanza verifies the session and enables the experimental tools.

No Avanza password is requested in the browser or chat. Existing market-data tools automatically use the valid session when one is available; no duplicate authenticated market tools are added.

Session Data

Verified session cookies and the Avanza security token are stored in the operating system's native credential store and revalidated on startup:

• macOS Keychain
• Windows Credential Manager
• Linux Secret Service, which must be installed, unlocked and available over D-Bus

Credentials are not stored in project files, browser storage, logs, or MCP results. Account responses are not cached by this project.

Avanza controls session duration through the account's website setting. See How long can I stay logged in? to change it.

Use disconnect_avanza to remove the local credential and attempt remote logout.

Account tool results may be sent to the configured model provider and saved in conversation history.

Tools

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

Experimental Auth Tools

These tools are available only when experimental account access is enabled. Data access is read-only; no tool places, edits, or cancels orders.

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