TradeMemory Protocol
An MCP memory server for trading agents: keeps decisions and outcomes with a tamper-evident SHA-256 journal
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Stores records of trading decisions
- Can connect to trading terminal history
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/tradememory-protocolDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal
claude mcp add --transport stdio tradememory-protocol -- uvx tradememory-protocol==0.5.5Or add to the file .mcp.json, in the project
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"tradememory-protocol","type":"stdio","command":"uvx","args":["tradememory-protocol==0.5.5"]}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"tradememory-protocol": {
"type": "stdio",
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the servers key.
Run in a terminal
codex mcp add tradememory-protocol -- uvx tradememory-protocol==0.5.5Or add to the file ~/.codex/config.toml, for all projects
[mcp_servers.tradememory-protocol]
command = "uvx"
args = ["tradememory-protocol==0.5.5"]If the file already exists, append the block to the end.
Run in a terminal
gemini mcp add -s user tradememory-protocol uvx tradememory-protocol==0.5.5Or add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"tradememory-protocol": {
"type": "local",
"command": [
"uvx",
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcp key.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the context_servers key.
Add to the file .codeassistant/mcp.json, in the project
{
"mcpServers": {
"tradememory-protocol": {
"command": "uvx",
"args": [
"tradememory-protocol==0.5.5"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Install the package: pip install tradememory-protocol, then connect it as MCP: claude mcp add tradememory -- uvx tradememory-protocol.
Other ways from the author
pip install tradememory-protocolInstall the package for local use.
This is third-party code. Review the repository files before installing.
What it does
TradeMemory gives a trading agent memory of trades, their outcomes and past mistakes. Each decision is SHA-256 hashed on write and linked into a chain, so the journal is protected from silent tampering. The MCP toolset lets the agent record decisions, recall similar situations weighted by outcome and export an audit trail. The server installs via pip and runs locally, with uvx and Docker options.
Who it is for. For people building trading agents who want a verifiable history of their decisions.
Good fit when
- You need the agent to remember past trades and outcomes
- You need a tamper-evident decision log
- You need to export an audit trail
Not a fit when
- You need trade execution rather than memory of trades
- You do not deal with trading at all
Example request
Record this trading decision in TradeMemory and find similar past trades with their outcomesLimitations
It is a memory and audit layer; it does not place trades or give trading advice. The protocol itself is free and self-hosted; the maintainer's separate paid service is statistical analysis of your trading history.
How to disable. Remove the tradememory server from your MCP config and uninstall the package via your Python package manager.
MCP
- Transport
- stdio
- Authentication
- not required
Security check
- Stores records of trading decisions
- Can connect to trading terminal history
README in short
The README describes TradeMemory as a memory layer for trading agents with a tamper-evident SHA-256 journal. Installation is via pip, with MCP connection through uvx, a from-source run and Docker. It lists tool groups including recording decisions, outcome-weighted recall and audit-trail export. It notes that the protocol itself is free, while the paid service is statistical analysis of trading history.
FAQ
Does it place trades?
No. It is decision memory and audit; execution stays with your agent and broker.
How is the journal protected?
Each decision is SHA-256 hashed and chained, which makes tampering detectable.
Related
A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language
inn-check-ru: counterparty risk traffic light
inn-check-ru
An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict