About Portfolio MCP
Portfolio MCP is an MCP server in the Scraping category: a reusable Model Context Protocol server for exposing structured portfolio and professional information to AI assitants.
The repository has 1 stars and 0 forks.
Install
git clone https://github.com/Satsuj1n/portfolio-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (19)
calculate_allocation_driftCompare current vs target allocation from `~/.xp-mcp/allocation.json`. Returns drift %, BRL delta, and BUY/SELL suggestions per class.
Parameters not published.
calculate_mwrMoney-weighted return (MWR / IRR) via bisection over signed cash flows. Reports converged=false cleanly when no sign change. Requires ≥ 2 imports.
Parameters not published.
calculate_twrTime-weighted return (TWR) over XPerformance imports. Modified Dietz chained — GIPS-compliant for portfolios without daily NAV. Requires ≥ 2 imports.
Parameters not published.
get_advisor_profileRead the saved profile. Returns `exists: false` if not configured.
Parameters not published.
get_cash_flowsList cash flows with optional date/kind filters; returns aggregate totals (aporte/resgate/net) over all matching rows.
Parameters not published.
get_crypto_quoteSpot crypto quotes in BRL via Mercado Bitcoin. Per-ticker partial failure, 15-min cache, outbound-gated. Quote-only (not yet a tracked asset_class).
Parameters not published.
get_dividendsIncome / proventos
Parameters not published.
get_market_dataQuotes / fundamentals from brapi.dev for 1-50 tickers, SQLite-cached. Opt-in.
Parameters not published.
get_portfolio_summaryAggregate stats + declared-vs-computed reconciliation gap. Output now includes a `cash_flow_summary` block (YTD + rolling 12m aporte/resgate aggregates) when cash flows have been imported.
Parameters not published.
get_positionsList positions with quantity, market value, indexer, maturity. Optional class filter.
Parameters not published.
Show all 19 tools
get_transactionsHistory of buys/sells
Parameters not published.
import_bank_extract_pdfImport a PDF exported from XP's Conta Digital Extrato. Filters for investment-account transfers only (APORTE/RESGATE). Idempotent.
Parameters not published.
import_extract_csvParse a Posição Consolidada / Extrato CSV. Auto-detects delimiter and column aliases.
Parameters not published.
import_nota_corretagemParse broker-note PDFs for transaction history
Parameters not published.
import_xperformance_pdfParse XP's official portfolio PDF (XPerformance). Idempotent on re-import.
Parameters not published.
screen_assetsRank B3 FIIs / stocks / ETFs by DY, P/VP, P/L, ROE, market cap. Opt-in.
Parameters not published.
set_advisor_profileSave the advisor profile (risk, horizon, objective, exclusions, outbound gate, brapi token).
Parameters not published.
set_crypto_positionManually track a crypto holding (`CRIPTO` asset_class). Fetches a live quote, stores a snapshot market value (quantity × price). `quantity: 0` removes it. No cost basis / P&L. Outbound-gated.
Parameters not published.
suggest_buysSuggest BUYs per underweight class using profile objective × asset class matrix (FII/ACAO/ETF). Non-screenable classes (TESOURO/RF/FUNDO) reported in `skipped_classes`. Requires `outbound_enabled=true`.
Parameters not published.
Ask AI
Ask AI about Portfolio MCP
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.