ForInvest MCP Server

Access real-time and historical financial data for BIST (Borsa İstanbul) and global markets directly from Claude, Cursor, and any MCP-compatible AI application. 60 tools covering market data, financials, technical analysis, news, broker data, and more.

A ForInvest account is required. Create a free account →

Quick Start

Connect to ForInvest MCP Server using the following URL with any MCP-compatible client:

https://mcp.forinvest.com/mcp

Transport

Property	Value
Protocol	MCP (Model Context Protocol)
Transport	StreamableHTTP
Endpoint	`https://mcp.forinvest.com/mcp`
Authentication	OAuth 2.0 + PKCE
Session TTL	30 minutes (auto-renewed)

Authentication

ForInvest MCP Server uses OAuth 2.0 Authorization Code flow with PKCE (RFC 7636). Most MCP clients handle this automatically — you just enter your ForInvest username and password when prompted.

OAuth 2.0 Flow

Client discovers endpoints via /.well-known/oauth-authorization-server
Client registers dynamically via /oauth/register (RFC 7591)
Client redirects to /authorize with PKCE code challenge (S256)
User authenticates with ForInvest credentials on the login page
Authorization code returned to client redirect URI
Client exchanges code + code_verifier at /oauth/token
Server returns access token (Bearer) valid for 1 hour

You don't need to implement OAuth manually. MCP clients like Claude Desktop and Cursor handle the entire flow — just click “Connect” and enter your credentials.

Claude Desktop Setup

Open Claude Desktop → Settings
Go to Connectors → click Add custom connector
Enter name: ForInvest MCP and URL: https://mcp.forinvest.com/mcp
Click Connect — a browser window opens for authentication
Enter your ForInvest username and password
Done! Ask Claude any financial question and it will use ForInvest tools

Claude Code Setup

Add ForInvest MCP Server with a single terminal command:

claude mcp add forinvest --transport http https://mcp.forinvest.com/mcp

Cursor Setup

Open Cursor → Settings → MCP
Click Add new MCP server
Select type: StreamableHTTP
Enter URL: https://mcp.forinvest.com/mcp
Authenticate with your ForInvest credentials when prompted

JSON Configuration

For any MCP client that supports JSON configuration:

{
  "mcpServers": {
    "forinvest": {
      "url": "https://mcp.forinvest.com/mcp"
    }
  }
}

Tool Reference

ForInvest MCP Server provides 60 tools organized into the following categories. All tools are read-only and non-destructive.

Market Data

Real-Time Market Data
Historical Data (Date Range)
Historical Data (Last N)
Intraday Data
Latest Tick Data
Order Book Depth
Supply & Demand
Liquidity Data
Change Statistics
Market Statistics

Technical Analysis

Indicator (Date Range)
Indicator (Last N)
Price Analysis
Heat Map
Price Chart
Technical Chart
Stock Screener

Financial Statements

Balance Sheets
Income Statements
Cash Flow Statements
Last Quarter Ratios
Quarter Ratio Multi
Fundamental Analysis
Statement Dates

News & Research

Market News
Stock Analysis
Economic Calendar
Market Holidays

Broker & Settlement

Settlement at Date
Latest Settlement
Settlement Ratio Top/Bottom
Short Sales Aggregate
Investor Distribution
Transaction Data
Broker Definitions

Forecasts & Portfolio

Forecast Averages
Forecast by Broker/Symbol
Forecast History
Portfolio Averages
Portfolio by Broker/Symbol
Portfolio Updates

Privacy & Security

All data in transit encrypted with TLS 1.2+
OAuth 2.0 + PKCE (S256) for secure authentication
Bearer tokens never logged or persisted to disk
All 60 tools are read-only — no destructive operations
Session data auto-deleted after 30 minutes of inactivity

See our full Privacy Policy and KVKK Aydınlatma Metni for details.