{
  "$schema": "https://raw.githubusercontent.com/modelcontextprotocol/specification/main/schema/server-card.json",
  "version": "1.0",
  "protocolVersion": "2024-11-05",
  "serverInfo": {
    "name": "Darbs Quantitative Signal Engine",
    "version": "1.0.0",
    "description": "Institutional market verification, 4-factor quantitative scoring, darkpool flow tracking, and directional signals for equities and cryptocurrencies.",
    "homepage": "https://darbsignal.com",
    "documentationUrl": "https://darbsignal.com/docs/api",
    "iconUrl": "https://darbsignal.com/favicon.png"
  },
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://darbsignal.com/mcp"
  },
  "transports": [
    {
      "type": "streamable-http",
      "endpoint": "https://darbsignal.com/mcp"
    },
    {
      "type": "sse",
      "endpoint": "https://darbsignal.com/sse"
    }
  ],
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {
      "subscribe": false,
      "listChanged": false
    },
    "prompts": {
      "listChanged": false
    },
    "logging": {}
  },
  "authentication": {
    "required": false,
    "schemes": [
      {
        "type": "bearer",
        "description": "Optional Bearer token for institutional rate limit tier"
      },
      {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      },
      {
        "type": "oauth2",
        "authorizationUrl": "https://darbsignal.com/oauth/authorize",
        "tokenUrl": "https://darbsignal.com/oauth/token",
        "scopes": {
          "signals:read": "Read real-time quantitative scores and directional market signals",
          "darkpool:read": "Access institutional darkpool transaction flow and block trades",
          "factor:read": "Inspect 4-factor quantitative breakdown",
          "alerts:write": "Register webhook alert triggers"
        }
      }
    ]
  },
  "tools": [
    {
      "name": "get_market_signal",
      "description": "Fetch the real-time Darbs composite quantitative score (0-100), market bias (LONG/SHORT/WAIT), price, and 4-factor breakdown (social sentiment, technical momentum, valuation premium, and institutional darkpool flow) for any stock or cryptocurrency.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "The stock ticker or crypto symbol (e.g. AAPL, NVDA, TSLA, BTC, ETH, SPY, MSFT, GLD)."
          }
        },
        "required": [
          "symbol"
        ]
      }
    },
    {
      "name": "list_available_tickers",
      "description": "Retrieve all actively tracked equities, indices, commodities, and cryptocurrencies with their current Darbs Scores and price changes.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "description": "Filter tickers by category.",
            "enum": [
              "all",
              "Tech",
              "Crypto",
              "Index",
              "Commodity"
            ],
            "default": "all"
          }
        }
      }
    },
    {
      "name": "calculate_darbs_score",
      "description": "Compute a simulated composite Darbs Score (0-100) and directional signal bias by passing 4 custom factor weights.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "socialSentiment": {
            "type": "number",
            "description": "Social NLP sentiment score (0 to 100). Weight: 25%",
            "minimum": 0,
            "maximum": 100
          },
          "technicalMomentum": {
            "type": "number",
            "description": "Technical momentum & RSI indicator score (0 to 100). Weight: 25%",
            "minimum": 0,
            "maximum": 100
          },
          "valuationPremium": {
            "type": "number",
            "description": "Fundamental valuation & balance sheet factor (0 to 100). Weight: 25%",
            "minimum": 0,
            "maximum": 100
          },
          "institutionalFlow": {
            "type": "number",
            "description": "Dark pool orderflow & Form 4 insider transaction score (0 to 100). Weight: 25%",
            "minimum": 0,
            "maximum": 100
          }
        },
        "required": [
          "socialSentiment",
          "technicalMomentum",
          "valuationPremium",
          "institutionalFlow"
        ]
      }
    },
    {
      "name": "search_market_intelligence",
      "description": "Search the Darbs quantitative methodology, frequently asked questions (FAQs), SEC filing rules, and institutional research publications.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "The keyword or question to search (e.g. 'darkpool', 'SEC Form 4', 'RSI momentum', 'crypto liquidity', 'API access')."
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "request_beta_access",
      "description": "Submit an application for early beta access or institutional API keys to receive real-time Darbs quantitative signals and endpoints.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Full name or organization name of the applicant."
          },
          "email": {
            "type": "string",
            "description": "Valid contact email address."
          },
          "focus": {
            "type": "string",
            "description": "Trading focus area.",
            "enum": [
              "retail",
              "quant",
              "fund",
              "general"
            ],
            "default": "retail"
          }
        },
        "required": [
          "name",
          "email"
        ]
      }
    },
    {
      "name": "get_methodology_formula",
      "description": "Retrieve the mathematical formulation and normalization steps for the 4-factor Darbs Score.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    }
  ]
}