
Borsa Istanbul (BIST) MCP server: licensed prices, OHLCV bars, financials, ratios and KAP filings
Borsa Istanbul (BIST) MCP server: licensed prices, OHLCV bars, financials, ratios and KAP filings for Claude, ChatGPT, Cursor and any MCP client
·
Licensed BIST market data in Claude, ChatGPT, Cursor, VS Code and any MCP client.
Prices, OHLCV bars, financial statements, ratios, KAP filings, indexes and backtests.
Website · Docs · Pricing · Türkçe
istfin is a licensed Borsa Istanbul data distributor. The istfin MCP server is a hosted remote server: there is nothing to install or run. Add the URL to your client, sign in (or pass an API key) and ask questions like "What did THYAO close at over the last 20 days?".
| Server URL | https://mcp.istfin.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with PKCE and dynamic client registration, or Authorization: Bearer istfin_live_... |
| Registry name | com.istfin/mcp (Official MCP Registry) |
| Coverage | 600+ BIST equities, BIST indexes, KAP disclosures |
| Freshness | Live prices on the Live plan, 15 minute delayed on the Basic plan |
| Requires | An istfin API subscription (pricing) |
istfin, remote MCP server URL https://mcp.istfin.com/mcpistfin, MCP server URL https://mcp.istfin.com/mcp, authentication OAuthCreate a key at api.istfin.com/hesap/anahtarlar and replace istfin_live_... below.
claude mcp add --transport http istfin https://mcp.istfin.com/mcp \
--header "Authorization: Bearer istfin_live_...".cursor/mcp.json or ~/.cursor/mcp.json){
"mcpServers": {
"istfin": {
"url": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." }
}
}
}.vscode/mcp.json){
"servers": {
"istfin": {
"type": "http",
"url": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." }
}
}
}~/.codeium/windsurf/mcp_config.json){
"mcpServers": {
"istfin": {
"serverUrl": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." }
}
}
}~/.gemini/settings.json){
"mcpServers": {
"istfin": {
"httpUrl": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." }
}
}
}opencode.json){
"$schema": "https://opencode.ai/config.json",
"mcp": {
"istfin": {
"type": "remote",
"url": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." },
"enabled": true
}
}
}~/.codex/config.toml)[mcp_servers.istfin]
url = "https://mcp.istfin.com/mcp"
http_headers = { "Authorization" = "Bearer istfin_live_..." }Any client that supports Streamable HTTP works. Most accept this shape:
{
"mcpServers": {
"istfin": {
"url": "https://mcp.istfin.com/mcp",
"headers": { "Authorization": "Bearer istfin_live_..." }
}
}
}Agent shortcut: in Claude Code, Cursor, Windsurf, OpenCode or Codex, paste this into the chat and the agent writes the config for you:
set up https://api.istfin.com/SKILL.md (my API key: istfin_live_...)To check it works, ask: "THYAO fiyatı ne?" (What is the THYAO price?). The client should call get_quotes.
22 tools: 20 read-only, 2 that write to your own istfin portfolio. The server never places orders and never moves money or shares.
| Tool | Scope | What it does |
|---|---|---|
search_symbols | market:read | Find a stock by name or ticker |
get_symbol | market:read | Identity, sector and index membership of one stock |
get_quotes | market:read | Prices for one or more stocks (live or 15 min delayed) |
get_movers | market:read | Top gainers, losers and volume leaders |
get_bars | market:read | OHLCV bars, 1 minute to monthly |
get_fundamentals | fundamentals:read | P/E, P/B, market cap and other summary ratios |
get_financial_statement | fundamentals:read | Balance sheet, income statement, cash flow |
get_ratio_series | fundamentals:read | Historical series of a ratio |
search_news | news:read | Search KAP (Public Disclosure Platform) filings |
get_news | news:read | Full text of one filing |
list_indexes | market:read | BIST indexes |
get_index | market:read | Index value and constituents |
list_sectors | market:read | Sectors and their members |
list_indicators | market:read | Technical indicators usable in strategies |
describe_indicator | market:read | Inputs, outputs and an example for one indicator |
run_strategy | market:read | Backtest a strategy on one or more stocks |
list_portfolios | portfolio:read | Your saved portfolios |
get_portfolio | portfolio:read | Positions, cost basis and P&L |
get_portfolio_performance | portfolio:read | Return, drawdown and benchmark comparison |
analyze_holdings | portfolio:read | Analyze a transaction list without saving it |
create_portfolio | portfolio:write | Create an empty portfolio |
add_portfolio_transactions | portfolio:write | Add buys, sells and dividends to a portfolio |
Read tools carry readOnlyHint. Every response has structured data (structuredContent), a short Turkish summary, source and asOf. KAP filing text is marked as untrusted content so clients do not treat it as instructions.
The server also exposes two resources (istfin://intervals, istfin://scopes) and two prompts (piyasa-brifingi, hisse-analizi).
Only tools/call counts against your quota. Most tools cost 1 request, get_bars costs 2 and run_strategy costs 10 per stock; see the docs for the full table. MCP and the REST API share the same daily and per-minute limits.
Without credentials the server returns 401 with WWW-Authenticate: Bearer resource_metadata="...", which OAuth-capable clients use to start sign-in. Quota errors come back as isError: true with structuredContent.code set to QUOTA_EXCEEDED or RATE_LIMITED.
The same data is available over REST with the same key:
curl https://api.istfin.com/v1/quotes?symbols=THYAO \
-H "Authorization: Bearer istfin_live_..."Guides for Python, Excel and Google Sheets.
Data is distributed under a Borsa Istanbul license. Personal use and your own team's internal tools are allowed. Redistributing data to third parties is subject to the Borsa Istanbul license; see the terms of use.
istfin MCP, Borsa İstanbul lisanslı verisini Claude, ChatGPT, Cursor, VS Code ve diğer MCP istemcilerine bağlayan uzak MCP sunucusudur. Kurulum yok: adresi ekleyin, istfin hesabınızla giriş yapın, sonra "THYAO son 20 günlük kapanışları ne?" diye sorun.
https://mcp.istfin.com/mcp (Streamable HTTP)Authorization: Bearer istfin_live_... başlığıget_bars 2, run_strategy hisse başına 10 istek sayılır.Claude.ai / Claude Desktop: Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle. Ad istfin, adres https://mcp.istfin.com/mcp. Bağlan deyip istfin sayfasında izin verin.
ChatGPT: Ayarlar > Uygulamalar ve bağlayıcılar > Gelişmiş ayarlar > Geliştirici modu. Oluştur: ad istfin, adres https://mcp.istfin.com/mcp, kimlik doğrulama OAuth.
Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, OpenCode, Codex: panelden anahtar üretin ve yukarıdaki yapılandırmalardan istemcinize uyanı kullanın. Ya da ajanınızın sohbetine şunu yazın:
set up https://api.istfin.com/SKILL.md (API anahtarım: istfin_live_...)Dokümantasyon: api.istfin.com/docs/mcp · Fiyatlar: api.istfin.com/fiyatlandirma · Destek: [email protected]
This repository holds documentation and client configuration examples only. The server itself is hosted by istfin and is not open source.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add istfin --transport http https://mcp.istfin.com/mcp{
"mcpServers": {
"istfin": {
"url": "https://mcp.istfin.com/mcp",
"headers": {
"Authorization": ""
}
}
}
}code --add-mcp '{"name":"istfin","url":"https://mcp.istfin.com/mcp","headers":{"Authorization":""}}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/istfin-mcp to learn what the "Istfin Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http istfin https://mcp.istfin.com/mcpThis server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/istfin-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "istfin-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.