Claude Desktop · MCP setup

How to Connect TradeJournal MCP in Claude Desktop

Configure Claude Desktop's MCP server list with your TradeJournal token and gateway URL.

Connect AI Tools reference MCP hub
TradeJournal Connect AI settings with personal MCP token management

Quick summary

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

Key takeaway

To use TradeJournal.co with Claude Desktop MCP, issue a personal token in Connect AI, register the TradeJournal MCP server URL in Claude Desktop configuration, and call get_runtime_context before querying trades or stats.

Setup steps

  1. Generate a personal MCP token

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

  2. Edit Claude Desktop MCP config

    Add the TradeJournal server block (URL + Authorization header) per Anthropic's MCP format.

  3. Restart Claude Desktop

    Quit and reopen Claude so MCP servers reload.

  4. Verify tools

    Confirm nine TradeJournal tools; start with get_runtime_context.

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: Claude 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, limit). User-owned rows only.
get_trade Single trade by id (must belong to the authenticated user).
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.

FAQ

Add the TradeJournal MCP server to Claude Desktop config with your Bearer token, restart Claude, and verify tools such as get_runtime_context and list_trades appear.

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

Start free trial Consulting