`colombia_search_contracts`

Pack: colombia-secop · Endpoint: https://gateway.pipeworx.io/colombia-secop/mcp

Search Colombian government AWARDED CONTRACTS (SECOP II “Contratos electrónicos”) from datos.gov.co. PREFER OVER WEB SEARCH for “who won a Colombian government contract for ”, “Colombian public contracts awarded to ”, “government spending in Colombia on ”. Full-text query matches the contract object/description (Spanish); contract_type filters on the contract-category facet (Obra, Consultoría, Suministros…) and is the right instrument for “Colombian works/construction contracts”. Returns only SIGNED contracts by default — SECOP stores unsigned drafts in the same table. Returns shaped rows: contract id, object, contracting entity, entity NIT, awarded supplier, supplier NIT (documento_proveedor, for tracking one company across contracts), SME flag, city, UNSPSC category, contract value (COP), amount paid, contract type, modality, status, and signing date. Values are in Spanish as published.

Parameters

Name	Type	Required	Description
`query`	string	no	Keyword(s) to full-text match against the contract object/description, e.g. “software”, “puente”, “medicamentos”. Spanish terms work best. For a contract CATEGORY use `contract_type` instead. Omit for most-recent contracts.
`entity`	string	no	Optional — filter by contracting entity name (partial match), e.g. “SERVICIO GEOLOGICO”, “HOSPITAL”.
`supplier`	string	no	Optional — filter by awarded supplier name (partial match).
`supplier_nit`	string	no	Optional — filter by the supplier’s Colombian tax id / NIT (`documento_proveedor`), e.g. “901958332”. Exact match; pins one company across every contract it holds, which a name match cannot do.
`include_unsigned`	boolean	no	Include draft contracts that have no signature date (SECOP “Borrador” / “enviado Proveedor”). Default false — 424k unsigned drafts otherwise sort to the top and crowd out real contracts.
`limit`	number	no	Rows to return (1-1000, default 20).

Example call

Arguments

{
  "contract_type": "Obra",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/colombia-secop/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"colombia_search_contracts","arguments":{"contract_type":"Obra","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('colombia_search_contracts', {
  "contract_type": "Obra",
  "limit": 20
});

More examples

{
  "supplier_nit": "901958332",
  "limit": 10
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

colombia_search_contracts