Cursor · MCP setup

How to Connect TradeJournal MCP in Cursor

Point Cursor at TradeJournal's MCP gateway with your personal token—then use the same user-scoped tools as our on-site agent.

Connect AI Tools reference MCP hub

Connect AI settings

Create and revoke personal MCP tokens—scoped to your account only.

  • Account Settings → Connect AI
  • Label tokens (e.g. Cursor)
  • Revoke if leaked
Open Connect AI

Quick summary

  1. Token: Connect AI → personal MCP token (your account only).
  2. Configure client: Follow steps below for Cursor MCP docs.
  3. Tools: Call get_runtime_context first — full list on the MCP tools reference page.

Key takeaway

TradeJournal.co MCP in Cursor uses a personal token from Connect AI and a local or staged MCP gateway URL in mcp.json; after connecting, call get_runtime_context first, then list_trades or get_trade_stats for user-scoped answers about your journal.

Step-by-step

Setup steps

  1. 1. Generate a personal MCP token

    Log in → Account Settings → Connect AI → Generate token. Copy once; store only in your AI client config.

  2. 2. Add TradeJournal to mcp.json

    In your project or home Cursor config, add the sample JSON from this page with http://localhost:3333/mcp and your Bearer token.

  3. 3. Restart Cursor MCP

    Reload MCP servers in Cursor settings and confirm TradeJournal tools are listed.

  4. 4. Run get_runtime_context

    Ask the agent to call get_runtime_context before trade or stats questions.

Example mcp.json

{
  "mcpServers": {
    "tradejournal": {
      "url": "http://localhost:3333/mcp",
      "headers": {
        "Authorization": "Bearer tj_mcp_u_<YOUR_TOKEN>"
      }
    }
  }
}

Gateway (dev): http://localhost:3333/mcp · Token: tj_mcp_u_<YOUR_TOKEN>

Official client docs: Cursor MCP docs · MCP specification

TradeJournal MCP tools (summary)

Full parameters on the MCP tools reference page.

Tool Purpose
get_runtime_context User portfolios, active portfolio, plan flags, privacy rules. Call this first in every session.
list_portfolios Portfolio id and name list for disambiguation.
list_trades Filtered trade list (portfolio, symbol, status, asset, limit, order_by). Open rows include plan targets and nudges.
list_open_trades_by_target_priority Open trades sorted by price/stop target priority with nudge summary.
get_trade Single trade by id with entries, sizing, option context, and plan levels.
update_trade Set or clear price_target / stop_target on a trade (validated).
link_trade_unlinked_dividends Link orphan imported dividends to one trade; refreshes stats.
get_trade_stats Aggregate win rate, profit, and related stats for the user.
get_dashboard_stats High-level public/private trade and post rollups.
list_posts Published posts metadata for the user.
get_post One published post by id.
get_portfolio_stats Per-portfolio performance rollup.
list_media_assets User media library with attribution metadata.
get_media_asset Single media asset by id.
update_media_asset Update media attribution fields (narrow write).
delete_media_asset Delete unreferenced media assets.
audit_portfolio_import_health Read-only import/portfolio health audit.
repair_portfolio_import_health Allowlisted import repairs (confirm required for apply).

Frequently asked questions

Generate a token in Connect AI, configure mcp.json with the gateway URL and Bearer token, restart Cursor MCP, and verify TradeJournal tools appear in the tools list.

No. Use localhost/stag gateway only—never production from a dev machine.

Always get_runtime_context, then use list_trades or get_trade_stats. See the full MCP tools reference for parameters.

Tools reference · Security & privacy · MCP hub · Onboarding call

Start free trial — claim onboarding

Import trades, then ask real questions about your data.

Connect AI Start free trial Consulting