brokerlink
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.
brokerlink is a free, open-source Chrome extension and local MCP server that lets Claude, Codex, Gemini and other AI tools read your own PhillipCapital MobilG brokerage account through your logged-in browser tab.
Unofficial. Not affiliated with, endorsed by or supported by PhillipCapital. For your own account only, at your own risk. Not investment advice.
Screenshots
Sample data, not a real account.
Portfolio | Charts with indicators |
Depth ladder and last trades | Cumulative depth chart |
Orders waiting for approval | Send without approval | Order history |
A part-by-part tour is in the documentation.
Related MCP server: coinvest-mcp
Popup features
Tab | What you get |
Portföy (portfolio) | Positions with quantity, cost, last price, today's change, and profit/loss in TL and percent. The P/L pair is framed in a colour that runs from red (−15 % or worse) to green (+15 % or better). Totals, share value, cash (T / T+2) |
Derinlik (depth) | Per position: best bid and ask, spread, where the price sits between today's floor and ceiling. Kademeler: up to ten bid/ask levels with quantity bars, buy/sell balance and the last trades. Derinlik grafiği: cumulative depth curve. Levels need a depth licence on your account; without one the card says so |
Grafik (charts) | Candle, line or area charts of your positions from MobilG's own chart feed. Eleven periods: 1 hour, 1 day, 3 days, 1 week, 2 weeks, 1, 2, 3 and 6 months, YTD, 1 year. Nine indicators: MA 7 / 25 / 99, EMA 20, Bollinger Bands, VWAP, volume, RSI 14, MACD (up to five at once) |
Emirler (orders) | Orders queued by an AI with Onayla / Reddet, the orders on/off switch, and the "send without approval" card with your own limits |
Geçmiş (history) | Every order that passed through the extension with MobilG's answer, eight per page |
Version label | Opens the release notes; an update banner appears when a newer version exists |
Also: a button that opens MobilG when you are not logged in, desktop notifications with the broker's answer for every order, and nothing loaded from third parties (charts are drawn locally).
How it works
AI client ──stdio MCP──▶ brokerlink.py mcp ──HTTP──▶ brokerlink.py serve (127.0.0.1:18890)
▲ long-poll
Chrome extension ──executeScript──▶ your logged-in MobilG tab
fetch('/api/...') with the tab's own sessionNothing to configure after login. Each call reads the session inside your MobilG tab at call time, so the bridge works as soon as you are logged in and stops when you log out. No token export, no sync button.
The session never leaves the tab. The daemon, the MCP server and the AI never see your account number, password or session token.
It never opens or reloads MobilG. A reload makes MobilG end the session, so brokerlink only uses the tab you already have open.
Double allowlist. Every call is checked against
extension/catalog.jsonin the daemon and again in the extension.Raw responses are kept locally in
data/raw.sqlitewith session fields redacted.
What you can ask for
Area | Catalog names |
Portfolio and cash |
|
Trades and orders (read) |
|
Market data |
|
News and research |
|
VIOP, funds, IPO, foreign, FX, T+0 |
|
Safe writes | follow lists and price alarms |
Orders | new, cancel, amend: queued for your click, see below |
The extension popup shows the same data without an AI client: see Popup features.
Never included: money-out and asset-transfer endpoints (EFT, transfers, FX conversion, collateral), login, password and settings, and the broker's AI-authorization switches. They are on a deny list.
Orders
The popup is in Turkish (the broker's market): Portföy = portfolio, Derinlik = depth, Grafik = charts, Emirler = orders, Geçmiş = history, Onayla / Reddet = approve / reject, Emirler açık = orders enabled, Onaysız gönderim = send without approval.
On by default, with a switch in the extension popup ("Emirler açık") to turn them off. An order from an AI is only queued: nothing is sent until you click Onayla (approve) in the popup. The per-order and daily limits you set in the popup (defaults 2,500 TL and 10,000 TL) are checked first. An AI agent cannot approve and cannot flip the switches: they live in the browser.
Auto-send ("Onaysız gönderim")
A separate card in the popup's Emirler tab, off by default. While it is on, limit orders, amendments and cancels below your limits are sent without asking; the reply to place_order is then MobilG's answer. Market orders and anything above the limits still wait for your click. You set the three values yourself: limit per order (default 2,500 TL), limit per day (default 10,000 TL) and how long it stays on (default 4 hours). It also ends when the browser restarts, and asks for confirmation when switched on. Only the popup can change these; no tool or daemon call can.
Be aware of what this means: an AI agent that misreads you, or that is steered by text it reads elsewhere (a news item, a web page), can trade real money within those limits.
History and notifications
Every order that passes through the extension gets a notification with MobilG's answer, and a line in the popup's Geçmiş tab: sent with your approval, sent without approval, rejected by you, or refused by MobilG.
Placing an order, step by step
Order tools are experimental: the request shapes come from real MobilG traffic, but test with one lot and a far-away limit price first.
Check the switch. Open the extension popup; in the Emirler tab "Emirler açık" must be ticked.
Find the instrument.
read("stock_list", {"type": "dashboard", "shortSell": "0"})→ takesid(the numericsymbolId) and the code with its suffix, e.g.GARAN.E.Look at the price.
read("price_info", {"symbolId": "<sid>", "symbol": "GARAN", "market": "Hisse", "buyCell": "A", "detail": "1"})gives bid, ask, floor and ceiling;read("depth", {"symbolId": "<sid>"})gives the order book.Queue the order.
place_order(symbolId="<sid>", stock="GARAN.E", side="buy", quantity=1, price=134.20). Optional:type=limit(default) ormarket,tif=day(default) orioc. The call waits (50 s by default) for what happens next.Approve in the browser. A notification appears; open the popup, read the preview and click Onayla (approve) or Reddet (reject) in the Emirler tab.
The AI gets the outcome. The reply tells the model exactly what happened:
outcomeMeaning
sent_to_brokerApproved (or auto-sent) and accepted by MobilG; includes
broker_order_idandbroker_messagerejected_by_userYou clicked Reddet
refused_by_brokerSent, but MobilG refused it;
broker_messagesays whyawaiting_user_approvalYou have not clicked yet; the model asks again with
order_result(id)orders_switched_off,not_sent,not_queuedSwitch off, no MobilG tab or update needed, or refused by the limits
Follow it.
read("order_tracking")lists today's orders with their ids and status.
To change or cancel a working order, take its id from order_tracking:
amend_order(orderId, oldPrice, oldAmount, newPrice, newAmount)cancel_order(orderId)
Both are queued and need the same click in the popup.
Refusal | Meaning |
| The popup switch is off |
| Above the limits set in the popup (defaults 2,500 TL per order, 10,000 TL per day) |
| No logged-in MobilG tab |
| Popup → Update |
Example prompt for any AI client: "With brokerlink, find the symbolId of GARAN, show me bid/ask, then queue a limit buy of 1 lot at 134.20 and tell me when it is waiting for my approval."
Quick start
git clone https://github.com/nsozturk/brokerlink.git && cd brokerlink
pip install -r requirements.txt # Python 3.10+
python3 server/brokerlink.py serveLoad the extension:
Chrome / Edge / Brave:
chrome://extensions→ Developer mode → Load unpacked → theextension/folder.Firefox 121+:
python3 scripts/package.py, thenabout:debugging#/runtime/this-firefox→ Load Temporary Add-on →dist/brokerlink-firefox-<version>.xpi. Open the popup once and click İzin ver to grant site access (Firefox asks; Chrome grants at install).
Open https://mobilg.phillip.com.tr and log in as usual.
Register the MCP server (stdio command:
python3 /path/to/brokerlink/server/brokerlink.py mcp):
Client | How |
Claude Code |
|
Codex |
|
Antigravity (eski adıyla Gemini CLI) |
|
OpenCode |
|
Cursor, Claude Desktop, others | the same stdio command in their MCP settings |
MCP tools
Tool | Purpose |
| List every endpoint with its parameters, plus the order switches, limits and where the user changes them |
| Call a read endpoint by catalog name |
| Follow-list and price-alarm changes |
| Queue an order action for human approval |
Date formats follow MobilG and differ per endpoint; each catalog entry says which.
Updates
The daemon checks origin/main once every 3 hours (git fetch, nothing else leaves your machine). The popup shows what is new and an Update button that pulls and reloads the extension. A release can set min_supported; older builds then stop working until updated.
Packages
Each release carries ready-made files, built by python3 scripts/package.py:
File | Use |
| Unzip, then Load unpacked in Chrome, Edge or Brave. This is the route that works everywhere |
| Signed Chrome package. Chrome on Windows and macOS refuses CRX files that are not from the Web Store, so use it on Linux or with an enterprise policy |
| Firefox: temporary add-on in any edition; permanent install only in Developer Edition, Nightly or ESR with |
The one-click Update button needs a git clone. With a packaged install, update by installing the next release. You still need the daemon from this repository.
Run the daemon at login (optional)
macOS: save this as ~/Library/LaunchAgents/dev.brokerlink.plist (fix the two paths), then launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/dev.brokerlink.plist. KeepAlive also lets the Update button restart the daemon.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
<key>Label</key><string>dev.brokerlink</string>
<key>ProgramArguments</key><array><string>/usr/bin/python3</string><string>/path/to/brokerlink/server/brokerlink.py</string><string>serve</string></array>
<key>RunAtLoad</key><true/><key>KeepAlive</key><true/>
</dict></plist>Linux: run python3 server/brokerlink.py serve from a systemd user unit with Restart=always.
Troubleshooting
Symptom | Cause and fix |
| Start |
| No logged-in MobilG tab in this browser profile. The popup's Portföy tab has a button that opens it |
| The session ended (often after a page reload). Log in again |
| Popup → Update |
Tool says orders are disabled but the switch is on | Your AI client holds an old MCP process; restart the client |
| Market closed, or your account has no depth licence |
| It only covers foreign stocks |
Update button fails | The folder must be a git clone with |
Privacy and data
Leaves your machine: calls to MobilG from your own tab, and one
git fetchevery 3 hours. Nothing else; no analytics.Stays on your machine:
data/raw.sqlite(responses with session fields redacted) andlogs/. Both are git-ignored. Delete them any time.Uninstall: remove the extension, stop the daemon, delete the folder and the MCP entry in your client.
Repository layout
Path | What |
| Chrome extension (MV3): |
|
|
|
|
| Guard tests: allowlist, deny list, order switch and caps |
| Endpoint map parsed from MobilG's web app and order request shapes |
| Documentation site (single HTML file) and |
FAQ
Do I have to copy tokens or cookies after logging in?
No. The extension reads the session inside the MobilG tab at the moment of each call.
Can an AI place trades with this?
An agent can only queue an order; a person must click Onayla (approve) in the popup. The exception is auto-send, which you switch on yourself.
Can it withdraw or transfer money?
No. Those endpoints are on a deny list in both the daemon and the extension.
Does it work with claude.ai or ChatGPT in the browser?
No. Cloud chat apps cannot reach a server on your localhost. Use a local client such as Claude Code, Codex, Antigravity (eski adıyla Gemini CLI), OpenCode, Cursor or Claude Desktop.
Why does MobilG log me out when I reload the page?
MobilG ties the session to the page instance. brokerlink never reloads the tab for this reason.
Compared with
Phillip Intelligence (PhillipCapital's official MCP): official and supports orders with approval cards, but connects only from claude.ai and ChatGPT. brokerlink is an unofficial, read-first bridge for local AI clients.
Exporting a HAR or cookies by hand: brokerlink needs no export and keeps the session in the browser.
For AI agents
See AGENTS.md for the rules of this repo, GLOBAL_AGENT_RULE.md for a snippet to paste into your own assistant, and llms.txt.
Contributing and security
See CONTRIBUTING.md, SECURITY.md and CHANGELOG.md.
License
MIT. Trademarks belong to their owners.
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
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Build and backtest investing strategies from your AI assistant. Remote MCP with OAuth sign-in.
JW3.ai remote MCP server for market reads and confirm-gated trading execution.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP proxy server that enriches Longbridge's financial API with UI-enhanced tools. It transforms JSON responses into interactive dashboards such as stock cards, candlestick charts, and portfolio views for any MCP host.-
- AlicenseNot gradedqualityDmaintenanceLocal MCP server that exposes Liquid Co-Invest's trading data and order tools to a local LLM via a thin proxy.MIT

@luxalgo/broker-mcpofficial
AlicenseAqualityBmaintenanceA local MCP server that gives AI agents read-only access to real brokerage accounts across 16 brokers and exchanges, while keeping API keys on the user's machine. It enables portfolio overviews, positions, trade history, and performance statistics through natural-language queries.61MIT- AlicenseBqualityBmaintenanceEnables Claude and other MCP clients to read your own brokerage portfolio, balances, PnL, order status and market data, and — only after opt-in — preview and confirm orders, closes, cancels and watchlist changes with cost checks and human approval. Runs read-only against the demo environment by default, with hard exposure caps, rate limits and local key storage.24MIT