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. 22 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 22 tools organized into the following categories. All tools are read-only and non-destructive.

Market Data

marketData
historicalData
transaction
depths
supplyDemandLastMinutes
globalMarket

Technical Analysis

technicalIndicator
priceStatistics
stockScreener

Financial Statements

financialStatements
financialRatios
companyInfos

News & Research

news
economicCalendar
corporateActions
publicOffering
kapData

Broker & Settlement

brokerActivity
brokerDefinitions

Forecasts & Portfolio

analystData
symbolSearchFlex
skills

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 22 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.