MCP

Připojte svého AI asistenta ke svému portfoliu

FinGather poskytuje server Model Context Protocol (MCP), který umožňuje AI asistentům — jako jsou Claude, ChatGPT nebo Cursor — přímo pracovat s daty vašeho portfolia. Dotazujte se na držené pozice, analyzujte výkonnost, vyhledávejte tickery, přidávejte transakce a generujte daňové přehledy — vše prostřednictvím přirozené konverzace.

Jak se připojit (3 kroky):

Vygenerujte API klíč v aplikaci FinGather (Nastavení → MCP API klíče)
Přidejte MCP server do konfigurace vašeho AI klienta s URL endpointu a Bearer token autentizací
Začněte se svého AI asistenta ptát na vaše portfolio

Typická konfigurace MCP klienta:

{
  "mcpServers": {
    "fingather": {
      "url": "https://www.fingather.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

`search_tickers`

Search for tickers by symbol or company name

Parametr	Typ	Povinný	Popis
`query`	`string`	Ano	Ticker symbol or company name to search for (e.g. "AAPL" or "Apple")
`limit`	`integer`	Ne	Maximum number of results (default 20, max 50) Výchozí: `20`

`get_ticker_fundamentals`

Get fundamental financial data for a ticker (PE ratio, market cap, margins, dividends, etc.)

Parametr	Typ	Povinný	Popis
`tickerId`	`integer`	Ano	Ticker ID (from search_tickers or list_assets)

`get_year_overview`

Get year-by-year performance comparison with interannual changes

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano

`get_tax_report`

Get realized gains, dividends, fees, and taxes for a given year

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano
`year`	`integer`	Ano

`get_dca_projections`

List DCA plans and their projected future values

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`horizonYears`	`integer`	Ne	Projection horizon in years (default 10, max 30) Výchozí: `10`

`get_portfolio_allocation`

Get portfolio allocation breakdown by sector, industry, country, or custom group

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`type`	`string`	Ano	Allocation type: sector, industry, country, group

`get_portfolio_history`

Get portfolio performance history over a time range (value, gain, return over time)

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`range`	`string`	Ano	Time range: SevenDays, OneMonth, ThreeMonths, SixMonths, YTD, OneYear, All

`get_dividend_data`

Get dividend income history and upcoming dividend calendar

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`range`	`string`	Ne	Time range for history: SevenDays, OneMonth, ThreeMonths, SixMonths, YTD, OneYear, All (default All) Výchozí: `All`

`list_strategies`

List portfolio allocation strategies with target percentages

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano

`get_rebalancing`

Get suggested buy/sell orders to rebalance a portfolio to its strategy target allocations

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`strategyId`	`integer`	Ano	Strategy ID (use list_strategies to find IDs)
`cashToInvest`	`string`	Ne	Additional cash to invest in portfolio currency (default "0")
`allowSelling`	`boolean`	Ne	Whether the suggestions may include sell orders (default false)

`list_goals`

List financial goals with current progress towards each target

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano

`list_transactions`

List transactions with optional filters for type, date range, and search text

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID
`limit`	`integer`	Ne	Maximum number of results (default 50, max 200) Výchozí: `50`
`offset`	`integer`	Ne	Pagination offset (default 0)
`search`	`null\|string`	Ne	Search text (matches ticker symbol or notes)
`actionType`	`null\|string`	Ne	Filter by type: Buy, Sell, Dividend, Tax, Fee, DividendTax
`dateFrom`	`null\|string`	Ne	Filter transactions on or after this date (YYYY-MM-DD)
`dateTo`	`null\|string`	Ne	Filter transactions on or before this date (YYYY-MM-DD)

`add_transaction`

Record a new buy, sell, dividend, or fee transaction

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano	Portfolio ID to add the transaction to
`assetId`	`integer`	Ano	Asset ID (use list_assets to find existing assets)
`actionType`	`string`	Ano	Transaction type: Buy, Sell, Dividend, Tax, Fee, DividendTax
`units`	`string`	Ano	Number of units (use negative for sells if needed, but prefer "Sell" type)
`price`	`string`	Ano	Price per unit in the given currency
`currency`	`string`	Ano	ISO 4217 currency code for the price (e.g. USD)
`date`	`string`	Ano	Transaction date (YYYY-MM-DD)
`fee`	`string`	Ne	Brokerage fee (default "0")
`feeCurrency`	`null\|string`	Ne	ISO 4217 currency code for the fee (defaults to transaction currency)
`tax`	`string`	Ne	Tax paid (default "0")
`taxCurrency`	`null\|string`	Ne	ISO 4217 currency code for the tax (defaults to transaction currency)
`notes`	`null\|string`	Ne	Optional notes

`list_portfolios`

List all portfolios for the user

`get_portfolio_summary`

Get current value, returns, and performance metrics for a portfolio

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano

`list_assets`

List all open holdings in a portfolio with performance data

Parametr	Typ	Povinný	Popis
`portfolioId`	`integer`	Ano

`get_asset_detail`

Get detailed performance data for a single holding

Parametr	Typ	Povinný	Popis
`assetId`	`integer`	Ano

`get_asset_history`

Get historical performance data for a single asset over a time range

Parametr	Typ	Povinný	Popis
`assetId`	`integer`	Ano	Asset ID (from list_assets)
`range`	`string`	Ano	Time range: SevenDays, OneMonth, ThreeMonths, SixMonths, YTD, OneYear, All