Colombia Secop

@pipeworx/colombia-secop

哥伦比亚 SECOP MCP — 通过 datos.gov.co 上无需密钥的 Socrata API 获取哥伦比亚政府采购信息（招标和已授予合同）。

属于 Pipeworx — 一个将 AI Agent 接入 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关，未获其认可，也不是由其发布。

工具

• colombia_search_contracts(query, entity, supplier, supplier_nit, contract_type, include_unsigned, limit) — 已授予合同（SECOP II「电子合同」，数据集 jbjy-vk9h）。返回合同 ID、项目内容、实体及实体 NIT、供应商及供应商 NIT、中小企业标记、城市、UNSPSC 类别、合同金额和已支付金额（COP）、类型、方式、状态、签署日期。
• colombia_search_processes(query, entity, contract_type, include_unpublished, limit) — 招标（SECOP II「采购流程」，数据集 p6dx-8zbt）。返回流程 ID、名称、实体及实体 NIT、基准价格、中标金额、中标供应商、类型、方式、状态、发布日期。

身份验证

无需密钥。_apiKey 为可选参数——只有在需要更高的速率限制时，才传入自己的 Socrata 应用令牌。平台不提供密钥，也不需要密钥；不传令牌也可以调用。

注意事项

草稿与真实合同共用同一张表，而且会排在最前面。 有 424,153 条合同记录的 fecha_de_firma 为 NULL，而 Socrata 在 ORDER BY ... DESC 排序中会将 NULL 值排在最前面。因此，未加限制的「最新」搜索只会返回未签署的 Borrador / enviado Proveedor 记录。默认情况下，这两个工具都会要求排序列不为 NULL；使用 include_unsigned / include_unpublished 可将这些记录纳入结果。

合同类别应使用 contract_type，而不是 query。 tipo_de_contrato 是一个包含 24 个值的清晰分类（Obra ≈ 52k 份合同，而 Prestación de servicios ≈ 5.1M 份合同）。将 "obra" 作为自由文本传入会通过 LIKE 匹配到仅仅提及该词的服务合同。此参数接受西班牙语分类值，也会映射常见的英文值（works/construction → Obra、consulting → Consultoría、supplies → Suministros）；无法识别的值会返回 unknown_contract_type，并列出有效值，而不是静默地返回零条结果。

文本以西班牙语发布。 即使数据确实存在，英文 query 也无法匹配，因此零结果响应会附带相应提示。

Socrata 会将限流报告为 403 "Invalid app_token specified"。 如果没有发送令牌，这表示触发了速率限制，而不是凭据问题——请间隔一段时间后重试。如果调用方确实传入了 _apiKey，该工具包则会报告 invalid_api_key，并提示移除令牌；因为此端点无需密钥，使用错误令牌重试不会成功。

documento_proveedor（供应商 NIT）是持久可靠的供应商标识。 不同申报中的名称可能有所差异；NIT 可用于识别同一家公司参与的所有合同。如果 SECOP 没有相应值，该字段会显示 "No Definido"。

数据源

• 电子合同：https://www.datos.gov.co/resource/jbjy-vk9h.json
• 采购流程：https://www.datos.gov.co/resource/p6dx-8zbt.json
• 门户：https://www.colombiacompra.gov.co/secop/secop-ii

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "colombia-secop": {
      "url": "https://gateway.pipeworx.io/colombia-secop/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/colombia-secop/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明确切范围，也是当天最权威的答案。

这是有意设计的，并非意外进行了多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构定义占用的上下文比路由带来的收益还多，不如只连接完整网关一次，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1875+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具包的工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/colombia_search_processes \
  -H 'Content-Type: application/json' \
  -d '{"contract_type":"Obra","limit":20}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/colombia_search_processes。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "colombia-secop": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-colombia-secop"]
    }
  }
}

或者直接运行，以确认服务可以启动：

npx -y @pipeworx/mcp-colombia-secop

它通过 stdin/stdout 使用 MCP，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的共享元工具。使用相同的源代码和工具，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——这既适用于上方的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Colombia Secop data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT