MCP App Store
by KeenEthics
Bywell icon

Bywell MCP Server for Claude and ChatGPT

By Kunolu Applications Inc.

Overview

Bywell helps self-directed investors in the US and Canada understand what they own. This connector brings your Bywell account into Claude, so you can ask about your own portfolio in plain English. What you can do: - Get a rundown of your portfolio in one question: total value, accounts, largest positions and how concentrated you are. - See your holdings across every brokerage you've linked to Bywell (read-only through SnapTrade), with your allocation by account, currency and market. - Check and change your watchlists. - Set earnings reminders and price alerts on any stock, see them, and remove them. - Keep an investment journal: save notes and theses on a stock, update them, and read them back when the news changes. - Track savings goals and contribution room for TFSA, RRSP and FHSA (Canada) or IRA, 401(k) and HSA (US). - Take Bywell's investing course in Claude, lesson by lesson with quick checks, with progress shared with the Bywell app. Read-only access is available: connect with read-only access and Bywell refuses anything that would change your account. Bywell can't place trades, move money or see your brokerage password. Bywell gives general information and education, not investment advice, and never tells you to buy or sell. A free Bywell account is enough to connect. Linking brokerages, alerts on every stock and more watchlists are part of Bywell Pro.

How to connect

  1. Claude: Open the Bywell listing in the Claude connectors directory and choose Connect. Claude listing Bywell exposes 30 tools here.
  2. ChatGPT: Open the Bywell listing in the ChatGPT app directory and choose Connect. ChatGPT listing Bywell exposes 30 tools here.

Tools

add_to_watchlist

ChatGPT
Add one or more tickers to a watchlist. Creates the watchlist if it doesn't exist.

complete_lesson

ChatGPT
Mark a lesson the user has worked through as done, with whether they answered its check question correctly (correct; omit if it wasn't asked). The lesson has to have been opened with get_lesson. Counts toward Free's daily limit like the app, and shows as done in the app. Finishing it again changes nothing.

create_earnings_reminder

ChatGPT
Remind the user around earnings for the stocks they hold and watch (their plan's covered stocks): the week ahead, the evening before, the morning of, when results are out, or how the stock reacted. With a ticker, also makes sure that stock isn't muted. Delivered as push notifications by the Bywell app, in the user's own time zone; the response includes a delivery note.

create_goal

ChatGPT
Add a savings goal measured against the user's real holdings. Free includes one goal; the response says if the limit is hit. By default every linked account counts; narrow it with accountTypes (e.g. ['FHSA']) or accountNames (e.g. ['Joint TFSA']) when the goal is funded from specific accounts.

delete_note

ChatGPT
Permanently delete one of the user's notes (ids come from get_journal).

delete_price_alert

ChatGPT
Removes one of the user's price alerts by id (from list_alerts).

delete_reminder

ChatGPT
Delete an earnings reminder by id.

get_account

ChatGPT
The user's Bywell plan (free or pro) and what it includes, how much of this month's Bywell AI allowance is used, where they invest, their investing experience, what they mostly hold and what they want help with.

get_allocation

ChatGPT
Where the user's money sits, as the allocation strip on the app's Holdings screen shows it: by tax treatment of the account (tax-free, tax-deferred, taxable, deductible + tax-free), by currency, and by market (US, Canada, Other), each with value, share (0 to 1) and what's inside. Values are in the user's display currency unless currency is given. By currency and by market are part of Pro; on Free they're null and upgradeUrl is set.

get_contribution_room

ChatGPT
How much room is left this year in each tax-advantaged account: TFSA, RRSP and FHSA (Canada) or IRA, 401(k) and HSA (US). Room is what the user entered (from CRA My Account in Canada, the IRS limit in the US); contributions come from linked accounts this calendar year plus anything they added from elsewhere. room is null when they haven't entered it yet.

get_conversation

ChatGPT
One past Bywell AI chat in full: every question and answer, with the sources each answer cited. Read-only: chats can't be added to through this connector.

get_conversations

ChatGPT
The user's past Bywell AI research chats, newest first, each with a title, stock (or general) and a preview of the latest answer. ticker narrows to one stock; 'general' to chats not about one stock.

get_goals

ChatGPT
The user's savings goals (a first home, a safety net...) with progress, as the app shows them: current (linked holdings in the goal's currency plus cash saved elsewhere), target, pct, months left, monthly amount needed as plain arithmetic with no assumed returns, whether they're on a steady pace (onTrack), and which accounts count (accounts). Empty when they haven't set one.

get_holdings

ChatGPT
The user's current positions across connected brokerage accounts: brokerage, account and account type, market value in the trading currency and in the user's display currency (baseValue), cost basis (baseCost), and portfolio weight.

get_journal

ChatGPT
The user's own investment thesis (why they own it, what would make them sell, what they're watching, conviction, review date) and dated notes (with ids, and sources for saved research) for one stock, or with no ticker, every stock they've written about plus general notes.

get_learning_path

ChatGPT
Bywell's investing course in the user's country's wording, unit by unit, each lesson marked done, started or not started, with the next lesson to take (from where their path starts). On Free it also gives how many lessons they've finished today against the daily limit and how many are left; on Pro the limit is null. Progress is shared with the Bywell app. Use it whenever they ask to start, continue or resume their course or lessons.

get_lesson

ChatGPT
Open one lesson from Bywell's course, by lesson id (from get_learning_path) or by topic (e.g. 'EPS', 'guidance', 'concentration', 'TFSA'): its text, a check question with answer choices and the correct one, practice questions, and something to try. Opening doesn't mark it done; complete_lesson does. Free can start a few new lessons a day, the same as the app: past that it returns limitReached with upgradeUrl. Lessons already finished always open.

get_portfolio_summary

ChatGPT
A rundown of the user's account in one call. With a linked brokerage: total value, each account's value, how many positions, the five largest with their weights, how much of the total the top five make up, the split by tax treatment (and by currency and market on Pro), plus watchlist and reminder counts. With no brokerage linked: their watchlists, and where to link one. Values come from the user's brokerage and are in their display currency unless currency is given; no prices or news are added.

get_watchlists

ChatGPT
The user's watchlists and the tickers in each.

list_alerts

ChatGPT
The user's notification settings (preset, quiet hours, daily limit, each alert type) and their price alerts.

list_reminders

ChatGPT
The user's active earnings reminders.

mute_stock_alerts

ChatGPT
Mutes every alert about one stock for a number of days, until turned back on (days null), or unmutes it (days 0).

remove_from_watchlist

ChatGPT
Remove a ticker from every watchlist it's on.

save_note

ChatGPT
Add a dated note to the user's journal, about one stock or general (no ticker). kind 'buy' or 'sell' records the reasoning behind a trade; 'research' saves findings with their sources.

set_contribution_room

ChatGPT
Save the user's room for one tax-advantaged account this year (TFSA, RRSP, FHSA in Canada; IRA, 401(k), HSA in the US): the figure they read in CRA My Account or the IRS limit they're using, plus anything they contributed outside linked accounts (another brokerage, payroll). Bywell never asks for or stores tax documents; only the numbers the user gives. Saving again for the same account and year replaces the earlier figures. Returns the year's room for every account, as get_contribution_room does.

set_price_alert

ChatGPT
Alert the user when a stock goes above or below a price, or moves a percentage from today's price. Free checks against each day's close, for the stocks it covers; Pro checks every 5 minutes in market hours. Fires once unless repeat is true.

update_goal

ChatGPT
Change a savings goal (ids come from get_goals). Only the fields given change. Pass empty accountTypes and accountNames to count every linked account again; clearTargetDate removes the date.

update_note

ChatGPT
Replace the text of one of the user's notes (ids come from get_journal).

update_notification_settings

ChatGPT
Changes how much Bywell notifies the user. A preset (essentials, everything, quiet) replaces the alert types and daily limit; the other fields adjust one thing.

update_thesis

ChatGPT
Write or update the user's thesis for one stock. Only the fields given change.

add_to_watchlist

Claude

complete_lesson

Claude

create_earnings_reminder

Claude

create_goal

Claude

delete_note

Claude

delete_price_alert

Claude

delete_reminder

Claude

get_account

Claude

get_allocation

Claude

get_contribution_room

Claude

get_conversation

Claude

get_conversations

Claude

get_goals

Claude

get_holdings

Claude

get_journal

Claude

get_learning_path

Claude

get_lesson

Claude

get_portfolio_summary

Claude

get_watchlists

Claude

list_alerts

Claude

list_reminders

Claude

mute_stock_alerts

Claude

remove_from_watchlist

Claude

save_note

Claude

set_contribution_room

Claude

set_price_alert

Claude

update_goal

Claude

update_note

Claude

update_notification_settings

Claude

update_thesis

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/bywell"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/bywell)