{
  "schema_version": "1.0",
  "name": "FinanceSec MCP Domain",
  "description": "Financial SEC 10-K/10-Q Volumetric Lattice Network MCP agent discovery and dynamic query service.",
  "version": "0.3.8",
  "capabilities": {
    "tools": true,
    "prompts": true,
    "resources": true
  },
  "endpoints": {
    "mcp": "https://finsec.caleralabs.com/mcp",
    "query": "https://financesec.api.caleralabs.com/api/query",
    "chat_completions": "https://icx.api.caleralabs.com/v1/chat/completions",
    "icx_sync": "https://icx.api.caleralabs.com/api/icx/sync"
  },
  "tools": [
    {
      "name": "query_financial_sec",
      "description": "Certified SEC fact query. Returns verified values with provenance or SAFE_REFUSAL. Does not invent numbers. Treat SAFE_REFUSAL as success-of-honesty, not a tool failure. Monetary answers default to the filer's reporting currency; request FX conversion via target_currency / usd_only or natural-language 'in USD'.",
      "endpoint": "/api/query",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Natural language financial question. Append 'in USD' (or another supported ISO code) to convert foreign reporting currencies after verified recall."
          },
          "target_currency": {
            "type": "string",
            "description": "Optional ISO 4217 code (e.g. USD, EUR) for post-recall FX conversion using audited annual-average rates. Provenance records original_unit, fx_rate, and fx_converted."
          },
          "usd_only": {
            "type": "boolean",
            "description": "When true, forces monetary answers into USD."
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "compute_sec_cagr",
      "description": "Domain 31 lattice CAGR over verified EDGAR facts (log-walk + Go parity). Refuses non-positive or missing endpoints.",
      "endpoint": "/api/query",
      "parameters": {
        "type": "object",
        "properties": {
          "company": {
            "type": "string",
            "description": "Company ticker or name, e.g. AAPL"
          },
          "metric": {
            "type": "string",
            "description": "EDGAR metric to compound, e.g. revenue, free cash flow, net income"
          },
          "start_period": {
            "type": "string",
            "description": "Start fiscal period, e.g. FY2020"
          },
          "end_period": {
            "type": "string",
            "description": "End fiscal period, e.g. FY2023"
          },
          "low_tokens": {
            "type": "boolean",
            "description": "Optional. When true, returns compact schema."
          }
        },
        "required": [
          "company",
          "metric",
          "start_period",
          "end_period"
        ]
      }
    },
    {
      "name": "valuation_inputs",
      "description": "Certified SEC/EDGAR valuation inputs pack (12 packs: equity_screen, ev_bridge, quality_of_earnings, segment_mix, returns_screen, leverage_screen, piotroski_f, altman_z_prime, beneish_m_score, dupont_5step, working_capital_efficiency, dcf_valuation_inputs).",
      "endpoint": "/api/query",
      "parameters": {
        "type": "object",
        "properties": {
          "company": {
            "type": "string",
            "description": "Company ticker or name, e.g. AAPL, TSLA, MSFT"
          },
          "pack": {
            "type": "string",
            "description": "Certified SEC valuation pack ID (equity_screen, ev_bridge, quality_of_earnings, segment_mix, returns_screen, leverage_screen, piotroski_f, altman_z_prime, beneish_m_score, dupont_5step, working_capital_efficiency, dcf_valuation_inputs)"
          },
          "period": {
            "type": "string",
            "description": "Optional reporting period, e.g. FY2023. Defaults to FY2023."
          },
          "low_tokens": {
            "type": "boolean",
            "description": "Optional. When true, returns compact schema."
          }
        },
        "required": [
          "company",
          "pack"
        ]
      }
    }
  ]
}