`co_law_search`

Pack: colombia-law · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/co_law_search for the schema, then POST the same URL with its arguments for the data.

Search Colombian national legislation (leyes, decretos, códigos, the Constitución) and the Constitutional Court rulings reviewing them, by Spanish words, by type + number + year, or both, e.g. words “protección de datos personales” or type “ley” number 1581 year 2012. Returns doc_id (e.g. “ley_1581_2012”, “c-748_2011” for a Court ruling), the kind of document, relevance score and a text snippet; the first ten matches by relevance, with the total. Pair with co_law_get for the text.

Parameters

Name	Type	Required	Description
`query`	string	no	Spanish word or phrase, e.g. “datos personales”
`type`	string	no	Document type filter
`number`	number	no	Document number, e.g. 1581
`year`	number	no	Year, e.g. 2012

Example call

Arguments

{
  "query": "datos personales",
  "type": "ley"
}

curl

curl -X POST https://gateway.pipeworx.io/colombia-law/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"co_law_search","arguments":{"query":"datos personales","type":"ley"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('co_law_search', {
  "query": "datos personales",
  "type": "ley"
});

Response shape

Field	Type	Description
`query`	string \| null
`filters`	object
`total_matches`	number
`count`	number
`results`	array
`note`	string
`empty_reason`	string
`source`	string
`data_as_of`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "type": "object",
      "properties": {
        "type": {
          "type": [
            "string",
            "null"
          ]
        },
        "number": {
          "type": [
            "number",
            "null"
          ]
        },
        "year": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "additionalProperties": true
    },
    "total_matches": {
      "type": "number"
    },
    "count": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "doc_id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "snippet": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    },
    "empty_reason": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the colombia-law pack

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

See Getting Started for client-specific install steps.

co_law_search