TradeMemory Protocol MCP Server
oficialCamada de memória de IA para negociação MT5/forex com 15 ferramentas MCP — armazenar/recuperar negociações, descoberta de padrões, evolução de estratégia e Memória Ponderada por Resultado.
Documentação
Sua IA de trading tem amnésia. E os reguladores estão começando a perceber.
Ela comete os mesmos erros em cada sessão. Não consegue explicar por que negociou. Esquece tudo quando a janela de contexto termina. Enquanto isso, a MiFID II está elevando o padrão para documentação de decisões algorítmicas (Artigo 17). O Ato de IA da UE exige registro sistemático das ações de IA (Artigo 14). Os agentes de seus concorrentes estão aprendendo com cada operação.
A pilha de IA para trading está sem uma camada. Todo servidor MCP lida com execução — fazer pedidos, buscar preços, ler gráficos. Nenhum lida com memória.
Seu agente pode comprar 100 ações da AAPL, mas não consegue responder: "O que aconteceu da última vez que comprei AAPL nesta condição?"
TradeMemory é a camada de memória. Um pip install, e seu agente de IA se lembra de cada operação, cada resultado, cada erro — com trilha de auditoria à prova de violação SHA-256.
Usado em produção por traders que executam checklists pré-voo antes de cada posição, e por sistemas de EA que registram milhares de decisões diariamente.
O que faz
- Antes de operar: consulte sua memória — o que aconteceu da última vez nesta condição de mercado? Como terminou?
- Após operar: uma chamada registra tudo — cinco camadas de memória são atualizadas automaticamente
- Trilhos de segurança: rastreamento de confiança, alertas de drawdown, detecção de sequência de perdas — o sistema avisa quando parar
Funciona com qualquer mercado (ações, forex, cripto, futuros), qualquer corretora, qualquer plataforma de IA. O TradeMemory não executa operações nem toca em seu dinheiro — apenas registra e recorda.
Início Rápido
pip install tradememory-protocol
Adicione ao Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
Depois diga ao Claude: "Registre minha posição comprada em AAPL a $195 — superação de lucros, compra institucional, alta confiança."
Claude Code / Cursor / Docker
# 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
Passo a passo completo: Primeiros Passos (Trilha do Trader + Trilha do Desenvolvedor)
Quem usa o TradeMemory
| Trader de Ações dos EUA | Sistema de EA Forex | Equipe de Compliance | |
|---|---|---|---|
| Mercado | Ações (AAPL, TSLA, ...) | XAUUSD (Ouro) | Multiativos |
| Como | Checklist pré-voo antes de cada operação | Sincronização automatizada do MT5 | Trilha completa de auditoria de decisões |
| Valor chave | Sistema de disciplina — memória antes de cada decisão | Registrar por que os sinais foram bloqueados, não apenas executados | Registros à prova de violação SHA-256 para reguladores |
| Detalhes | Leia mais → | Leia mais → | Leia mais → |
Como funciona
- Recordar — Antes de operar, recupere operações passadas ponderadas por qualidade do resultado, similaridade de contexto, recência, confiança e estado emocional (Framework OWM)
- Registrar — Após operar, uma chamada para
remember_tradegrava em cinco camadas de memória: episódica, semântica, procedural, afetiva e registros de operações - Refletir — Revisões diárias/semanais/mensais detectam desvio comportamental, decadência de estratégia e erros de trading
- Auditar — Cada decisão recebe hash SHA-256 na criação. Exporte a qualquer momento para revisão ou submissão regulatória
Ferramentas MCP
| Categoria | Ferramentas | Descrição |
|---|---|---|
| Memória | remember_trade · recall_memories | Registrar e recordar operações com pontuação ponderada por resultado |
| Estado | get_agent_state · get_behavioral_analysis | Confiança, drawdown, sequências, padrões comportamentais |
| Planejamento | create_trading_plan · check_active_plans | Planos prospectivos com gatilhos condicionais |
| Risco | check_trade_legitimacy | Portão pré-operação de 5 fatores (completo / reduzido / pular) |
| Auditoria | export_audit_trail · verify_audit_hash | Detecção de violação SHA-256 + exportação em massa |
Todas as 17 ferramentas MCP + API REST
| Categoria | Ferramentas |
|---|---|
| Memória Principal | get_strategy_performance · get_trade_reflection |
| Cognitivo OWM | remember_trade · recall_memories · get_behavioral_analysis · get_agent_state · create_trading_plan · check_active_plans |
| Risco e Governança | check_trade_legitimacy · validate_strategy |
| Evolução | evolution_fetch_market_data · evolution_discover_patterns · evolution_run_backtest · evolution_evolve_strategy · evolution_get_log |
| Auditoria | export_audit_trail · verify_audit_hash |
API REST: Mais de 35 endpoints para registro de operações, reflexões, risco, sincronização MT5, OWM, evolução e auditoria. Referência completa →
Preços
| Community | Pro | Enterprise | |
|---|---|---|---|
| Preço | Grátis | $29/mês (Em Breve) | Fale Conosco |
| Ferramentas MCP | 17 ferramentas | 17 ferramentas | 17 ferramentas |
| Armazenamento | SQLite, auto-hospedado | API hospedada | Implantação privada |
| Painel | — | Painel web | Painel personalizado |
| Compliance | Trilha de auditoria inclusa | Trilha de auditoria inclusa | Relatórios de compliance + SLA |
| Suporte | GitHub Issues | Suporte prioritário | Suporte dedicado |
| Comece agora → | Em breve | [email protected] |
Precisa de Ajuda para Integrar?
Está construindo um agente de IA para trading e quer uma arquitetura de memória testada em batalha?
Chamada estratégica gratuita de 30 min — mapearemos as necessidades de memória do seu agente e projetaremos barreiras de proteção para seu fluxo de trabalho específico.
[email protected] | Agende uma chamada
Ajudamos traders a construir checklists pré-voo, conectar MT5/Binance e projetar barreiras de proteção personalizadas para forex, ações e cripto.
Enterprise & Compliance
Cada decisão de trading que seu agente toma — incluindo decisões de não operar — é registrada como um Registro de Decisão de Trading (TDR). Hashes de conteúdo SHA-256 por registro são vinculados em um livro-razão de auditoria encadeado; cada dia UTC é resumido por uma raiz Merkle que, por sua vez, se encadeia entre os dias. A violação de qualquer registro histórico invalida todos os elos subsequentes.
| Regulamento | Requisito | Cobertura do TradeMemory |
|---|---|---|
| MiFID II Artigo 17 | Registrar cada fator de decisão de trading algorítmico | Cadeia de decisão completa: condições, filtros, indicadores, execução |
| Ato de IA da UE Artigo 14 | Supervisão humana de sistemas de IA de alto risco | Raciocínio explicável + contexto de memória para cada decisão |
| Ato de IA da UE Artigo 12 | Registros automáticos e invioláveis durante a vida útil do sistema | Cadeia SHA-256 vinculada + raízes Merkle diárias (RFC 3161 TSA na Fase 1.5) |
# Verify a single record hasn't been tampered with
verify_audit_hash(trade_id="MT5-7047640363")
# → {"verified": true, "chain_entry": {"sequence_num": 42, ...}}
# Walk the entire chain (or a slice) end-to-end
verify_audit_chain(from_seq=1, to_seq=None)
# → {"verified": true, "checked_count": 1284, "first_break_at": null}
# Daily Merkle root — single 32-byte anchor over every TDR for that day
get_daily_root(date="2026-05-14")
# → {"verified": true, "root_hash": "a05544...", "record_count": 18}
# Bulk export for regulatory submission
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl
Veja LIMITATIONS.md para a declaração completa de maturidade da cadeia de auditoria, incluindo o que ainda não está na v0.5.2 (carimbo de tempo TSA, ancoragem externa, prova de inferência zkML).
Precisa de uma implantação personalizada para seu fundo? → [email protected]
Segurança
- Nunca toca em chaves de API. O TradeMemory não executa operações, movimenta fundos ou acessa carteiras.
- Apenas lê e registra. Seu agente passa o contexto da decisão para o TradeMemory. Ele o armazena. Apenas isso.
- Sem chamadas de rede externas. O servidor roda localmente. Nenhum dado é enviado a terceiros.
- Livro-razão de auditoria encadeado SHA-256. Cada registro recebe hash na criação e é vinculado ao registro anterior. Raízes Merkle diárias ancoram a cadeia. Verifique a integridade no nível do registro, fatia ou dia.
- 1.428 testes passando. Suíte de testes completa com CI.
Status da Pesquisa
O framework OWM do TradeMemory é fundamentado em ciência cognitiva (Tulving 1972) e aprendizado por reforço (Schaul et al. 2015). Status atual:
- Pontuação de cinco fatores OWM: implementada, testada (mais de 1.300 testes)
- Validação estatística: DSR, MBL implementados (Bailey-de Prado 2014)
- Trilha de auditoria: TDR à prova de violação SHA-256
- Motor de evolução: fase de pesquisa (geração de estratégia funciona, taxa de aprovação do portão estatístico sob otimização)
- Recordação híbrida: modo somente OWM ativo, fusão vetorial disponível quando embeddings configurados
- Validação empírica: em andamento (n=40 operações, meta n>=100 para significância estatística)
Documentação
| Doc | Descrição |
|---|---|
| Primeiros Passos | Instalar → primeira operação → checklist pré-voo |
| Casos de Uso | 3 cenários reais de produção |
| Referência da API | Todos os endpoints REST |
| Framework OWM | Teoria da Memória Ponderada por Resultado |
| Arquitetura | Design do sistema e separação de camadas |
| Tutorial | Passo a passo detalhado |
| Configuração MT5 | Integração com MetaTrader 5 |
| Registro de Pesquisa | Experimentos de evolução e dados |
| Taxonomia de Falhas | 11 modos de falha de IA de trading |
| 中文版 | Chinês Tradicional |
Contribuindo
Veja Guia de Contribuição · Política de Segurança
MIT — veja LICENSE. Apenas para fins educacionais/de pesquisa. Não é aconselhamento financeiro.