Radicado Uno

Radicado Uno — MCP 服务

远程 MCP 服务（Model Context Protocol），让 Agent 可以只读访问哥伦比亚的商业和公共采购数据， 这些数据按 NIT 交叉关联，每条数据都附有官方来源。

Endpoint：https://mcp.radicadouno.co/mcp · 传输方式：Streamable HTTP · 身份验证：连接时无需身份验证（添加 URL 即可）；只有使用六个数据工具时才需要 Authorization: Bearer rduno_… 密钥。

此仓库包含服务器的文档和描述文件。服务器是远程服务，由我们托管：无需安装或 部署，数据摄取代码也不公开。

提供的数据

15 个哥伦比亚官方数据源，经过复制并按 NIT 交叉关联。以下为截至 2026-08-16 核实的数据：

来源	数据量
SECOP II 电子合同（jbjy-vk9h）	5.910.478
采购流程，完整漏斗（p6dx-8zbt）	8.549.010
RUES 商业登记（c82u-588k）	9.324.004
有公开档案的企业	385.225

此外，还包括通过 NIT 实时查询的 RUES 档案（49 个字段，通过 Confecámaras 获取）、SIIF 预算承诺、国家虚拟商店的订单、Supersociedades 财务报表、采购制裁、工业和商业监管局的制裁，以及 OFAC 和联合国限制名单。

每条记录都会保留其来源官方文件的 URL 和采集日期，因此可以独立核验任何答复。

工具

前六个工具为只读（readOnlyHint），并返回 outputSchema；需要密钥。最后四个工具无需密钥：其中一个提供每日限额内的免费答复，其余三个用于付费服务。

工具	功能
radicadouno_buscar_empresa	在 RUES 的 930 万条登记记录中，按企业名称前缀或精确 NIT 搜索。返回带 NIT 的候选项，供其他工具使用。
radicadouno_perfil_empresa	按 NIT 完整交叉查询：商业登记、丰富档案、国家供应商登记和公共采购汇总。每个数据块均附有来源信息。
radicadouno_contratos_empresa	查询 NIT 为中标供应商的 SECOP II 合同，并提供每份合同档案的官方链接。可按年份和状态筛选。
radicadouno_senales_empresa	可核验指标：实体存在情况、采购量、与最大客户的集中度、以唯一报价中标的流程、制裁和最新财务数据。
radicadouno_red_empresa	沿采购关系图遍历两跳（企业 → 公共机构 → 另一家企业）：查询与其面对相同采购方的企业，并根据各自业务组合规模对相似度进行归一化。
radicadouno_estado_fuentes	查询已加载的数据源、行数和最近一次采集日期。可用于说明数据的新鲜度。
radicadouno_comprobar	**无需密钥，每天免费 10 次。**按 NIT 查询企业关键信息：登记身份、是否与政府签约、是否受到制裁，以及是否出现在限制名单中。
radicadouno_informe	获取企业的盖章报告。使用 Pro 或 Business 密钥，每月 20 份报告可直接抵扣，无需额外付费；无密钥（或额度用尽）时，可单独购买，价格为 89.900 COP，并返回付款 URL。
radicadouno_contratar	**无需密钥。**打开 Business 计划的付款页面，并返回 URL 和参考编号。
radicadouno_estado_contratacion	**无需密钥。**使用任一购买产生的参考编号查询付款是否已确认，并交付密钥（仅一次）或报告下载链接。

招标（自 2026-10-11 起）

新增 10 个只读工具，需使用 Business 密钥。文档见 https://radicadouno.co/documentacion。

工具	功能
radicadouno_historial_contratos	某企业的所有合同：SECOP II（自 2015 年起）和 SECOP I（自 2000 年起），去重后按页返回，并提供准确总数、UNSPSC、执行地点、初始金额、追加金额，以及每项金额的可靠性。
radicadouno_resumen_contratacion	按年份、UNSPSC、采购方式或机构汇总金额，只累计可靠的金额，并说明排除了哪些金额及原因。
radicadouno_participaciones	该企业参与的流程（直接参与或以联合体成员身份参与）：哪些中标、哪些落标、竞争者数量、中标者及其报价。
radicadouno_consorcios	该企业所属的联合体和临时联合体，包括其占比以及是否担任牵头方。
radicadouno_procesos	按采购机构或 UNSPSC 代码查询 SECOP II 流程。
radicadouno_proceso	某个流程：投标人、报价、中标结果和合同。
radicadouno_documentos_proceso	招标文件、评估、中标结果、报价、合同和变更的官方链接。
radicadouno_modificaciones_contrato	合同的追加金额、延期和结算。
radicadouno_precios_tvec	国家虚拟商店订单中每个条目的单价。

不会返回任何自然人的数据：在竞争者或成员名单中，自然人会显示为“自然人”，不含姓名或证件号码。

radicadouno_senales_empresa 不是信用评分。第 1266 号法律（2008 年）规定，此类业务由风险中心专营，我们并非风险中心：这里只提供事实及其来源，不作评级。

免费试用

协议的问候流程（initialize、ping、tools/list）无需密钥即可响应，因此任何客户端都可以连接并查看可用内容。而且**radicadouno_comprobar 可免费返回真实数据**，每天最多核验 10 次：与网站上的规则相同——屏幕上显示的答复免费，可用于向第三方展示的文件则需付费。

一键安装

• Gemini CLI： gemini extensions install https://github.com/odela-pixel/radicadouno-mcp （读取 gemini-extension.json）。
• Cursor： 插件配置位于 .cursor-plugin/plugin.json + mcp.json。
• 其他客户端： 将 https://mcp.radicadouno.co/mcp 添加为远程 MCP 服务（Streamable HTTP），无需请求头。

使用密钥时，在客户端配置中添加请求头 Authorization: Bearer rduno_…。

Claude 和 ChatGPT 专用免费端点

• https://mcp.radicadouno.co/claude — Claude 连接器，无需身份验证。
• https://mcp.radicadouno.co/chatgpt — ChatGPT 应用，无需身份验证。

两者仅提供两个只读且免费的工具： radicadouno_buscar_empresa（按名称或 NIT 查询）和 radicadouno_comprobar_empresa （按 NIT 免费核验，每日有次数上限）。其余工具目录位于 /mcp。

申请报告：包含在套餐内，或单独购买

使用 Pro 或 Business 套餐密钥时，radicadouno_informe 会从每月包含的 20 份报告中扣除：无需结账或付款，报告约 40 秒后生成，可通过参考编号获取。未能生成的报告不计入额度。

没有密钥，或当月报告额度已用完时，向 radicadouno_informe 提供 NIT 会返回付款链接（89,900 COP，无需订阅）和参考编号。付款确认后，使用该参考编号调用 radicadouno_estado_contratacion，即可获取 PDF 下载链接，以及供第三方验证其指纹的公开链接。文档可按需重复下载。

如何获取密钥（Agent 可以自行完成）

六种不限量数据工具需要 Business 套餐 （每月 619.900 COP，前 7 天免费：需要提供银行卡，如果提前 取消，则不会收取任何费用），开通无需我们这边任何人介入：

1. 客户调用 radicadouno_contratar — 这是两个无需密钥即可使用的 工具之一。它会返回 Stripe 付款 URL 和一个 referencia。
2. 在该 URL 完成付款。
3. 客户使用该参考编号调用 radicadouno_estado_contratacion。 付款确认前会返回 pendiente；确认后，密钥只交付一次，并从我们 这边删除。

之后，密钥通过 Authorization: Bearer rduno_… 传递。密钥只交付一次， 无法再次查询：交付后，数据库中只保留其 SHA-256。如果密钥丢失，请发送 邮件至 [email protected]，我们会重新签发。已付款但未领取的套餐会在 72 小时后过期。

也可以在 https://radicadouno.co/precios 手动订购。

从 Claude Desktop 连接

该服务是远程服务，因此使用 mcp-remote 进行连接。在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "radicadouno": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.radicadouno.co/mcp",
        "--header",
        "Authorization:Bearer ${RADICADOUNO_CLAVE}"
      ],
      "env": { "RADICADOUNO_CLAVE": "rduno_su_clave" }
    }
  }
}

使用 curl 连接

curl -s https://mcp.radicadouno.co/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H "authorization: Bearer $RADICADOUNO_CLAVE" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

调用工具：

curl -s https://mcp.radicadouno.co/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H "authorization: Bearer $RADICADOUNO_CLAVE" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,
       "params":{"name":"radicadouno_buscar_empresa",
                 "arguments":{"texto":"BANCOLOMBIA","limite":5}}}'

无需密钥即可查看服务状态：https://mcp.radicadouno.co/health

限制与条件

• 协议握手无需密钥：initialize、ping 和 tools/list 无需密钥即可响应，让任何客户端都能在订购前查看这里提供的内容。 但数据不同：除两个订购工具外，tools/call 都需要密钥。
• 在检查密钥之前，每个 IP 每分钟最多 120 次请求。
• 除上述限制外，还会根据套餐对每个密钥设定调用限额。
• 没有有效密钥时，响应为 401 并附带原因；套餐不包含 MCP 时，响应为 403。超出限制时，响应为 429 并附带 Retry-After。
• 无状态模式：每个请求相互独立（没有会话）。
• 只读：任何工具都不会写入数据。
• 按调用计量使用情况，用于计费并了解用户查询的内容。

此服务不提供的功能

先说明清楚，避免任何人感到意外：

• 不计算分数或信用评级（2008 年第 1266 号法律）。
• 财务报表并不涵盖所有企业：具体取决于 Supersociedades 发布的数据。 如果企业没有提交报告，就不会有相关数据。
• 自然人商户被有意排除在外（2012 年第 1581 号法律， habeas data），即使他们列在 RUES 中也不例外。
• 工业和商业监管局的制裁记录不包含 NIT （税号），官方数据源中没有这项信息：只有当名称与商业登记记录唯一匹配时， 才会建立关联。宁可留空，也不制造误报。
• 限制名单（OFAC、ONU）仅按名单本身公布的准确 NIT （税号）进行匹配，从不按近似名称匹配。ONU 不公布 NIT （税号），因此其条目不会与任何企业建立关联。
• **数据会继承其来源中的错误。**如果 SECOP 错误登记了某个金额， 这里也会照样显示 — 并附上官方档案链接，以便核查。
• 标准套餐不提供服务级别协议。

完整的方法说明，以及每个数据源的更新频率： https://radicadouno.co/metodologia

数据来源

哥伦比亚政府在 datos.gov.co 发布的开放数据， 采用 CC BY-SA 4.0 许可； 此外还包括通过 Confecámaras 对 RUES 的实时查询， 以及 OFAC 和 ONU 名单。根据 2014 年第 1712 号法律向公众开放。

本仓库的 MIT 许可证适用于其文档和配置，不适用于所提供的数据；这些数据仍遵循 其来源的许可证。

---

Radicado Uno — MCP 服务（英文摘要）

一个远程 MCP 服务，让 Agent 只读访问哥伦比亚公司和公共采购数据，并通过 NIT（国家税号）进行交叉比对，且每个字段都附有官方来源。

• 端点： https://mcp.radicadouno.co/mcp（Streamable HTTP）
• 身份验证： Authorization: Bearer rduno_… — 包含在 Business 套餐中 （https://radicadouno.co/precios）
• 免费试用，无需密钥： MCP 握手开放，radicadouno_comprobar 可返回任意 NIT 的真实数据——注册身份、公共采购、制裁和限制名单——每天最多 10 次。
• 自助注册，无需人工介入： radicadouno_contratar（无需密钥）会返回 Stripe 结账 URL（7 天免费试用）和一个参考编号；注册后，radicadouno_estado_contratacion 会一次性提供密钥，随后将其遗忘。 radicadouno_informe 可为单份签名报告提供相同服务（89,900 COP，无需订阅），并返回下载链接而非密钥。
• 健康状态： https://mcp.radicadouno.co/health

数据： 590 万份 SECOP II 公共合同、850 万个采购流程、930 万条 RUES 商业登记记录、385,225 份已发布的公司档案，另有实时 RUES 查询、Supersociedades 财务报表、采购制裁信息以及 OFAC/UN 限制名单。每条记录都保留其来源 URL 和采集日期。

工具（共十个；六个数据工具为只读且需要密钥）： radicadouno_buscar_empresa（按名称或 NIT 搜索）、radicadouno_perfil_empresa（完整档案）、radicadouno_contratos_empresa （附官方链接的公共合同）、radicadouno_senales_empresa（客观信号——不是信用评分）、radicadouno_red_empresa （两跳采购图谱）、radicadouno_estado_fuentes（数据来源时效性）。

限制： 密钥验证前，每个 IP 每分钟最多 120 次请求；此外还有每个密钥的限制；无状态；标准套餐不提供 SLA。

已知缺口，事先说明： 不提供信用评分（哥伦比亚第 1266/2008 号法律）；财务报表仅适用于向 Supersociedades 报告的公司；出于隐私原因，不包含个体经营者记录（第 1581/2012 号法律）；SIC 制裁信息仅在名称唯一且完全匹配时关联；OFAC/UN 名单仅按完全匹配的 NIT 进行匹配；数据会继承其来源中的错误。

采用 MIT 许可（文档和配置）。数据采用其自身的来源许可协议（datos.gov.co 使用 CC BY-SA 4.0）。