Unlok MCP

Connect AI assistants to markets research, your portfolio, and trading

Overview

Unlok MCP is a Model Context Protocol (MCP) server that lets AI assistants — such as Claude and ChatGPT — access Unlok on your behalf. Ask about stock quotes, review your holdings, check market news, preview trades, and place orders through natural conversation.

You connect once through OAuth. Your AI app never sees your Unlok password.

What you can do

Server URL: Use https://mcp.unlok.com/mcp when adding this MCP to your AI app. Do not use the root URL (https://mcp.unlok.com) as the MCP endpoint.

Setup

Add Unlok as a remote MCP connector in your AI app. The connector discovers OAuth automatically and will open a browser window for you to sign in and approve access.

1

Add a custom connector

In Claude (claude.ai), go to Settings → Connectors and add a new custom connector.

2

Enter the MCP URL

Set the server URL to:

https://mcp.unlok.com/mcp
3

Connect and authorize

Click Connect. Claude opens your browser to sign in at Unlok and approve the requested permissions. After authorization, portfolio and trading tools become available in chat.

1

Enable MCP Apps

In ChatGPT, add an MCP app or connector (availability depends on your plan and region). Use the remote MCP server option when available.

2

Enter the MCP URL

https://mcp.unlok.com/mcp
3

Authorize Unlok

Complete the OAuth sign-in flow when prompted. Chart and holdings tools render as interactive widgets in ChatGPT when supported.

Need an account? Sign up at https://join.unlok.com before connecting. Markets tools work without an account; portfolio and trading require a linked Unlok account.

Authentication

Unlok MCP uses OAuth 2.1. Your AI app obtains an access token after you approve access in your browser. The token is sent automatically on each request — you never paste credentials into chat.

Permissions (scopes)

Scope What it allows
(none) Markets research tools — quotes, charts, news, market overview
account:read View portfolio, holdings, balances, orders, and account activity
orders:read Preview orders, check tradability, and read order rules
orders:write Place, cancel, modify, and close orders (always requires your explicit confirmation in chat)
offline_access Refresh tokens so your connection stays active between sessions
Trading safety: Order placement and other write actions require confirmed: true in the tool call. Your AI assistant should always show you a preview and ask for approval before executing any trade.

Tools

Once connected, your AI assistant can call these tools. You can also ask it to run the help tool for a live list of available actions.

Markets No login

Tool Description
analyze_marketQuote, fundamentals, and rating for a single symbol
show_chartPrice chart with OHLCV data (1D, 5D, 1M, 3M, 6M, YTD, 1Y, 5Y)
show_market_overviewMarket sentiment, sectors, and top movers
get_market_positioning_pulseCompact market pulse snapshot
analyze_markets_batchBatch quotes for up to 20 symbols
compare_assetsSide-by-side comparison of 2–10 symbols
browse_marketsSearch stocks or browse crypto, forex, indices, commodities
get_market_newsLatest news from the intelligence feed

Portfolio Login required

Tool Description
get_holdingsPrimary holdings view — positions, weights, and P&L
list_accountsAll linked accounts (paper and live)
get_account_overviewBalances, margin, positions, and P&L summary
get_portfolio_summaryPortfolio-level aggregates
get_portfolio_allocationSector and industry weights
get_portfolio_heatmapHoldings treemap by value and day change
show_portfolio_chartPortfolio NAV history
get_open_ordersResting orders
get_tradesRecent fills
get_account_activityCash activity
get_portfolio_newsNews for symbols you hold
paper_trading_statusWhether paper or live trading is active
show_depositDeposit instructions and link to the Unlok app

Trading Confirmation required

Recommended flow: get_order_rules → preview_order → confirm with you → place_order

Tool Description
get_order_rulesValid trading sessions and time-in-force options
check_tradabilityCheck whether symbols can be traded
preview_orderFee estimate and order preview before placement
place_orderSubmit a buy or sell order (requires your approval)
close_positionClose a single position
close_positions_batchClose multiple or all positions
cancel_orderCancel a resting order
modify_orderChange quantity or price on an open order
reconnectShow in-app sign-in prompt when your session has expired

Troubleshooting

Connection or authentication errors

Portfolio tools not working

Trading issues

Verify the server is reachable

Expected response: {"status":"ok","service":"unlok-mcp"}

OAuth discovery metadata used by connectors during setup.

Support

Privacy: Unlok MCP never asks for your password in chat. Authentication always happens through the official OAuth flow in your browser.

Technical reference

For integrators and advanced debugging.

Endpoints

GET / — this documentation page
GET /health — liveness check
GET /status — health with environment and build info
GET /.well-known/oauth-protected-resource — OAuth Protected Resource Metadata (RFC 9728)
POST /mcp — MCP JSON-RPC (initialize and tool calls)
GET /mcp — SSE stream (requires Mcp-Session-Id header)

Protocol

Unlok MCP implements the Model Context Protocol over Streamable HTTP. Connectors discover OAuth via Protected Resource Metadata, authorize against https://api.unlok.com, and send Bearer tokens on every /mcp request.