git clone https://github.com/your-org/onetick-mcp.git
cd onetick-mcp
pip install -e .

export ONETICK_CLIENT_ID=your_client_id
export ONETICK_CLIENT_SECRET=your_client_secret

# Add to your current project
claude mcp add onetick -- onetick-mcp

# Or with explicit credentials
claude mcp add onetick \
  --env ONETICK_CLIENT_ID=your_client_id \
  --env ONETICK_CLIENT_SECRET=your_client_secret \
  -- onetick-mcp

# Verify it's registered
claude mcp list

claude mcp add --scope user onetick -- onetick-mcp

claude mcp add onetick -- onetick-mcp --direct

{
  "mcpServers": {
    "onetick": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/onetick_mcp",
        "onetick-mcp"
      ],
      "env": {
        "ONETICK_CLIENT_ID": "your_client_id",
        "ONETICK_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

# Run a workflow command
/analyze-tca AAPL 2024-01-15 09:30:00 2024-01-15 16:00:00

# Ask natural language questions (Claude picks the right tools)
"What's the VWAP for MSFT today?"
"Show me the order book for TSLA"
"Morning briefing for AAPL, MSFT, GOOGL"
"How volatile is AMZN compared to the last 20 days?"

# Run multi-symbol analysis
/market-overview AAPL,MSFT,GOOGL,AMZN

{
  "name": "onetick",
  "description": "OneTick market data analytics — tick data, TCA, microstructure, volatility analysis across 200+ global exchanges",
  "version": "0.2.0",
  "author": {
    "name": "OneTick"
  }
}

{
  "mcpServers": {
    "onetick": {
      "type": "stdio",
      "command": "onetick-mcp",
      "env": {
        "ONETICK_CLIENT_ID": "${ONETICK_CLIENT_ID}",
        "ONETICK_CLIENT_SECRET": "${ONETICK_CLIENT_SECRET}"
      }
    }
  }
}

claude --plugin-dir /path/to/onetick_mcp

/onetick:analyze-tca AAPL 2024-01-15 09:30:00 2024-01-15 16:00:00

onetick_mcp/
├── .claude-plugin/
│   └── plugin.json            <- Plugin manifest
├── .mcp.json                  <- MCP server config (auto-starts with plugin)
├── commands/                  <- Workflow commands (become slash commands)
│   ├── analyze-tca.md
│   ├── analyze-microstructure.md
│   ├── analyze-intraday.md
│   ├── analyze-volatility.md
│   ├── analyze-execution.md
│   └── market-overview.md
├── skills/                    <- Domain knowledge (loaded automatically)
│   ├── tca-analysis/SKILL.md
│   ├── market-microstructure/SKILL.md
│   ├── intraday-analytics/SKILL.md
│   ├── volatility-analysis/SKILL.md
│   ├── execution-quality/SKILL.md
│   └── market-overview/SKILL.md
├── src/                       <- MCP server implementation
│   ├── server.py
│   ├── config.py
│   ├── response.py
│   └── tools/
│       ├── registry.py
│       ├── meta_tools.py
│       ├── data_retrieval.py
│       ├── metadata.py
│       ├── analytics.py
│       └── sql.py
├── tests/
├── CONNECTORS.md              <- Complete tool reference
├── pyproject.toml
└── .env.example

"What is the current price of AAPL?"
-> GET_TICK_DATA (symbol='AAPL', tick_type='TRD', max_rows=1)

"EUR/USD rate right now"
-> GET_TICK_DATA (symbol='EUR/USD', database='GLOBAL_FX', tick_type='QTE', max_rows=1)

"What's the DJIA at?"
-> GET_TICK_DATA (database='DJ_INDICES', max_rows=1)

"AAPL daily chart for this month"
-> GET_DAILY_BARS (symbol='AAPL', start_date='2026-04-01', end_date='2026-04-30')

"MSFT historical prices adjusted for splits"
-> GET_DAILY_BARS (symbol='MSFT', adjusted=True)

"5-minute OHLC bars for AAPL today"
-> GET_BARS (symbol='AAPL', bar_type='ohlc', interval='5min')

"Compare 5-min bars for AAPL, MSFT, GOOGL"
-> GET_MULTI_SYMBOL (symbols='AAPL,MSFT,GOOGL', data_type='bars', interval='5min')

"What's the VWAP for AAPL today?"
-> CALC_VWAP (symbol='AAPL', start='2026-04-08 09:30:00', end='2026-04-08 16:00:00')

"Is there buying pressure in TSLA?"
-> CALC_BOOK_IMBALANCE (symbol='TSLA')

"Realized volatility for GOOGL"
-> CALC_VOLATILITY (symbol='GOOGL', interval='5min')

"Run a TCA for CSCO from 9:30 to 12:00 on Jan 3, 2024"
-> /analyze-tca chains: CALC_VWAP -> CALC_SPREAD_STATS -> CALC_TRADE_STATS -> GET_BARS

"Analyze AAPL's market microstructure"
-> /analyze-microstructure chains: GET_BOOK_SNAPSHOT -> CALC_BOOK_IMBALANCE -> CALC_SPREAD_STATS

"Morning briefing for AAPL, MSFT, GOOGL"
-> /market-overview chains: GET_DAILY_BARS -> CALC_VWAP -> CALC_TRADE_STATS -> CALC_VOLATILITY -> CALC_SPREAD_STATS

SELECT SYMBOL_NAME, SUM(SIZE) AS VOLUME
FROM US_COMP.TRD
WHERE SYMBOL_NAME = 'AAPL'
  AND TIMESTAMP >= '2024-01-15 09:30:00 America/New_York'
GROUP BY SYMBOL_NAME

# Tool selection validation (7 tests)
python tests/test_tool_selection.py

# Workflow/skill structure validation (9 tests)
python tests/test_workflow_validation.py

# Independent query optimization validation (10 rules, 100 queries)
python tests/test_independent_queries.py