MCP App Store
by KeenEthics
Investminder icon

Investminder MCP Server for Claude and ChatGPT

By Investminder LLC

Overview

Investminder lets Claude do real investment research: screen stocks and ETFs, check the numbers behind them, build a strategy, backtest it against market history and track your portfolio. Available on every plan, including the free one. What you can ask Claude: - Find ideas: "Find profitable European companies that still look cheap." - Check a stock: "Is Nvidia in a strong trend or has it run too far?" - Check diversification: "How correlated are the S&P 500, gold and US Treasuries? Am I really diversified?" - Track your portfolio: "Connect my brokerage account and show my positions." - Go end to end: "Take the top 10 from that screen, build an equal-weight portfolio and backtest it since 2018." What's inside: - Research: search by name, ticker or ISIN, screen on profitability, valuation, growth, momentum and technical indicators, compare up to 20 assets in a correlation matrix, and pull price history, financials, dividends and valuation multiples. - Strategies: start from a ready-made strategy or build your own with buy and sell rules (RSI, moving averages, MACD, momentum), contributions, withdrawals and fees. - Backtests: test over any period against a benchmark, with returns, holdings and every transaction. - Portfolios: create a manual portfolio and record trades and cash, or sync a bank or brokerage account. Review positions, cash and transactions. - Sync: everything you create in Claude shows up in the web app, and saved screeners can be replayed from Claude. Getting started: add the connector, sign in and say "Get started with Investminder" for a guided tour. No account yet? Claude creates a free one in the conversation, after confirming your country and currency. 🔒 Claude can read market data and your saved work, manage strategy drafts, run backtests and record trades and cash in manual portfolios. Bank and brokerage connections are authorized with the provider, so Claude never sees your credentials. It never places trades and never moves money.

How to connect

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

Tools

addPortfolioCash

ChatGPT
Record cash in an owned, unlocked manual portfolio. Positive amount deposits, negative amount withdraws; zero is invalid. Amount and commission are in input.currency, not automatically converted to the portfolio currency (GBX means pence). The service updates the balance, creates a CASH_IN/CASH_OUT transaction and refreshes history. It can produce a negative balance. This adds an operation, not a replacement balance; retrying repeats it. No data is returned. Call listPortfolios with portfolioId and includeCashes=true to see stored balances, or listPortfolioTransactions for the generated transaction.

addPortfolioPosition

ChatGPT
Record a buy or sell in an owned, unlocked manual portfolio. Positive quantity buys or reinforces, negative quantity sells or closes; selling beyond holdings is rejected. Use a canonical ticker from searchSecurities; a custom/unrecognized ticker requires currency. A recognized security uses its stored currency. Price is per unit and commission is a fee in that currency (GBX means pence, not GBP). The operation updates cash, creates a market transaction timestamped now, and refreshes history. Cash may become negative. This adds a trade, not a replacement holding; retrying repeats it. No data is returned. Read listPortfolios with includePositions and includeCashes true to see the result, or listPortfolioTransactions for the generated transaction.

analyzeSecurities

ChatGPT
Retrieve detailed market data for a security by ticker symbol. Available to every authenticated connector identity, including one that has not created an Investminder profile yet, for QUOTES, PERFORMANCE, TECHNICAL_INDICATORS and VOLUME_PROFILE. FINANCIAL_STATEMENTS, DIVIDENDS and PER require an Investminder profile because its tier sets the available history. Pass 'language' as the language of the conversation: en, fr, es or de. If the conversation language is not supported, pass en. Use 'fields' to specify which data sections to retrieve (only those sections are fetched): QUOTES, PERFORMANCE, TECHNICAL_INDICATORS, FINANCIAL_STATEMENTS, DIVIDENDS, VOLUME_PROFILE, PER. Optional date range: startDate and endDate (default endDate: today). Two frequencies, each governing its own sections and each optional: 'quoteFrequency' (DAILY by default) for QUOTES and PER, 'statementFrequency' (YEARLY by default) for FINANCIAL_STATEMENTS. The other sections have a frequency of their own and ignore both. Ask for QUOTES and FINANCIAL_STATEMENTS in the same call and each is read at its own frequency. Every response carries 'earliestDate' and 'latestDate', the first and last known quote dates of the security - the range 'startDate' and 'endDate' can usefully span, and the as-of date of the data rather than the date of its computation. A ticker that Investminder does not cover returns 'found': false with a 'message' instead of data: it is not an analysis and must not be presented as one. Then look for an equivalent security with queries of your choice: searchSecurities by name, issuer, ISIN or the ticker without its exchange suffix, or screenSecurities by criteria such as asset class, sector, country or stock index - and retry with a ticker they return.

connectPortfolio

ChatGPT
Start a NEW brokerage/banking connection for the authenticated user, subject to their connection quota. Choose institutionId from listInstitutions. Returns a hosted authorization URL to open in the browser; the user completes authorization directly with the provider. Never ask for bank credentials in chat. The provider's existing webhooks then create and synchronize the portfolio; returning a URL does not mean a portfolio already exists. After completing authorization, call listPortfolios and optionally request positions/cashes. Existing provider defaults apply (Powens EUR, Snaptrade USD). This tool neither reconnects nor converts an existing manual portfolio, and repeated calls initiate new authorizations.

createPortfolio

ChatGPT
Create an empty manual portfolio for the authenticated user, subject to their account quota. Ask for the portfolio currency; it is a holding currency, not a billing currency. A duplicate name creates another portfolio with a numeric suffix: this is not idempotent. If a previous call's outcome is uncertain, inspect listPortfolios before retrying. Returns a compact portfolio summary. Then use addPortfolioCash and addPortfolioPosition to record cash and trades; use connectPortfolio instead for a synchronized brokerage.

createStrategy

ChatGPT
Create an investment strategy, in DRAFT status, ready to be backtested. 'definition' is always required: to start from a pre-built strategy, read it with listPreBuiltStrategies and send back its definition, adjusted or not. 'name' creates a new strategy, 'strategyId' starts a new draft on one of the strategies of the user instead (a strategy holds a single draft at a time). The 'definition' describes the strategy, every field is documented in the schema; the model drives the rest: a REBALANCED strategy fills percentTarget on its allocations (summing to 100) and leaves percentMax, sharesMax and valueAveraging null, a PROGRESSIVE one does the opposite, a RANKED one lists 2 to 50 candidate tickers with no weight, fills 'ranking' and leaves dca and valueAveraging null. Use searchSecurities, screenSecurities or listScreeners to pick the tickers of the allocations: a ticker no security is known under is rejected. 'constraints' restrict the strategy: optional for a PROGRESSIVE or RANKED strategy, required with the asset classes of its allocations for a REBALANCED one; the constraints of a pre-built strategy can be sent back as is. Returns the strategy and its draft; its strategyId feeds updateStrategy and startBacktest.

deleteStrategy

ChatGPT
Delete the draft of a strategy of the authenticated user, along with the backtests of that draft. The strategy itself is deleted only when the draft was the only version it had - which is the case for a strategy an agent created and never published; 'strategyDeleted' in the response says whether it happened. A published or archived strategy has no draft and cannot be deleted here, and neither can a locked one.

getCorrelationMatrix

ChatGPT
Calculate the Pearson correlation matrix between multiple securities over a date range. Requires between 2 and 20 tickers. Correlation is computed on daily returns. Tickers that Investminder does not cover are left out of the matrix and listed in 'unknownTickers': tell the user, and look for an equivalent security with searchSecurities or screenSecurities if needed. The call fails when fewer than 2 tickers are covered.

linkPortfolioStrategy

ChatGPT
Have an owned, unlocked portfolio follow a published, unlocked strategy of the authenticated user: the strategy is then tracked against the holdings of the portfolio and alerts are sent when it calls for a trade. Tracking and alerts run on a paid plan only, ESSENTIAL or higher: on the free BASIC plan the link is saved but no alert is sent until the account is upgraded. Publish the strategy with publishStrategy first. A portfolio follows a single strategy and a strategy is followed by a single portfolio: a portfolio already linked to another strategy, or a strategy already linked to another portfolio, is rejected; nothing is unlinked here. Calling it again with the same portfolio and strategy changes nothing. Returns the compact portfolio summary, with its strategyId. Schema version: 0.55.0.

listBacktests

ChatGPT
List backtests and read their results. 'type' selects the catalog: USER for the backtests of the authenticated user, PRE_BUILT for the reference backtests of a pre-built strategy. One of 'strategyId' or 'backtestId' is required, and they do not return the same thing: 'strategyId' gives the backtests of every version of that strategy with only the performance metrics of their results, 'backtestId' gives that one backtest with its results - which is how a backtest started with startBacktest is polled, until its status is COMPLETED (results available) or FAILED (see the error field). Results contain both the strategy performance and the benchmark performance. Optional 'fields' selects the parts of the results to return, and only applies when 'backtestId' is provided. Omitted, it returns a summary: the performance metrics. Ask for ANNUAL_RETURNS, HOLDINGS, TRANSACTIONS or DIVIDENDS only when the analysis needs the underlying series - holdings, transactions and dividends are daily and large. Backtests are listed newest first. The response is a page: 'items', plus 'total' (matches before paging), 'size' (default 10, max 50), 'hasMore' and 'nextCursor'. To read the next page, pass 'nextCursor' as 'after'.

listInstitutions

ChatGPT
List all supported stored financial institutions. Takes no parameters and returns the complete catalog, without filtering or pagination, including each institution's canonical ID, name and countries. Pass the selected ID to connectPortfolio.

listPortfolioTransactions

ChatGPT
Read stored transactions of an owned, unlocked portfolio, newest first, with stable datetime/ID ordering. Returns items, total matches, size, nextCursor and hasMore. Size defaults to 10, maximum 50. Omit after on the first call; pass nextCursor unchanged to get the next page with the same portfolio and filters. Optional minDatetime/maxDatetime are inclusive ISO local datetimes WITHOUT an offset, e.g. 2026-01-01T00:00:00, matching stored query semantics; returned datetimes retain their offsets. Amount and commission are in each transaction's currency, with direction given by type; there is no FX aggregation. This does not start synchronization or guarantee lifetime brokerage history: existing provider imports initially fetch up to 1000 entries starting 92 days back. An empty list does not prove the brokerage account has never had transactions.

listPortfolios

ChatGPT
Read all portfolios of the authenticated user, or one by portfolioId, as a complete list without pagination. Returns compact summaries by default. Set includePositions and/or includeCashes true for complete nested open holdings and currency balances. Closed positions are excluded. Unrequested collections are omitted; requested empty collections are []. Locked portfolios retain their summary but omit positions/cashes even when requested: this means restricted access, not zero holdings. Prices are per unit in the position currency, quantities are security units, cash amounts are balances in each currency, possibly negative; no FX conversion. Null prices mean unavailable, and tickerRecognized=false identifies a custom/unrecognized security. syncStatus contains only stored enabled/lastSync, not a live connection-session state. This never starts synchronization. For history, call listPortfolioTransactions separately.

listPreBuiltStrategies

ChatGPT
List the ready-made strategies of the catalog, the ones available for the account tier. The response is always a page: 'items', plus 'total' (matches before paging), 'offset', 'size' and 'hasMore'. Listing several strategies leaves their 'definition' null and keeps only their NAME and DESCRIPTION overviews, because the whole catalog in full does not fit in one response; ask for a single strategy with 'strategyId' to get its definition and all of its overviews - target, risk, reward, indicator, comment. Everything else - tier, classification, variants, constraints - is always returned. A strategy above the tier of the account is redacted by the server: it keeps its id, name and tier but carries no definition even when read alone, and no classification, so a classification filter never matches it. Optional 'approach', 'diversification', 'activity' and 'tier' filter the catalog. Optional 'size' (default 10, max 50) and 'offset' page through the matches. A pre-built strategy is read only: to backtest or tweak it, read it alone and pass its definition back to createStrategy.

listScreeners

ChatGPT
List the screeners saved by the authenticated user, with the criteria they filter on. Pass 'screenerId' to target a single screener, otherwise the screeners of the user are returned in alphabetical order. Criteria use the saved screener format: field, comparator and a string value. To use them in screenSecurities, convert comparator to operator and value to the type declared by its input schema. Use the resulting tickers in createStrategy. An empty criteria list cannot be replayed in screenSecurities. The response is a page: 'items', plus 'total', 'offset', 'size' (default 10, max 50) and 'hasMore'.

listUserStrategies

ChatGPT
List the investment strategies of the authenticated user, each with its editable draft. The response is always a page: 'items', plus 'total' (matches before paging), 'offset', 'size' and 'hasMore'. Listing several strategies leaves the 'definition' of their drafts null; ask for a single strategy with 'strategyId' to get the definition of its draft. A null 'draft' means the strategy has been published or archived: call createStrategy with its strategyId to start a new draft before updating or backtesting it. A locked strategy is read only until the account tier is upgraded, and never carries a draft. Optional 'size' (default 10, max 50) and 'offset' page through the strategies.

publishStrategy

ChatGPT
Publish the draft of a strategy of the authenticated user: the draft becomes the live version, starting today, the version a portfolio follows and alerts are sent for. Signals and alerts are available on a paid plan only, ESSENTIAL or higher: on the free BASIC plan the strategy is published but sends no signal until the account is upgraded. The previous live version, if any, is archived and its backtests are deleted. No backtest is required beforehand. The first publication of a strategy counts against the number of live strategies the plan allows; publishing a new draft of a strategy already live does not. Calling it again on a strategy already published, with no new draft, changes nothing and returns its live version. Returns the strategy with its live version and a null draft; call linkPortfolioStrategy next to have one of the portfolios of the user follow it. Schema version: 0.55.0.

screenSecurities

ChatGPT
Select securities with structured criteria, combined with AND. Each criterion has field, operator and value; the schema lists valid combinations. Example: [{"field":"assetClass","operator":"EQUALS","value":"STOCK"}, {"field":"roe","operator":"HIGHER_THAN","value":15}]. Use each field at most once; multiple thresholds on the same field are not supported. A stock can belong to several stockIndex values; a criterion selects constituents of that index. Catalog text values are matched ignoring case and separators. Available to every authenticated connector identity, including without an Investminder profile. For a name, ticker or ISIN, use searchSecurities. Pass the conversation language (en, fr, es, de), or en if unsupported. To replay a saved screener, read listScreeners and convert comparator to operator and its string values to the types declared by this schema. A result carries the identity of the security only: id, ticker, isin, name, assetClass and currency. Add 'fields' to get more - DESCRIPTION for the prose describing the company or the fund, PERFORMANCE for the metrics and the scores - and expect a much larger response. The response is a page: 'items', plus 'total' - how many securities match the criteria, not how many are returned - 'offset', 'size' (default 10, max 50) and 'hasMore'. A 'total' far above 'size' means the criteria are loose, and narrowing them beats paging through them.

searchSecurities

ChatGPT
Find securities by name, ticker or ISIN. Available to every authenticated connector identity, including one that has not created an Investminder profile yet. Pass 'language' as the language of the conversation: en, fr, es or de. If the conversation language is not supported, pass en. To select securities on their numbers instead - profitability, valuation, momentum, ... - use screenSecurities. A result carries the identity of the security only: id, ticker, isin, name, assetClass and currency. Add 'fields' to get more - DESCRIPTION for the prose describing the company or the fund, PERFORMANCE for the metrics and the scores - and expect a much larger response. Optional 'assetClass' filter: STOCK, ETF, FOREX. Optional 'size' (default 10, max 50) caps the number of results.

startBacktest

ChatGPT
Start a backtest of the draft of a strategy of the authenticated user, over a date range. The start date is moved forward automatically when quotes are not available for the whole range. 'inflowRules' is how money enters the strategy over the period; optional 'outflowRules' is how it is withdrawn, null for no withdrawal. The benchmark is read from the definition of the strategy. Pre-built strategies cannot be backtested directly: copy one with createStrategy, passing back the definition read with listPreBuiltStrategies, and backtest the copy. Backtests run asynchronously: this tool returns a backtest with the PENDING status, then poll listBacktests with type USER and the returned backtestId until the status is COMPLETED or FAILED.

startOnboarding

ChatGPT
Guided introduction to Investminder for a new user: presents the product and walks them through their first steps. Call it when the user greets you, asks what Investminder can do or how to get started, or when another tool reports that no account exists, then offer the onboarding to the user. It is optional: if the user declines or asks something else, answer that directly. Works without an account. Returns the onboarding script to follow, step by step, adapted to what the user has already done.

updateStrategy

ChatGPT
Update the draft of a strategy of the authenticated user: its definition and its constraints, both documented in the schema. The constraints are optional for a PROGRESSIVE or RANKED strategy and required with the asset classes of its allocations for a REBALANCED one. The definition replaces the previous one entirely, so send the complete definition on every call. A strategy that has been published has no draft anymore: call createStrategy with its strategyId to start a new one.

upsertUser

ChatGPT
Create the Investminder user and account of the authenticated identity, the one every other tool is scoped to, or update it. Call it when another tool reports that no account exists yet, or during the onboarding (startOnboarding). Creating requires 'country', 'currency' and 'language'; updating changes only the fields passed. Ask the user for their country and their currency instead of guessing - propose what fits the conversation and let them confirm; both are theirs to decide. 'country' is the ISO 3166-1 alpha-2 code of the country they live in. 'currency' is what they hold money in, not what they are billed in: subscriptions are charged in USD or EUR whatever this says. 'language' is the language of the conversation, and is what the emails of the account are sent in. Optional 'onboarding' holds the answers of the onboarding quiz. The response carries 'created', the saved 'onboarding' and 'recommendedStrategies', the pre-built strategies fitting the answers; the onboarding says what to do with them. Once it returns, every other tool works for this user.

addPortfolioCash

Claude

addPortfolioPosition

Claude

analyzeSecurities

Claude

connectPortfolio

Claude

createPortfolio

Claude

createStrategy

Claude

createUser

Claude

deleteStrategy

Claude

getCorrelationMatrix

Claude

linkPortfolioStrategy

Claude

listBacktests

Claude

listInstitutions

Claude

listPortfolioTransactions

Claude

listPortfolios

Claude

listPreBuiltStrategies

Claude

listScreeners

Claude

listUserStrategies

Claude

publishStrategy

Claude

screenSecurities

Claude

searchSecurities

Claude

startBacktest

Claude

startOnboarding

Claude

updateStrategy

Claude

upsertUser

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/investminder"><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/investminder)