{ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json", "schema_version": "1.0", "protocolVersion": "2024-11-05", "name": "io.github.kwizzlesurp10-ctrl/alpha-sentinel-mcp", "title": "Alpha Sentinel — Predictive Alpha & On-chain Market Intelligence", "version": "0.2.0", "description": "Autonomous Trading Data & On-chain Market Intelligence MCP Server. Provides statistical Z-score volatility alerts, multi-source sentiment aggregation, multi-factor crypto risk scoring, and executive market intelligence reports via x402 Monetized API (USDC on Base).", "keywords": [ "Predictive Alpha", "On-chain Market Intelligence", "x402 Monetized API", "Autonomous Trading Data", "Crypto Volatility Alerts", "Sentiment Aggregation", "MCP Server", "AgentCash", "Base USDC" ], "homepage": "https://kwizzlesurp.com", "documentation": "https://kwizzlesurp.com/docs/", "llms_txt": "https://kwizzlesurp.com/llms.txt", "playbooks": [ { "slug": "automate-volatility-alerts", "title": "How to Automate Crypto Volatility Alerts for Trading Bots", "url": "https://kwizzlesurp.com/docs/automate-volatility-alerts.html" }, { "slug": "integrate-predictive-alpha", "title": "Integrating Predictive Alpha Feeds via MCP & x402", "url": "https://kwizzlesurp.com/docs/integrate-predictive-alpha.html" }, { "slug": "reduce-slippage-sentiment", "title": "Reducing Slippage with Real-Time Sentiment Aggregation", "url": "https://kwizzlesurp.com/docs/reduce-slippage-sentiment.html" } ], "x402": { "version": 2, "network": "eip155:8453", "asset": "USDC", "discovery": "https://alpha-sentinel-mcp.vercel.app/.well-known/x402", "payment_header": "PAYMENT-SIGNATURE", "challenge_header": "PAYMENT-REQUIRED", "receipt_header": "PAYMENT-RESPONSE" }, "remotes": [ { "type": "streamable-http", "url": "https://alpha-sentinel-mcp.vercel.app/mcp" }, { "type": "streamable-http", "url": "https://x402-mcp.onrender.com/mcp" } ], "mcpServers": { "alpha-sentinel": { "url": "https://alpha-sentinel-mcp.vercel.app/mcp", "type": "streamable-http", "transport": "streamable-http", "command": "python", "args": [ "run_stdio.py" ], "description": "Alpha Sentinel — Predictive Alpha & On-chain Market Intelligence (x402 Monetized API for Autonomous Trading Data)", "tools": [ { "name": "fetch_price", "description": "Fetch real-time cryptocurrency price from CoinGecko API.\n \nReturns current price, 24h change, and trading volume for any supported cryptocurrency.\n\n**Use Case:** Get instant price data before executing trades or analyzing positions.\n\n**Cost:** $0.005 USD per call (cheapest tier - high frequency allowed)\n\n**Example Response:**\n{\n \"symbol\": \"bitcoin\",\n \"price_usd\": 67842.50,\n \"change_24h\": 2.34,\n \"volume_24h\": 28500000000,\n \"timestamp\": \"2026-08-24T15:30:00Z\"\n}", "inputSchema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Cryptocurrency symbol (e.g., 'btc', 'eth', 'sol')", "minLength": 1 } }, "required": [ "symbol" ] }, "requires_env": false, "tier_access": { "free": true, "pro": true } }, { "name": "analyze_volatility", "description": "Analyze price volatility using statistical Z-score anomaly detection.\n \nCalculates standard deviations from mean price to detect anomalous movements.\nConfigurable thresholds and time windows for customized analysis.\n\n**Use Case:** Identify unusual price movements before they become obvious trends.\n\n**Cost:** $0.02 USD per call\n\n**Parameters:**\n- `symbol`: Crypto symbol to analyze\n- `window_minutes`: Historical window (1-1440 min, default: 60)\n- `z_threshold`: Std dev threshold for anomalies (0.1-5.0σ, default: 2.0)\n\n**Alert Levels:** NORMAL → MODERATE → HIGH → CRITICAL", "inputSchema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Cryptocurrency symbol" }, "window_minutes": { "type": "integer", "default": 60, "minimum": 1, "maximum": 1440, "description": "Analysis window in minutes" }, "z_threshold": { "type": "number", "default": 2.0, "minimum": 0.1, "maximum": 5.0, "description": "Z-score threshold for anomalies" } }, "required": [ "symbol" ] }, "requires_env": false, "tier_access": { "free": false, "pro": true } }, { "name": "aggregate_sentiment", "description": "Aggregate social media sentiment across multiple sources.\n \nCombines Twitter/X, Reddit, and other platforms into unified sentiment scores (-1.0 to +1.0).\nDetects momentum shifts and trend changes in community opinion.\n\n**Use Case:** Gauge market psychology before major moves.\n\n**Cost:** $0.01 USD per call\n\n**Sources:** twitter, reddit, telegram, news\n\n**Output:** Overall sentiment category (bullish/neutral/bearish) with breakdown by source.", "inputSchema": { "type": "object", "properties": { "symbols": { "type": "array", "items": { "type": "string" }, "description": "List of crypto symbols to analyze", "minItems": 1 }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "twitter", "reddit", "telegram", "news" ] }, "default": [ "twitter", "reddit" ], "description": "Data sources to query" }, "window_minutes": { "type": "integer", "default": 60, "minimum": 5, "maximum": 1440, "description": "Time window for sentiment history" } }, "required": [ "symbols" ] }, "requires_env": true, "tier_access": { "free": false, "pro": true } }, { "name": "calculate_risk_score", "description": "Calculate multi-factor risk assessment for cryptocurrencies.\n \nCombines volatility, liquidity, market cap tier, and Bitcoin correlation into\na comprehensive risk score (0-1 scale) with actionable recommendations.\n\n**Use Case:** Assess position sizing and stop-loss levels.\n\n**Cost:** $0.03 USD per call\n\n**Risk Levels:** LOW | MEDIUM | HIGH | CRITICAL\n\n**Factors Analyzed:**\n- Volatility risk (40% weight)\n- Liquidity risk (25% weight)\n- Market cap tier (20% weight)\n- BTC correlation (15% weight)", "inputSchema": { "type": "object", "properties": { "symbols": { "type": "array", "items": { "type": "string" }, "description": "List of crypto symbols to assess", "minItems": 1 }, "include_factors": { "type": "array", "items": { "type": "string", "enum": [ "volatility", "liquidity", "correlation" ] }, "default": [ "volatility", "liquidity", "correlation" ], "description": "Risk factors to analyze" } }, "required": [ "symbols" ] }, "requires_env": false, "tier_access": { "free": false, "pro": true } }, { "name": "generate_market_report", "description": "Generate comprehensive market intelligence report.\n \nSynthesizes price, volatility, sentiment, and risk data into actionable insights.\nPerfect for daily briefings or strategic planning.\n\n**Use Case:** End-of-day summary or pre-trade due diligence.\n\n**Cost:** $0.15 USD per report\n\n**Report Types:**\n- daily: 24-hour overview\n- weekly: 7-day trends \n- monthly: 30-day strategic analysis\n\n**Includes:** Executive summary, key signals, actionable recommendations", "inputSchema": { "type": "object", "properties": { "report_type": { "type": "string", "enum": [ "daily", "weekly", "monthly" ], "default": "daily", "description": "Type of report to generate" }, "symbols": { "type": "array", "items": { "type": "string" }, "default": [ "bitcoin", "ethereum" ], "description": "Cryptocurrencies to include" }, "format": { "type": "string", "enum": [ "json", "pdf" ], "default": "json", "description": "Output format" } }, "required": [] }, "requires_env": false, "tier_access": { "free": false, "pro": true } } ] }, "x402-mcp": { "url": "https://x402-mcp.onrender.com/mcp", "type": "streamable-http", "transport": "streamable-http", "description": "Kwizzle A2A Commerce & US Municipal Compliance API Gateway on Base L2 (x402 v2 micropayments)", "discovery": "https://x402-mcp.onrender.com/.well-known/mcp/server-card.json" } }, "url": "https://alpha-sentinel-mcp.vercel.app/mcp", "streamableHttpUrl": "https://alpha-sentinel-mcp.vercel.app/mcp", "transport": "streamable-http", "tools": [ { "name": "fetch_price", "description": "Fetch real-time cryptocurrency price from CoinGecko API.\n \nReturns current price, 24h change, and trading volume for any supported cryptocurrency.\n\n**Use Case:** Get instant price data before executing trades or analyzing positions.\n\n**Cost:** $0.005 USD per call (cheapest", "inputSchema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Cryptocurrency symbol (e.g., 'btc', 'eth', 'sol')", "minLength": 1 } }, "required": [ "symbol" ] }, "price": "$0.005", "free_tier": true, "endpoint": "https://alpha-sentinel-mcp.vercel.app/tools/fetch_price" }, { "name": "analyze_volatility", "description": "Analyze price volatility using statistical Z-score anomaly detection.\n \nCalculates standard deviations from mean price to detect anomalous movements.\nConfigurable thresholds and time windows for customized analysis.\n\n**Use Case:** Identify unusual price movements before th", "inputSchema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Cryptocurrency symbol" }, "window_minutes": { "type": "integer", "default": 60, "minimum": 1, "maximum": 1440, "description": "Analysis window in minutes" }, "z_threshold": { "type": "number", "default": 2.0, "minimum": 0.1, "maximum": 5.0, "description": "Z-score threshold for anomalies" } }, "required": [ "symbol" ] }, "price": "$0.02", "free_tier": false, "endpoint": "https://alpha-sentinel-mcp.vercel.app/tools/analyze_volatility" }, { "name": "aggregate_sentiment", "description": "Aggregate social media sentiment across multiple sources.\n \nCombines Twitter/X, Reddit, and other platforms into unified sentiment scores (-1.0 to +1.0).\nDetects momentum shifts and trend changes in community opinion.\n\n**Use Case:** Gauge market psychology before major mov", "inputSchema": { "type": "object", "properties": { "symbols": { "type": "array", "items": { "type": "string" }, "description": "List of crypto symbols to analyze", "minItems": 1 }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "twitter", "reddit", "telegram", "news" ] }, "default": [ "twitter", "reddit" ], "description": "Data sources to query" }, "window_minutes": { "type": "integer", "default": 60, "minimum": 5, "maximum": 1440, "description": "Time window for sentiment history" } }, "required": [ "symbols" ] }, "price": "$0.01", "free_tier": false, "endpoint": "https://alpha-sentinel-mcp.vercel.app/tools/aggregate_sentiment" }, { "name": "calculate_risk_score", "description": "Calculate multi-factor risk assessment for cryptocurrencies.\n \nCombines volatility, liquidity, market cap tier, and Bitcoin correlation into\na comprehensive risk score (0-1 scale) with actionable recommendations.\n\n**Use Case:** Assess position sizing and stop-loss levels.\n", "inputSchema": { "type": "object", "properties": { "symbols": { "type": "array", "items": { "type": "string" }, "description": "List of crypto symbols to assess", "minItems": 1 }, "include_factors": { "type": "array", "items": { "type": "string", "enum": [ "volatility", "liquidity", "correlation" ] }, "default": [ "volatility", "liquidity", "correlation" ], "description": "Risk factors to analyze" } }, "required": [ "symbols" ] }, "price": "$0.03", "free_tier": false, "endpoint": "https://alpha-sentinel-mcp.vercel.app/tools/calculate_risk_score" }, { "name": "generate_market_report", "description": "Generate comprehensive market intelligence report.\n \nSynthesizes price, volatility, sentiment, and risk data into actionable insights.\nPerfect for daily briefings or strategic planning.\n\n**Use Case:** End-of-day summary or pre-trade due diligence.\n\n**Cost:** $0.15 USD per ", "inputSchema": { "type": "object", "properties": { "report_type": { "type": "string", "enum": [ "daily", "weekly", "monthly" ], "default": "daily", "description": "Type of report to generate" }, "symbols": { "type": "array", "items": { "type": "string" }, "default": [ "bitcoin", "ethereum" ], "description": "Cryptocurrencies to include" }, "format": { "type": "string", "enum": [ "json", "pdf" ], "default": "json", "description": "Output format" } }, "required": [] }, "price": "$0.15", "free_tier": false, "endpoint": "https://alpha-sentinel-mcp.vercel.app/tools/generate_market_report" } ], "count": 5, "http_base": "https://alpha-sentinel-mcp.vercel.app/tools" }