{"$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":"Agent-Ready Market Research 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). Research only — no trading.","keywords":["Predictive Alpha","On-chain Market Intelligence","x402 Monetized API","Agent-Ready Market Research Data","Crypto Volatility Alerts","Sentiment Aggregation","MCP Server","AgentCash","Base USDC"],"homepage":"https://alpha-sentinel-mcp.vercel.app","documentation":"https://alpha-sentinel-mcp.vercel.app/docs","llms_txt":"https://alpha-sentinel-mcp.vercel.app/llms.txt","playbooks":[{"slug":"automate-volatility-alerts","title":"How to Automate Crypto Volatility Alerts for Research Agents","url":"https://alpha-sentinel-mcp.vercel.app/docs/automate-volatility-alerts"},{"slug":"integrate-predictive-alpha","title":"Integrating Predictive Alpha Feeds via MCP & x402","url":"https://alpha-sentinel-mcp.vercel.app/docs/integrate-predictive-alpha"},{"slug":"reduce-slippage-sentiment","title":"Grounding Agent Research with Real-Time Sentiment Aggregation","url":"https://alpha-sentinel-mcp.vercel.app/docs/reduce-slippage-sentiment"}],"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"}],"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 Agent-Ready Market Research Data; research only)","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":false,"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}},{"name":"tokenized_stock_list","description":"List Coinbase tokenized stocks on Base (read-only catalog).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.01 USD per call","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Optional name/symbol/ISIN filter"},"page_size":{"type":"integer","minimum":1,"maximum":100,"default":25},"page_token":{"type":"string"}}},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_lookup","description":"Lookup metadata for one tokenized stock (contract, ISIN, multiplier, prospectus).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.01 USD per call","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1,"description":"Token ticker e.g. CRCLc"}},"required":["symbol"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_nav_deviation","description":"Compare Chainlink NAV/reference to underlying equity spot (research spread).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.02 USD per call","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1}},"required":["symbol"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_corporate_action","description":"Fetch one announced/applied corporate action by UUID (from onchain Announcement URI).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.02 USD per call","inputSchema":{"type":"object","properties":{"corporate_action_id":{"type":"string","description":"UUID from Announcement event URI"}},"required":["corporate_action_id"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_research_brief","description":"Multi-symbol research brief: metadata, NAV staleness, deviation notes.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.05 USD per call","inputSchema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},"required":["symbols"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_seal_receipt","description":"Seal a Proof-of-Research receipt hash on Base (ResearchReceiptRegistry).\n\nPrepares unsigned calldata by default; optional Sepolia submit via env. Not trading.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.03 USD per call","inputSchema":{"type":"object","properties":{"content_hash":{"type":"string","description":"0x-prefixed SHA-256 of canonical brief JSON"},"brief_id":{"type":"string"}},"required":["content_hash"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_peg_gap_radar","description":"Peg-Gap Radar: onchain DEX price vs underlying reference, alerts over threshold %.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.03 USD per call","inputSchema":{"type":"object","properties":{"alert_threshold_pct":{"type":"number","default":2.0,"minimum":0.1,"maximum":50.0},"page_size":{"type":"integer","default":40,"minimum":1,"maximum":100},"symbols":{"type":"array","items":{"type":"string"}}}},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true},{"name":"tokenized_stock_model_portfolio","description":"Model portfolio / rebalance suggestions (weights only — no orders).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.08 USD per call","inputSchema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":12},"current_weights":{"type":"object","additionalProperties":{"type":"number"}},"objective":{"type":"string","enum":["balanced","low_staleness_nav","diversified"],"default":"balanced"}},"required":["symbols"]},"requires_env":false,"tier_access":{"free":false,"pro":true},"stocksmaxxing":true}]}},"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":false,"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"},{"name":"tokenized_stock_list","description":"List Coinbase tokenized stocks on Base (read-only catalog).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.01 USD per call","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Optional name/symbol/ISIN filter"},"page_size":{"type":"integer","minimum":1,"maximum":100,"default":25},"page_token":{"type":"string"}}},"price":"$0.01","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_list"},{"name":"tokenized_stock_lookup","description":"Lookup metadata for one tokenized stock (contract, ISIN, multiplier, prospectus).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.01 USD per call","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1,"description":"Token ticker e.g. CRCLc"}},"required":["symbol"]},"price":"$0.01","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_lookup"},{"name":"tokenized_stock_nav_deviation","description":"Compare Chainlink NAV/reference to underlying equity spot (research spread).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.02 USD per call","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","minLength":1}},"required":["symbol"]},"price":"$0.02","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_nav_deviation"},{"name":"tokenized_stock_corporate_action","description":"Fetch one announced/applied corporate action by UUID (from onchain Announcement URI).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.02 USD per call","inputSchema":{"type":"object","properties":{"corporate_action_id":{"type":"string","description":"UUID from Announcement event URI"}},"required":["corporate_action_id"]},"price":"$0.02","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_corporate_action"},{"name":"tokenized_stock_research_brief","description":"Multi-symbol research brief: metadata, NAV staleness, deviation notes.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.05 USD per call","inputSchema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},"required":["symbols"]},"price":"$0.05","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_research_brief"},{"name":"tokenized_stock_seal_receipt","description":"Seal a Proof-of-Research receipt hash on Base (ResearchReceiptRegistry).\n\nPrepares unsigned calldata by default; optional Sepolia submit via env. Not trading.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offer","inputSchema":{"type":"object","properties":{"content_hash":{"type":"string","description":"0x-prefixed SHA-256 of canonical brief JSON"},"brief_id":{"type":"string"}},"required":["content_hash"]},"price":"$0.03","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_seal_receipt"},{"name":"tokenized_stock_peg_gap_radar","description":"Peg-Gap Radar: onchain DEX price vs underlying reference, alerts over threshold %.\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.03 USD per call","inputSchema":{"type":"object","properties":{"alert_threshold_pct":{"type":"number","default":2.0,"minimum":0.1,"maximum":50.0},"page_size":{"type":"integer","default":40,"minimum":1,"maximum":100},"symbols":{"type":"array","items":{"type":"string"}}}},"price":"$0.03","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_peg_gap_radar"},{"name":"tokenized_stock_model_portfolio","description":"Model portfolio / rebalance suggestions (weights only — no orders).\n\nRESEARCH ONLY — not investment advice. No trading, execution, custody, or swaps. Coinbase tokenized stocks are not offered to U.S. persons.\n\n**Cost:** $0.08 USD per call","inputSchema":{"type":"object","properties":{"symbols":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":12},"current_weights":{"type":"object","additionalProperties":{"type":"number"}},"objective":{"type":"string","enum":["balanced","low_staleness_nav","diversified"],"default":"balanced"}},"required":["symbols"]},"price":"$0.08","free_tier":false,"endpoint":"https://alpha-sentinel-mcp.vercel.app/tools/tokenized_stock_model_portfolio"}],"count":13,"http_base":"https://alpha-sentinel-mcp.vercel.app/tools"}