OCOLO Project Requests

OCOLO 项目需求 API（适用于 AI Agent）

代表某个人，从任何 AI Agent 向 OCOLO 提交数据中心托管需求。OCOLO 是一家托管服务经纪商，拥有由 270 多家数据中心服务商组成的网络；提交一次即可将需求发送给所有服务商，OCOLO 会在 2-3 个工作日内向联系人提供最佳选项。无需 API 密钥，也无需账户：联系人通过电子邮件确认。

• 人类用户指南：https://www.ocolo.io/for-agents/
• OpenAPI 3.1：https://www.ocolo.io/api/v1/openapi.json（本仓库中的副本：[`openapi.json`](openapi.json)，通过 ./sync-spec.sh 刷新；线上文档为权威版本）
• MCP 服务（Streamable HTTP）：https://www.ocolo.io/api/v1/mcp/
• 发现信息：https://www.ocolo.io/.well-known/ocolo-agent.json、https://www.ocolo.io/llms.txt

快速开始（REST）

curl -X POST https://www.ocolo.io/api/v1/project-requests/ \
  -H 'Content-Type: application/json' \
  -d @examples/request.json

响应（201）：包含 request_id、status: pending_confirmation、status_url、需要妥善保存的 status_token、机器可读的 next_steps，以及一个 guidance 对象。使用 Authorization: Bearer <status_token> 轮询状态。

import requests
r = requests.post("https://www.ocolo.io/api/v1/project-requests/", json={
    "location": "Northern Virginia, USA",
    "power_mw": 2,
    "cabinets": 60,
    "requested_delivery_date": "2027-03-01",
    "requirements_text": "Liquid cooling preferred, N+1 or better, SOC 2 required.",
    "contact": {"name": "Jane Doe", "email": "[email protected]", "company": "Acme"},
    "agent": {"name": "my-agent", "on_behalf_of_confirmed": True},
    "idempotency_key": "acme-nova-2027-q1",
}).json()
print(r["status"], r["status_url"])
for step in r["next_steps"]:
    print(step["action"], step.get("detail", ""))

MCP

将 https://www.ocolo.io/api/v1/mcp/ 添加为远程 MCP 服务（无需身份验证）。工具：

工具	用途
get_broker_guidance	了解 OCOLO 的运作方式以及下方的沟通礼仪。请先阅读。
submit_project_request	提交需求（字段与 REST 请求体相同）。
get_project_request_status	使用 request_id + status_token 轮询状态。

本仓库中的 server.json 是 MCP Registry 清单文件。

提交后会发生什么

1. 联系人会收到确认邮件。确认之前，任何操作都不会生效（他们也可以先在 OCOLO 表单中编辑请求；request_id 保持不变，之后状态请求体会包含 edited_by_contact: true，并在 current 下提供最终值）。
2. OCOLO 会将项目提交给其服务商网络，寻找合适的站点并协调联系事宜。
3. OCOLO 会在 2-3 个工作日内回复联系人。

经纪商沟通礼仪（请遵守）

• 不要签署独家经纪协议；为用户保留选择空间。
• 对于单个项目，联系的经纪商总数不要超过 1-3 家。服务商会看到每一条外部询问；十个人询问同一项需求，看起来像是传闻，而非战略合作。
• OCOLO 协调请求期间，不要直接联系服务商，也不要将同一项需求提交给其他经纪商或市场平台。

每个 API 响应都会在其 guidance 字段中重复这些内容。

限制

按 IP 和联系人电子邮件地址进行速率限制；请遵循 Retry-After，并使用 idempotency_key 安全重试。超过 64 KB 的请求体会被拒绝。问题请联系：[email protected]。