ekonomikosesi-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ekonomikosesi-mcp
🇹🇷 Türkçesi: README.tr.md
Open-source Model Context Protocol (MCP) server for Ekonomi Köşesi — providing read-only, unauthenticated access to Turkish financial news, Borsa İstanbul (BIST) equities and KAP disclosures, TEFAS mutual funds, national newspaper front-page archives, and official platform status monitors.
Works in two ways:
Local
stdioserver (zero external dependencies, Node.js 18+) — bridges standardstdioMCP clients (such as Claude Desktop) to Ekonomi Köşesi.Direct Remote Streamable HTTP — connect directly to
https://ekonomikosesi.com/api/mcpwith no local install required.
Quick Start
Option A — Local stdio (Claude Desktop, Cursor, MCP Inspector, etc.)
Requires Node.js 18+. Run directly from GitHub via npx (no API key required):
{
"mcpServers": {
"ekonomikosesi": {
"command": "npx",
"args": ["-y", "github:beratyukselen/ekonomikosesi-mcp"]
}
}
}Or clone and run locally:
git clone https://github.com/beratyukselen/ekonomikosesi-mcp.git
cd ekonomikosesi-mcp
npm test
node bin/ekonomikosesi-mcp.jsOption B — Remote Streamable HTTP (No Local Process)
Clients that natively support Streamable HTTP can connect directly to https://ekonomikosesi.com/api/mcp:
Claude Code (.mcp.json):
{
"mcpServers": {
"ekonomikosesi": {
"type": "http",
"url": "https://ekonomikosesi.com/api/mcp"
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"ekonomikosesi": {
"url": "https://ekonomikosesi.com/api/mcp"
}
}
}Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"ekonomikosesi": {
"httpUrl": "https://ekonomikosesi.com/api/mcp"
}
}
}Codex (~/.codex/config.toml):
[mcp_servers.ekonomikosesi]
url = "https://ekonomikosesi.com/api/mcp"Related MCP server: Psagot remote MCP
Available Tools (26)
Finance & Markets (BIST & TEFAS)
Tool | Description |
| Search active BIST equities and TEFAS mutual funds by ticker/code or name. |
| Market overview of active BIST indices and top equity movers. |
| Stored latest price, daily change, and profile metadata for a BIST equity. |
| Historical daily closing prices for a BIST symbol ( |
| Company financial statements with reporting periods and units. |
| Recent KAP (Public Disclosure Platform) filings for a BIST symbol. |
| TEFAS fund profile, unit price, category, management fee, risk score, and asset allocation. |
| Historical daily unit prices for a TEFAS fund. |
| Periodic fund returns ( |
| Side-by-side comparison of 2–5 TEFAS funds over a matching period. |
| Top gaining or losing TEFAS funds by period and category. |
| Largest disclosed equity holdings of a fund. |
News & Editorial
Tool | Description |
| Ordered lead stories and headlines from Ekonomi Köşesi's live front page. |
| Newest published articles ordered from newest to oldest. |
| Keyword search across published articles. |
| Recent articles in a specific category ( |
| Active top-level news categories. |
| Full Markdown content, author, category, and canonical URL by numeric article ID. |
| Discovery search returning concise snippets and stable IDs for |
| Full canonical article text and metadata for an ID returned by |
Turkish Newspaper Front-Page Archives
Tool | Description |
| Available national newspapers, slugs, and earliest/latest archive dates. |
| Recorded newspaper front pages and source links for a given date ( |
| Full front-page image (returned inline as MCP |
Platform Status & Incidents
Tool | Description |
| Latest official status checks across major cloud, AI, and social platforms. |
| Detailed status, active incidents, and recent timeline for a single platform. |
| Filter reported service incidents by date range, platform, or active state. |
Agent Skills & Discovery
Public agent skills and usage policies are published at:
Skill index:
https://ekonomikosesi.com/.well-known/agent-skills/index.jsonDeveloper documentation:
https://ekonomikosesi.com/api/mcpAgent guidelines:
https://ekonomikosesi.com/AGENTS.md
Rate Limits & Data Policy
Read-only and free to use without authentication or API keys.
General budget: 120 requests/min per IP (search: 60/min, finance: 30/min, newspapers: 60/min, front-page image: 10/min).
Financial tools serve stored database records with explicit
data_dateandrecord_updated_attimestamps rather than real-time exchange ticks.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only crypto, equities, FX and commodities market data. No trading tools. API key required.
One API and MCP server for financial and economic data: markets, economics, companies and more.
Read-only market charts, OHLC, backtests and a view of your connected broker accounts
Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to financial market data including EOD, intraday, fundamentals, news, and more via 75 read-only MCP tools.5MIT
- FlicenseNot gradedqualityBmaintenanceEnables MCP clients to securely access read-only Psagot Trade account and market information through authenticated HTTP endpoints. It exposes only read-only tools, with no trade-submission capabilities.-
- AlicenseAqualityCmaintenanceEnables MCP-compatible applications to access Borsa Istanbul KAP disclosures and Yahoo Finance market data, including prices, financial statements, ratios, analyst estimates, and news.2524 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceProvides market data, analysis, chart drawing, read-only brokerage portfolio access, and simulated or paper trading through MCP clients, without real-money trade execution.115 npmMIT