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 workflowcompare_funds- Multi-fund comparison templatescreen_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=allowflag 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a413e282e1c8233d4ed783f0da5c0e6df004d0e610dfd1d82b368653991ec77e
|
|
| MD5 |
2e4e9c9cb62b2a71a4afc64777ec72d9
|
|
| BLAKE2b-256 |
8fa20c3fb72ec73cdcca517d27fdd02cfbd7573aae5e9131462f4a90b5757a79
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
991bc5d6756a376604f06c93edbb7445d3c40720509f92a9d1cdbd996d21c612
|
|
| MD5 |
b772607d79da22e7ff73edf52d984881
|
|
| BLAKE2b-256 |
40bf8f9ad50e1711a59f8082a4d7b7c50cc8001e03bdc75a72a1023bcc887237
|