Calera FINSEC — Certified SEC Memory

FINSEC — 经认证的 SEC 记忆 MCP 服务

面向 Calera Labs FINSEC 的官方 Model Context Protocol (MCP) 连接器。它将 AI Agent（Claude Desktop、Cursor、Zed、VS Code 以及自定义自主集群）直接连接到由 Calera Episteme-1 Engine 提供支持的 406 万条经认证的 SEC EDGAR 事实。

“前沿模型负责推理——Calera Lattice 提供真实依据。”

---

⚡ 核心保障

• **0.00% 统计性幻觉：**事实检索是确定性且基于几何结构的（$A_4$ Pentatope 晶格记忆）。事实检索路径中不存在语言模型。
• **2026-07-28 无状态协议核心：**完全符合 2026-07-28 无状态 MCP 规范（SEP-2243、SEP-2575、SEP-2549），支持低于 5 毫秒的零握手直接工具调用和智能缓存（ttlMs: 86400000）。
• **密码学溯源：**每项返回的财务指标都包含准确的 SEC 文件提交编号、日期、概念和 SHA-256 审计哈希。
• **诚实拒绝（SAFE_REFUSAL）：**如果某项指标未出现在 SEC 官方文件中或存在歧义，引擎会安全、如实地拒绝，而不是编造数字。
• **超低延迟与高毛利率：**响应序列化时间低于 25 毫秒，并支持低令牌占用模式。

---

🚀 一键快速集成

1. Cursor IDE

将以下内容添加到项目的 .cursor/mcp.json（或 Cursor 全局设置 → 功能 → MCP）：

{
  "mcpServers": {
    "finsec": {
      "url": "https://finsec.caleralabs.com/mcp",
      "headers": {
        "X-License-Key": "clabs_live_YOUR_KEY"
      }
    }
  }
}

（在 dashboard.caleralabs.com 获取免费 API 密钥）

---

2. Claude Desktop

添加到 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "finsec": {
      "url": "https://finsec.caleralabs.com/mcp",
      "headers": {
        "X-License-Key": "clabs_live_YOUR_KEY"
      }
    }
  }
}

---

3. Smithery CLI（一键终端命令）

使用 Smithery 在 Claude 或 Cursor 中自动安装（smithery.ai/servers/calera-labs/finsec）：

# For Claude Desktop
npx -y @smithery/cli install financesec-mcp --client claude

# For Cursor
npx -y @smithery/cli install financesec-mcp --client cursor

---

4. Zed Editor

添加到 ~/.config/zed/settings.json：

{
  "experimental.context_servers": {
    "finsec": {
      "command": {
        "url": "https://finsec.caleralabs.com/mcp",
        "headers": {
          "X-License-Key": "clabs_live_YOUR_KEY"
        }
      }
    }
  }
}

---

5. Stdio JSON-RPC 与零配置自动桥接

对于使用 stdio 的本地 Agent 工作流（Cursor、Claude Code、Antigravity 或自定义运行器）：

{
  "mcpServers": {
    "finsec": {
      "command": "npx",
      "args": ["-y", "@caleralabs/finsec-mcp"]
    }
  }
}

🔗 零配置跨 MCP 凭据共享

通过 stdio 执行时，@caleralabs/finsec-mcp 会自动发现并关联存储在 ~/.calera/icx.env 中的凭据，或运行 @caleralabs/llm-vm-mcp（claim_free_icx_tokens）时创建的凭据。

一个 Calera API 密钥（ICX_API_KEY）即可统一整个 AI 技术栈：

• **FINSEC 真实依据：**406 万条经认证的 SEC EDGAR 事实，零幻觉。
• **LLM-VM 执行：**密闭、零逃逸的 MicroVM 沙箱。
• **ICX 记忆：**跨 Agent 会话共享的无限上下文记忆空间。

---

🛠️ 认证工具范围

FINSEC MCP 服务提供 7 个认证工具：

工具名称	描述
query_financial_sec	使用自然语言查询 406 万条经认证的 SEC EDGAR 事实，并提供来源信息或如实返回 SAFE_REFUSAL。
valuation_inputs	12 个认证估值包（DCF 输入、FCF、Altman Z'、Beneish M、杜邦 5 步分析、Piotroski F）。
query_sec_metric_exact	精确检索公司、期间和概念对应的单个 EDGAR 指标。
compute_sec_cagr	基于已验证 SEC 文件事实，精确计算复合年增长率（CAGR），杜绝臆造。
lattice_arith_evaluate	确定性、零误差的代数求解器（cagr、ratio、multiply、divide、yoy_series、product_chain）。
vln_capabilities_overview	动态介绍服务范围与能力边界。
query_sec_sector_peers	多家公司行业与领域财务对比。

---

💡 适用于 Agent 的查询示例

连接后，只需用日常英语向 Agent 提问：

• “Apple 2023 财年的总收入和毛利率（美元）是多少？”
• “比较 Microsoft 和 Alphabet 2024 年第三季度的营业收入。”
• “计算 Nvidia 从 2021 财年到 2024 财年的 3 年收入 CAGR。”
• “获取 Tesla 2023 年杜邦 5 步分析的输入数据。”

---

🏎️ 高 QPS Agent 集群的低 Token 模式

为避免多轮推理 Agent 的上下文耗尽，可在查询中传入 "low_tokens": true，从而减少 71.7% 的 Token 消耗：

{
  "id": "q112",
  "st": "OK",
  "val": 383285000000,
  "cur": "USD",
  "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
  "per": "FY2023",
  "hash": "5ce23625"
}

---

🔑 身份验证与 API 密钥

在 Universal Dashboard 上生成免费或企业 API 密钥：
👉 https://dashboard.caleralabs.com

---

🛡️ 安全与来源政策

• 事实处理链路中不使用语言模型： 所有返回的数字均来自 XBRL/EDGAR 文件表格，并通过 SEC accession 编号核验。
• IP 云边界： 基础算法与 $A_4$ Pentatope 晶格权重在 Calera Labs 安全云运行环境中运行。公共客户端仅接收已验证的结果和架构响应。

---

💬 客户支持与即时 Slack 响应流程

有疑问、遇到边缘情况，或需要为团队提高配额？

我们设有 3 级 Slack 客户响应流程，直接连接工程团队和管理团队：

1. 直接在 AI 助手中（Claude、Cursor、Zed、Cline）

使用内置 MCP 工具 submit_support_ticket：

{
  "title": "Need 50k req/min quota for quant backtesting cluster",
  "description": "We are running systematic macro backtests across 500 tickers simultaneously.",
  "inquiry_type": "quota_increase",
  "priority": "high",
  "contact_email": "[email protected]"
}

2. 在线门户与 Slack 升级处理中心

通过 Universal Dashboard 直接提交工单、问题或功能请求： 👉 https://dashboard.caleralabs.com/dashboard#customer_service

3. 响应 SLA

级别	响应人员	SLA 保证
1 级（普通）	客户成功经理（@manager_oncall）	< 4 小时
2 级（高优先级／配额）	运营负责人（@owner_oncall）	< 2 小时
3 级（紧急／VIP）	创始人兼 CEO Casey（@casey）	< 1 小时

---

🔗 相关 Calera MCP 服务

• Calera Infinite Context (ICX) MCP： 面向 AI Agent 的持久认知记忆，以及基于 Volumetric Lattice Network、低于 5 毫秒的联想检索（Glama Hub · Smithery）。

---

📄 许可证与致谢

• 连接器规范和客户端架构采用 Apache-2.0 License 许可。
• 由 Calera Episteme-1 / Calera Labs 提供支持（Pyrotope Inc. 的 DBA，Calera Computing, Inc. 的子公司）。