tradememory-protocol

Overview

TradeMemory Protocol serves as a memory layer for AI trading agents, addressing regulatory requirements and performance improvement through comprehensive decision recording and retrieval. The system implements 17 MCP tools across memory, state, planning, risk, and audit categories, enabling agents to recall past trades weighted by outcome quality, record new decisions, and generate tamper-proof audit trails. It supports multiple markets and brokers without executing trades or handling financial assets. The framework includes Outcome-Weighted Memory (OWM) scoring based on cognitive science principles and reinforcement learning research.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• remember_trade

  Record a trading decision with multiple memory layers

  Try:Record my AAPL long at $195 — earnings beat, institutional buying, high confidenceTry:Log a forex short trade on EURUSD with technical analysis
• recall_memories

  Retrieve past trades weighted by outcome quality and context

  Try:What happened last time I traded AAPL in this market condition?Try:Show me my previous trades with high confidence but negative outcomes
• get_agent_state

  Check current trading confidence, drawdown, and streak status

  Try:What's my current trading confidence level?Try:How many consecutive losing trades have I had?
• get_behavioral_analysis

  Analyze trading patterns and behavioral drift

  Try:Show me my trading patterns over the last monthTry:Have I been making emotional trading decisions recently?
• create_trading_plan

  Create a prospective trading plan with conditional triggers

  Try:Create a plan for when VIX exceeds 30Try:Plan a strategy for earnings announcements on tech stocks
• check_active_plans

  Review and evaluate active trading plans

  Try:Show me my active trading plansTry:Which of my plans are triggered by current market conditions?
• check_trade_legitimacy

  Evaluate a trade against pre-defined risk factors

  Try:Check if this AAPL trade meets my risk criteriaTry:Validate if this forex trade passes my 5-factor gate
• export_audit_trail

  Export tamper-proof trading decision records

  Try:Export all my AUD trades for the last monthTry:Get my complete audit trail in JSON format
• verify_audit_hash

  Verify the integrity of a trading decision record

  Try:Verify this trade hasn't been tampered withTry:Check if my MT5-7047640363 record is still valid
• get_strategy_performance

  Analyze historical performance of trading strategies

  Try:How has my momentum strategy performed over the last quarter?Try:Compare performance of my mean reversion vs breakout strategies
• get_trade_reflection

  Retrieve detailed reflection notes on past trades

  Try:Show me my reflection notes from last week's TSLA tradeTry:What did I learn from my most profitable trade?
• validate_strategy

  Validate a trading strategy against historical data

  Try:Validate this new mean reversion strategyTry:Test if my options hedging strategy would have been profitable

Comparable tools

Installation

pip install tradememory-protocol

{
  "mcpServers": {
    "tradememory": {
      "command": "uvx",
      "args": ["tradememory-protocol"]
    }
  }
}

# Claude Code
claude mcp add tradememory -- uvx tradememory-protocol

# From source
git clone https://github.com/mnemox-ai/tradememory-protocol.git
cd tradememory-protocol && pip install -e . && python -m tradememory

# Docker
docker compose up -d

FAQ

Does TradeMemory execute trades or handle funds?

No. TradeMemory only records and recalls trading decisions. It never executes trades, moves funds, or accesses wallets.

How does it ensure data integrity for compliance?

Every trading decision is SHA-256 hashed at creation and linked into a forward-chained audit ledger. Daily Merkle roots anchor the chain, making tampering detectable.

On Hacker News

Recent discussion from the developer community.

• Show HN: TradeMemory Protocol – Memory layer for AI trading agents▲ 1💬 1
  Story by mnemoxai · 2026-02-23

Compare tradememory-protocol with