Skip to main content

MCP server for Avanza public market data API - Swedish stocks, funds, and more

Project description

Avanza MCP Server

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.

⚠️ 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)

💡 MCP Prompts

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

Configuration for MCP Clients

For Claude Desktop or other MCP clients, add to your configuration:

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

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 for details.

🤝 Contributing

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

avanza_mcp-1.1.0.tar.gz (92.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

avanza_mcp-1.1.0-py3-none-any.whl (29.8 kB view details)

Uploaded Python 3

File details

Details for the file avanza_mcp-1.1.0.tar.gz.

File metadata

  • Download URL: avanza_mcp-1.1.0.tar.gz
  • Upload date:
  • Size: 92.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for avanza_mcp-1.1.0.tar.gz
Algorithm Hash digest
SHA256 a413e282e1c8233d4ed783f0da5c0e6df004d0e610dfd1d82b368653991ec77e
MD5 2e4e9c9cb62b2a71a4afc64777ec72d9
BLAKE2b-256 8fa20c3fb72ec73cdcca517d27fdd02cfbd7573aae5e9131462f4a90b5757a79

See more details on using hashes here.

File details

Details for the file avanza_mcp-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: avanza_mcp-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 29.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for avanza_mcp-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 991bc5d6756a376604f06c93edbb7445d3c40720509f92a9d1cdbd996d21c612
MD5 b772607d79da22e7ff73edf52d984881
BLAKE2b-256 40bf8f9ad50e1711a59f8082a4d7b7c50cc8001e03bdc75a72a1023bcc887237

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page