# Vibe Trading

> Use when finance workflows need Vibe-Trading market data, backtests, factor analysis, screening, research swarms, Shadow Account reports, or MCP tool discovery.

- Skill: `jialuohu/vibe-trading` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jialuohu/vibe-trading`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jialuohu/vibe-trading/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: jialuohu (https://skillmd.com/u/jialuohu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jialuohu/vibe-trading

---


# Vibe-Trading

## Overview

Use Vibe-Trading for research-heavy finance work: market data, backtests, factor analysis, screening, research swarms, trade-journal analysis, and Shadow Account reports. Use Alpaca MCP for direct Alpaca account, order, asset, crypto, options, and news workflows.

## Routing

| Need | Prefer |
| --- | --- |
| Research a strategy or market thesis | `vibe_trading` |
| Fetch broad market data or fundamentals | `vibe_trading` |
| Run a backtest, factor analysis, or screen | `vibe_trading` |
| Run a multi-agent research swarm | `vibe_trading` |
| Analyze trade journals or Shadow Account reports | `vibe_trading` |
| Inspect or change Alpaca account/orders | Alpaca MCP |

## Configuration

The toolbox plugin launches the upstream PyPI package with `uvx --from vibe-trading-ai vibe-trading-mcp`, tracking the latest published version. Optional provider and data-source overrides may live under `CODEX_SECRETS_DIR`. Native Vibe-Trading state, provider config, run history, and connector profiles live under `VIBE_TRADING_HOME`.

Do not put API keys, OAuth state, broker credentials, or `.env` contents in the toolbox repo.

## Smoke Test

After setup, verify the MCP server is visible:

```bash
codex mcp list
```

For live discovery, start the configured command through an MCP client and confirm tools such as `list_skills` and `get_market_data` are present before relying on the integration.

## Safety

Vibe-Trading's MCP surface is for research and read-oriented connector workflows; it is not the default path for direct broker order actions. Treat generated files, backtest runs, reports, connector selection, and swarm execution as local state changes under `VIBE_TRADING_HOME`.