# System R AI — Trading Operating System for AI Agents
# https://agents.systemr.ai

> System R is the complete trading operating system for AI agents.
> 68 free MCP tools across risk management, position sizing, performance evaluation,
> technical analysis, options/futures intelligence, market data, and trade execution.
> You bring the data. We do the rest.

## API Base URL
https://agents.systemr.ai

## Authentication
- Header: X-API-Key
- Register: POST https://agents.systemr.ai/v1/agents/register

## Pricing
All 68 tools are free. You only pay when an LLM is used. Cost varies by query complexity.
Accepted: Stripe, SOL, USDC, USDT, PYUSD, OSR (50% bonus).

## Quick Start
1. Register: POST /v1/agents/register → get API key
2. List tools: GET /v1/tools/list → see all 68 free tools
3. Call any tool: POST /v1/tools/call { "tool_name": "...", "arguments": {...} }

## Python SDK
pip install systemr
```python
from systemr import SystemRClient
client = SystemRClient(api_key="sr_agent_...")
result = client.call_tool("pre_trade_gate", symbol="AAPL", direction="long",
                          entry_price="185.00", stop_price="180.00", equity="100000")
```

## MCP Server
- SSE: https://agents.systemr.ai/mcp/sse
- Agent card: https://agents.systemr.ai/.well-known/agent.json
- Server card: https://agents.systemr.ai/.well-known/mcp/server-card.json

## Tools (68 total — all free)

### Core (4)
calculate_position_size, check_trade_risk, evaluate_performance, get_pricing

### Analysis (18)
analyze_drawdown, run_monte_carlo, calculate_kelly, find_variance_killers, analyze_win_loss, run_what_if, analyze_confidence, analyze_consistency, analyze_correlation, analyze_distribution, analyze_recovery, analyze_risk_adjusted, segment_trades, analyze_execution_quality, detect_peak_valley, calculate_rolling_g, calculate_system_r_score, detect_anomalies

### Intelligence (11)
detect_regime, detect_patterns, detect_structural_break, analyze_trend_structure, calculate_indicators, analyze_price_structure, analyze_correlations, analyze_liquidity, analyze_greeks, analyze_iv_surface, analyze_futures_curve, analyze_options_flow

### Planning (4)
size_options_position, size_futures_position, build_options_plan, build_futures_plan

### Data (3)
calculate_pnl, calculate_expected_value, check_compliance

### Compound (2)
pre_trade_gate, assess_trading_system

### System (5)
calculate_equity_curve, score_signal, analyze_trade_outcome, calculate_margin, evaluate_scanner

### Market Data (5)
get_stock_quote, get_market_movers, get_market_overview, search_news, scan_market

### Journal (2)
record_trade_journal, record_trade_outcome

### Memory & ML (7)
store_memory, search_memory, get_trading_biases, get_behavioral_fingerprint, predict_trajectory, detect_anomalies, cluster_trades

### Delegation (4)
delegate_task, list_agents, get_delegation_status, cancel_delegation

### Agent (2)
create_agent, list_capabilities

### Alert (2)
create_alert, list_alerts

## Links
- Docs: https://docs.systemr.ai
- OpenAPI: https://agents.systemr.ai/openapi.json
- Website: https://systemr.ai
- SDK: https://pypi.org/project/systemr/