{"_id":"@astramindapp/mcp-journal","name":"@astramindapp/mcp-journal","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@astramindapp/mcp-journal","version":"0.1.0","description":"MCP server for MINDJournal — exposes trading-journal tools (log_trade, list_trades, get_stats, tag_trade, import_trades, get_calendar) to any MCP client.","license":"MIT","type":"module","main":"dist/index.js","bin":{"mcp-journal":"dist/index.js"},"scripts":{"build":"tsc -p .","start":"node dist/index.js","dev":"tsx src/index.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","dotenv":"^16.4.5","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.5.0","tsx":"^4.19.0","typescript":"^5.6.0"},"engines":{"node":">=18"},"gitHead":"2e9ca026a2bd1713f34c90bc1b94cc0fba16f83b","types":"./dist/index.d.ts","_id":"@astramindapp/mcp-journal@0.1.0","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-uO3TxX0RVHTwSuWfzObWWnoDZmG/dJbsykuOBObSGoqRNz4j6ZPYkrbYlQ/NupzrvzadX9pPcsav/QTAkAlCbw==","shasum":"eef5f9c2a3e8264cffde007ca58c9afa573d7b7c","tarball":"https://registry.npmjs.org/@astramindapp/mcp-journal/-/mcp-journal-0.1.0.tgz","fileCount":13,"unpackedSize":47025,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDwknvd24WUGpFRLXFfRC0Bxf5BgaqqzuARHKWYDkPABQIgeQ8EPMAX2YYrq9u99b6uHZ774W4D/wIc9pGM6RHFQaI="}]},"_npmUser":{"name":"theastraway","email":"anthony@theastraway.com"},"directories":{},"maintainers":[{"name":"theastraway","email":"anthony@theastraway.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-journal_0.1.0_1783777367525_0.30632291809255774"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T13:42:47.400Z","0.1.0":"2026-07-11T13:42:47.673Z","modified":"2026-07-11T13:42:47.875Z"},"maintainers":[{"name":"theastraway","email":"anthony@theastraway.com"}],"description":"MCP server for MINDJournal — exposes trading-journal tools (log_trade, list_trades, get_stats, tag_trade, import_trades, get_calendar) to any MCP client.","license":"MIT","readme":"# @astramindapp/mcp-journal\n\nMCP server exposing MINDJournal as tools for any MCP client (Claude, Claude Code,\nClaude Desktop, Cursor, custom agents). This server is a **thin client** of\n`mindjournal-api`'s `/v1` REST surface (`../api`) — it never talks to Parse/Mongo\ndirectly. All 6 tools are fully implemented and verified end-to-end against a live\n`mindjournal-api` instance (see `journal-client.ts` for the HTTP layer).\n\n## Tools\n\n| Tool | Maps to |\n|---|---|\n| `log_trade` | `POST /v1/trades` — log a single trade (symbol, side, entry/exit, size, stop/target, tags, notes, setup) |\n| `list_trades` | `GET /v1/trades` — query by account / symbol / broker / tag / setup / side / status / date range |\n| `get_stats` | `GET /v1/stats/{summary,equity-curve,calendar,by-symbol,by-setup,by-day}` |\n| `tag_trade` | `POST /v1/trades/{id}/tags` + `PATCH /v1/trades/{id}` — add tags, update setup/notes/satisfaction |\n| `import_trades` | `POST /v1/trades/bulk-import` — bulk-import a broker CSV/JSON export |\n| `get_calendar` | `GET /v1/stats/calendar` — daily P&L calendar view for a month/account |\n\n## Run locally\n\n```bash\ncd mcp\ncp .env.example .env   # point JOURNAL_API_URL / JOURNAL_API_KEY at the running api service\nnpm install\nnpm run dev             # runs src/index.ts directly via tsx (stdio transport)\n```\n\nBuild for distribution:\n\n```bash\nnpm run build\nnpm start\n```\n\n## Wiring into an MCP client\n\nAdd to the client's MCP server config, e.g.:\n\n```json\n{\n  \"mcpServers\": {\n    \"mindjournal\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mindjournal/mcp/dist/index.js\"],\n      \"env\": {\n        \"JOURNAL_API_URL\": \"http://localhost:8090\",\n        \"JOURNAL_API_KEY\": \"...\"\n      }\n    }\n  }\n}\n```\n\n## License\n\nMIT — see `LICENSE`.\n","readmeFilename":"README.md","_rev":"1-5020371e510f21940843e7c311defa38"}