A remote Model Context Protocol (MCP) server for real-time cryptocurrency and stock market analysis. Provides AI-powered market intelligence tools with 9 theory-based analysis engines, multi-chain DEX discovery, and enterprise features. Deployable to Railway with Auth0 authentication.
- Top Gainers/Losers Scanner - Find best and worst performing assets across exchanges
- Bollinger Scanner - Detect squeeze patterns for potential breakouts
- Rating Scanner - Filter assets by Bollinger Band position (-3 to +3 rating)
- Volume Scanner - Find high-volume breakouts with RSI filtering
- Pivot Points Scanner - Find assets near key pivot levels (Classic/Fibonacci/Camarilla)
- Basic TA Analyzer - Comprehensive indicator snapshot (Bollinger Bands, Moving Averages, Oscillators, Ichimoku, Pivot Points, MACD, ADX, VWAP, and more)
- Dow Theory Analyzer - Primary trend identification via higher highs/lows analysis
- Ichimoku Analyzer - Cloud analysis, TK crosses, Chikou confirmation
- VSA Analyzer - Volume Spread Analysis for smart money signal detection
- Chart Pattern Analyzer - Classical patterns (Head & Shoulders, Double Top/Bottom, Triangles)
- Wyckoff Analyzer - Accumulation/Distribution phase detection with event identification
- Elliott Wave Analyzer - Wave pattern identification and counting with rule validation
- Chan Theory Analyzer - Chanlun fractal, stroke, and hub analysis (缠论)
- Harmonic Analyzer - Gartley, Bat, Butterfly, Crab pattern detection with PRZ levels
- Market Profile Analyzer - POC, Value Area (VAH/VAL), profile shape analysis
- Memecoin Discovery - Find trending, new, or high-volume tokens across DEX networks via GeckoTerminal
All theory-based analyzers return structured JSON with:
- Confidence scoring (0-100) using a standardized formula
- No Signal protocol - Returns neutral when confidence is below threshold, preventing weak signals
- Attribution - Theory name, triggered rules, and invalidation levels
- LLM-ready summaries for natural language responses
| Market Type | Sources |
|---|---|
| Crypto (CEX) | Binance, Bybit, Bitget, OKX, Coinbase, Gate.io, MEXC |
| Crypto (DEX) | Solana, BSC, Ethereum, Base, Polygon, Arbitrum, Avalanche, Optimism, Tron, and more |
| US Stocks | NASDAQ, NYSE |
| UK Stocks | LSE (London Stock Exchange) |
| Hong Kong Stocks | HKEX, HSI |
Data Sources:
- TradingView - CEX crypto, stocks, and indices
- GeckoTerminal - Multi-chain DEX data (200+ networks)
5m 15m 1h 4h 1D 1W 1M
Note: DEX data via GeckoTerminal supports up to
1W. Monthly (1M) is CEX-only.
Deploy as a secure remote MCP server with Auth0 authentication. Once deployed, connect from any MCP-compatible AI platform:
- Claude.ai - Via Connectors (documentation)
- ChatGPT - Via MCP plugin support
- Other AI platforms - Any service supporting MCP protocol
- Railway account (free tier available)
- Auth0 account (free tier available)
- GitHub account
-
Fork/Clone this repository to GitHub
-
Set up Auth0
- Create account at auth0.com
- Create API: Dashboard > Applications > APIs > Create API
- Note your
DomainandAPI Identifier
-
Deploy to Railway
- Connect your GitHub repo to Railway
- Add environment variables:
AUTH0_DOMAIN=your-tenant.auth0.com AUTH0_AUDIENCE=https://your-api-identifier RESOURCE_SERVER_URL=https://your-app.up.railway.app/mcp - The included
Procfilehandles the--authflag for production automatically.
Optional Configuration (environment variables):
# Database (enables user management, quotas, activity logging) DATABASE_URL=postgresql://user:pass@host:5432/dbname # Cache settings (timeframe-specific TTL is used by default) OHLCV_CACHE_TTL_SECONDS=60 # Default cache TTL in seconds OHLCV_CACHE_STANDARD_BARS=300 # Standard bar count to fetch OHLCV_CACHE_ENABLED=true # Enable/disable caching # Analysis settings SIGMAPILOT_SIGNAL_THRESHOLD=50 # Minimum confidence for signal (default: 50) # Admin ADMIN_USER_IDS=uuid1,uuid2 # Auto-promote these user IDs to admin on loginNote: Cache uses timeframe-specific TTL automatically:
- 5m: 90s, 15m: 3min, 1h: 10min, 4h: 30min, 1D: 2hr, 1W: 12hr
-
Connect to AI Platform
Claude.ai (Web):
- Go to claude.ai/settings/connectors
- Add your MCP server URL:
https://your-app.up.railway.app/mcp - Authenticate with Auth0 when prompted
Claude Desktop:
{ "mcpServers": { "sigmapilot": { "url": "https://your-app.up.railway.app/mcp", "transport": "streamable-http" } } }
See Remote Deployment Guide for detailed instructions.
For local development or direct Claude Desktop connection (stdio mode).
-
Install UV Package Manager:
# macOS brew install uv # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Linux curl -LsSf https://astral.sh/uv/install.sh | sh
-
Add to Claude Desktop config:
Config location:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "sigmapilot-mcp": { "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/SigmaPilotAI/sigmapilot-mcp.git", "sigmapilot-mcp" ] } } } - Windows:
-
Restart Claude Desktop
| Tool | Description |
|---|---|
top_gainers_scanner |
Top performing assets by exchange/timeframe |
top_losers_scanner |
Worst performing assets by exchange/timeframe |
bollinger_scanner |
Find assets with Bollinger Band squeeze (low BBW) |
rating_scanner |
Filter by Bollinger Band rating (-3 to +3) |
volume_scanner |
Volume breakout detection with optional RSI filtering |
pivot_points_scanner |
Find assets near pivot point levels (Classic/Fibonacci/Camarilla) |
| Tool | Description | DEX Support |
|---|---|---|
basic_ta_analyzer |
Versioned raw indicator snapshot (basic_ta.v1: BB, MA, RSI, MACD, Ichimoku, Pivots, Volume) |
No (CEX only) |
dow_theory_analyzer |
Trend analysis via higher highs/higher lows patterns | Yes |
ichimoku_analyzer |
Ichimoku Kinko Hyo (cloud position, TK cross, Chikou span) | Yes |
vsa_analyzer |
Volume Spread Analysis - smart money signals | Yes |
chart_pattern_analyzer |
Classical patterns (H&S, triangles, double top/bottom) | Yes |
wyckoff_analyzer |
Wyckoff phases (accumulation, distribution, markup, markdown) | Yes |
elliott_wave_analyzer |
Elliott Wave impulse/corrective pattern analysis | Yes |
chan_theory_analyzer |
Chan Theory/Chanlun (fractals, strokes, segments, hubs) | Yes |
harmonic_analyzer |
Harmonic patterns (Gartley, Bat, Butterfly, Crab) with PRZ | Yes |
market_profile_analyzer |
Market Profile (POC, Value Area, profile shape) | Yes |
| Tool | Description |
|---|---|
memecoin_discovery |
Discover trending/new/high-volume tokens across DEX networks |
- Theory-based analyzers return a standardized
AnalysisResultwithstatus,confidence,attribution,llm_summary,invalidation,is_error, and optionaltimingmetadata for confirmed pivot/fractal methods. basic_ta_analyzerintentionally returns a raw TradingView indicator payload instead ofAnalysisResult; success and error payloads now includeschema_version="basic_ta.v1",tool,analysis_type, andis_error.- OHLCV bars are validated before analysis: non-finite values, negative prices, negative volume, and impossible high/low relationships are rejected.
- MCP enum inputs such as analyzer
mode, volume scan filters, and pivot scan filters are validated before market data is fetched.
"Show me top 10 crypto gainers on Binance in the last 15 minutes"
"Find coins with Bollinger Band squeeze on Binance"
"Analyze BTCUSDT with basic technical indicators"
"Show volume breakouts on Bybit with RSI oversold filter"
"Analyze ETHUSDT using Dow Theory on the daily timeframe"
"Check Ichimoku signals for BTCUSDT on 4h"
"Find Wyckoff accumulation patterns on SOLUSDT"
"Detect harmonic patterns on BTCUSDT 4h chart"
"Find trending memecoins on Solana"
"Discover new tokens on Base with at least $50k liquidity"
┌─────────────────────────────────────────────────────────────┐
│ AI Platforms │
│ Claude.ai │ ChatGPT │ Claude Desktop │ Other MCP │
└──────┬──────┴─────┬─────┴───────┬──────────┴───────┬───────┘
│ HTTPS+OAuth│ │ stdio │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ SigmaPilot MCP Server │
│ ┌───────────┐ ┌──────────────┐ ┌───────────────────────┐│
│ │ Scanners │ │ Analyzers │ │ DEX Discovery ││
│ │ (6 tools) │ │ (10 tools) │ │ (1 tool) ││
│ └─────┬─────┘ └──────┬───────┘ └──────────┬────────────┘│
│ │ │ │ │
│ ┌─────▼───────────────▼──────────────────────▼───────────┐│
│ │ Core Infrastructure ││
│ │ Confidence Scoring │ Caching │ Rate Limiting │ Schemas ││
│ └─────┬───────────────────────────────────────┬──────────┘│
│ │ │ │
│ ┌─────▼─────────────┐ ┌─────────────────────▼──────────┐│
│ │ Auth0 + Middleware│ │ PostgreSQL (optional) ││
│ │ JWT Verification │ │ Users │ Quotas │ Activity Log ││
│ └───────────────────┘ └────────────────────────────────┘│
└────────┬───────────────────────────────┬──────────────────┘
│ │
┌─────▼─────────────┐ ┌────────────▼────────────────┐
│ TradingView │ │ GeckoTerminal │
│ CEX + Stocks │ │ DEX (Solana, BSC, ETH...) │
└───────────────────┘ └─────────────────────────────┘
When deployed with a PostgreSQL database (DATABASE_URL), the server provides:
- Auto-Registration - Users created automatically on first Auth0 login
- Admin Dashboard - Web UI at
/adminfor user management - Admin Auto-Setup - Configure
ADMIN_USER_IDSenv var to auto-promote admins - User Revocation - Revoke/restore user access with reason tracking and audit logging
- Activity Logging - Full audit trail of all tool calls with timing and error tracking
- Subscription Tiers - Free/Pro/Enterprise with configurable limits
- Usage Tracking - Per-user request counting with per-tool breakdown
- Rate Limiting - Configurable requests per minute/hour limits
- Graceful Degradation - Continues serving if database is temporarily unavailable
- IP/Email/User Blocking - Block suspicious actors by multiple identifiers
- Audit Events - Comprehensive security event logging
- User Status Management - Active/Suspended/Revoked states
# Clone and install
git clone https://github.com/SigmaPilotAI/sigmapilot-mcp.git
cd sigmapilot-mcp
uv sync --dev
# Run tests
make test
# Run with coverage
make test-cov
# Lint and format
make lint
make format
# Typecheck uses local third-party stubs from typings/
uv run mypy src/
# Run locally (stdio mode for Claude Desktop)
uv run python src/sigmapilot_mcp/server.py
# Run as HTTP server (development mode, no auth)
uv run python src/sigmapilot_mcp/server.py streamable-http --port 8000
# Run as HTTP server with Auth0 authentication
AUTH0_DOMAIN=your-tenant.auth0.com AUTH0_AUDIENCE=https://your-api \
uv run python src/sigmapilot_mcp/server.py streamable-http --auth- Architecture Overview - System design, data flow, key decisions
- Remote Deployment Guide - Railway + Auth0 setup
- Installation Guide - Local setup and configuration
- Usage Examples - All 17 tools with sample inputs/outputs
- Migration Guide - Upgrading from v1.x to v2.x
- Contributing - Development guidelines and standards
- Development TODO - Roadmap and known limitations
Shared agent guidance can be committed under .claude/agent.md, .claude/AGENT.md, .claude/agents.md, .claude/AGENTS.md, and .claude/skills/**. Keep secrets and editor-local state out of those files.
Proprietary - see LICENSE