Stock Compass

Read and record your own watchlist, holdings, trades, rule-based signals and price alerts for HK, US and China A-share stocks. Records only; never places orders.

Server MCP Terhosting

npx add-mcp 'https://stock-compass.app/api/mcp'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Use Stock Compass from your AI

Copy the line below into the AI you use (Claude, ChatGPT, Claude Code, Cursor…). It reads our setup guide and walks you through installing the connector, signing up and getting started.

Set me up with Stock Compass: open https://stock-compass.app/ai/setup.md and follow it step by step to install it, sign me up and get me started.

Your AI reads this guide: stock-compass.app/ai/setup.md

Before you start, check two things

  1. Stock Compass Pro. New accounts can try it free for 14 days, with no card and no automatic charge. With ChatGPT, start it on the site first (ChatGPT’s approval page cannot start one).
  2. Your AI app can add a custom MCP server (also called a custom connector):
    • Claude: Free, Pro, Max, Ultra, Team and Enterprise all can. Free allows one; on Team and Enterprise an owner adds it for the organization first.
      • ChatGPT: On the web only. Business, Enterprise and Edu can, and on Business only admins and owners. A personal Pro account can read only, so recording trades or changing stops is not available. Other plans are not listed by OpenAI.
      • Claude Code, Cursor and others: Can add a remote MCP server; where OAuth is not supported, use an API key.

Plan rules are the two companies' to set; checked 2026-10-31 against their help pages: Claude · ChatGPT

Your AI cannot open links? The steps by hand

Claude Code

  1. Run the two commands below in a terminal.
    claude plugin marketplace add Stock-Compass/stock-compass-plugin
    claude plugin install stock-compass@stock-compass
    
  2. In Claude Code, type /reload-plugins, then /mcp, and pick plugin:stock-compass:stock-compass.
  3. Sign in and approve in the browser that opens.

Claude (web, desktop app, Cowork)

  1. Customize → Plugins → Add → Add marketplace, enter Stock-Compass/stock-compass-plugin, and install Stock Compass.
  2. Open the plugin's Connectors tab, press Connect, then sign in and approve in the browser.
  3. Without the plugin: Customize → Connectors → Add → Add custom connector, with the address https://stock-compass.app/api/mcp.

ChatGPT

  1. Start Pro or the free trial on the site first.
  2. Open chatgpt.com/plugins, press +, then Add custom MCP server. Name: Stock Compass. URL: https://stock-compass.app/api/mcp. Authentication: OAuth, with client ID and secret left empty.
  3. Tick the risk notice, press Create as a plugin, then sign in and approve in the browser.
  4. Start a new chat, type @ and pick Stock Compass.

Other MCP clients

  1. Add a remote MCP server: address https://stock-compass.app/api/mcp, transport Streamable HTTP, authentication OAuth.
  2. Without OAuth: create an API key in Settings → AI apps & API and send it as the header Authorization: Bearer sc_….

Connected apps and API keys are under Settings → AI apps & API, where you can disconnect them at any time: Open settings

Once connected, ask your AI to "show my watchlist". A new account's watchlist is empty, so an empty list means it is connected.

What your AI can do once connected

Read

  • Your watchlist and holdings, with stops and targets
  • Your strategies and their rules, and the buy, add, trim and exit signals they recorded
  • Your trades, journal stats (by rules / by gut feel) and price alerts
  • Cash per market, dividends, and the changes made through AI apps or the API

Change, if you allow it

  • Add or remove watchlist stocks
  • Record buys and sells (fees from your settings, written into your journal)
  • Correct or delete a trade recorded by mistake
  • Change stops and targets, set price alerts

It only keeps records; it never places an order with a broker. Our rule for the AI: before any change, say exactly what will change and wait for you to agree. It can also explain every feature and help you turn your stock-picking and stop-loss rules into a strategy. With an API key, the REST API also records dividends, sets cash balances, records trades in batches, compares holdings with a broker's and exports every record.

Security and privacy

  • You sign in and approve on stock-compass.app. You never give the AI your password or a key.
  • Read only by default; you tick "Make changes" to allow writes.
  • Disconnect at any time in Settings → AI apps & API, and it stops at once.
  • Tokens and keys are stored only as hashes, and every change made through a connection is logged in Settings.

For developers

MCP address

https://stock-compass.app/api/mcp

Plugin and skill

github.com/Stock-Compass/stock-compass-plugin

REST API and API keys

github.com/Stock-Compass/stock-compass-plugin/blob/main/skills/stock-compass/references/api.md

OpenAPI 3.1 (imports into Postman and the like)

stock-compass.app/api/v1/openapi.json

Service status (checked every five minutes)

stats.uptimerobot.com/Vl3KwcrPoi

REST in three lines

# Create a key in Settings → AI apps & API: https://stock-compass.app/settings/api-keys
export STOCK_COMPASS_KEY=sc_…
curl -s https://stock-compass.app/api/v1/me -H "Authorization: Bearer $STOCK_COMPASS_KEY"

The full quick start, with a write and its undo →