smizxe

Agent Trading Journal — AI skill for Claude Code

AI community

AI trading journal MCP server: Claude Code, Codex or any MCP agent logs trades from chart screenshots, checks them against your own strategy rules, imports MT5/TradingView, and shows R-based stats in.

How to install Agent Trading Journal

This entry records only its repository, not the path inside it, so there is no exact command to give. Open smizxe/agent-trading-journal and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Trading Journal does

AI trading journal MCP server: Claude Code, Codex or any MCP agent logs trades from chart screenshots, checks them against your own strategy rules, imports MT5/TradingView, and shows R-based stats in a local dashboard.

Alternatives in AI

  • Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★
  • Claude Skill Aso Appstore Screenshots — A Claude Code skill that generates high-converting App Store screenshots for your iOS app 1.2k ★
  • Pretty Mermaid Skills — To provide AI with Mermaid chart rendering capability, supporting both SVG and ASCII output formats 552 ★

README

Agent Trading Journal: an AI trading journal (MCP server) for Claude Code and Codex

[![npm](https://img.shields.io/npm/v/agent-trading-journal?color=2a78d6)](https://www.npmjs.com/package/agent-trading-journal) [![test](https://github.com/smizxe/agent-trading-journal/actions/workflows/test.yml/badge.svg)](https://github.com/smizxe/agent-trading-journal/actions/workflows/test.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-white)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-server-8a63d2)](https://modelcontextprotocol.io) [![Node](https://img.shields.io/badge/node-%E2%89%A522-339933)](package.json)

**Works with:** Claude Code · Codex CLI · Claude Desktop · Cursor · Windsurf · any MCP client — **Markets:** forex, futures, stocks, crypto — **Imports:** MetaTrader 4/5, TradingView, IBKR, NinjaTrader, Tradovate and more

**A trading journal your AI agent writes for you.** Paste a chart screenshot into Claude Code, Codex or any MCP client. The agent reads it, fills in *your* strategy's fields, checks the trade against *your* rules, logs it, and attaches the image. A local dashboard shows what's working.

No forms, no LLM API key, no account. Everything stays on your machine in one SQLite file.

![Dashboard with synthetic demo data](docs/assets/dashboard.png) Dashboard with generated demo data (`npx agent-trading-journal demo`). Not a real account.

Why this exists

Most "AI trading journals" are a web form plus a chatbot that reads your numbers afterwards. Two problems follow:

  1. Logging is the bottleneck. People stop journaling because entering trades by hand is tedious.
  2. Generic fields measure nothing specific. "Setup: A/B/C" doesn't tell you whether your rules work.

Here the agent is the data-entry clerk, and the journal is shaped by an onboarding interview about how *you* trade:

Typical AI journal Agent Trading Journal
Who enters trades You, in a form Your agent, from screenshots (or a b