# istfin

> istfin is a paid MCP server for finance and payments. Licensed Borsa Istanbul prices, statements and KAP filings for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://api.istfin.com/mcp
- **MCP Registry name:** com.istfin/mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Where many BIST connectors scrape public websites and break when those sites change, istfin says its server serves licensed exchange data from the same infrastructure as its REST API. Replies come with a short Turkish summary, the source and an as-of timestamp, and KAP filing text is marked as untrusted so the assistant does not treat it as instructions.

The tool set covers symbol search, quotes (live or 15 minutes delayed depending on plan), OHLCV bars from one minute to monthly, ratio series, financial statements, index constituents and sectors. It also includes a strategy backtester that runs technical-indicator rules over one or more stocks, plus portfolio tools. Of the 22 tools, 20 read data and 2 write to your istfin portfolio record, and only if you granted write permission on the connection.

It places no orders and moves no money. Claude.ai, Claude Desktop and ChatGPT connect through OAuth without a key; Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex and OpenCode use an API key. Tool calls count against the daily quota of an istfin API subscription; most cost 1 request, get_bars 2, and a backtest 10 per stock.

## Features

- **Prices and bars:** Quotes for one or many stocks, plus OHLCV bars from 1 minute to monthly.
- **Fundamentals and statements:** Valuation ratios, balance sheet, income statement and cash flow.
- **KAP filing search:** Searches company disclosures and returns the full text of one.
- **Strategy backtesting:** Tests indicator-based strategies on one or more stocks.
- **Portfolio tracking:** Lists portfolios, shows P&L and performance, and records trades.
- **OAuth or API key:** No key needed in Claude and ChatGPT; other clients use a key.

## Good for

- Build a daily BIST briefing with index moves and notable KAP filings
- Compare two companies on P/E, price-to-book and EBITDA margin
- Rank bank stocks by last-quarter net profit growth
- Backtest a technical-indicator rule on several stocks
- Check portfolio performance against a benchmark

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.istfin.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.istfin.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.istfin.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.istfin.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.istfin.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.istfin.com/mcp"
    }
  }
}
```

## Tools

- `search_symbols`: Searches stocks by name or code.
- `get_symbol`: Identity, sector and index info for a stock.
- `get_quotes`: Prices for one or more stocks, live or 15 minutes delayed.
- `get_movers`: Gainers, losers and volume leaders.
- `get_bars`: OHLCV bars from 1 minute to monthly.
- `get_fundamentals`: Summary ratios such as P/E, P/B and market cap.
- `get_financial_statement`: Balance sheet, income statement and cash flow.
- `get_ratio_series`: Historical series of a ratio.
- `search_news`: Searches KAP disclosures.
- `get_news`: Full text of one disclosure.
- `list_indexes`: Lists BIST indexes.
- `get_index`: Index value and constituents.
- `list_sectors`: Sector list and members.
- `list_indicators`: Technical indicators usable in strategy conditions.
- `describe_indicator`: Inputs, outputs and an example for an indicator.
- `run_strategy`: Backtests a strategy on one or more stocks.
- `list_portfolios`: Your saved portfolios.
- `get_portfolio`: Positions, cost and profit or loss.
- `get_portfolio_performance`: Portfolio return, drawdown and benchmark comparison.
- `analyze_holdings`: Analyzes a list of trades without saving it.
- `create_portfolio`: Creates a new empty portfolio.
- `add_portfolio_transactions`: Adds buys, sells and dividends to a portfolio.

## FAQ

### Can the assistant place trades?

No. The server sends no orders and moves no money; the only write is to your istfin portfolio record.

### Is MCP an extra charge?

No. It is included in the istfin API subscription and shares the REST API's daily quota.

### Is the data live?

Depends on plan: the Live plan has live prices and indexes, Basic has 15-minute delay; volume is delayed 15 minutes on both.

### Is the output investment advice?

No. The site says istfin provides data and the assistant's commentary is not investment advice.

### Is istfin free?

No. istfin is a paid product.

### How do I add istfin to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.istfin.com/mcp

### What are the best alternatives to istfin?

The closest alternatives to istfin are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/istfin
