`ir_irct_trial_search`

Pack: ir-irct · 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/ir_irct_trial_search for the schema, then POST the same URL with its arguments for the data.

Search the Iranian Registry of Clinical Trials (IRCT, Iran’s national registry of clinical trials, a WHO primary registry). Free-text query in English or Persian over titles, conditions, interventions and sponsors, or an IRCT number. Each hit gives the IRCT number, the title and the record link; 25 results per page (page, next_page). Status, phase, sponsor and dates are in ir_irct_trial_get. No hit means none in this registry, not that no such trial exists. Example: query=“gastric cancer”.

Parameters

Name	Type	Required	Description
`query`	string	yes	Words from the title, condition, intervention or sponsor in English or Persian, or an IRCT number.
`page`	number	no	Result page, 25 per page (default 1); use next_page from the previous answer.
`limit`	number	no	Trials returned from the page (1-25, default 10).

Example call

Arguments

{
  "query": "gastric cancer",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/ir-irct/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ir_irct_trial_search","arguments":{"query":"gastric cancer","limit":3}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ir_irct_trial_search', {
  "query": "gastric cancer",
  "limit": 3
});

Response shape

Field	Type	Description
`query`	object \| null
`found`	boolean
`total`	number \| null
`returned`	number \| null
`page`	number \| null
`next_page`	number \| null
`trials`	array \| null
`sort`	string \| null
`data_as_of`	string \| null
`source`	string
`caveat`	string \| null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "query": {
          "type": [
            "string",
            "null"
          ]
        },
        "page": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "additionalProperties": true
    },
    "found": {
      "type": "boolean"
    },
    "total": {
      "type": [
        "number",
        "null"
      ]
    },
    "returned": {
      "type": [
        "number",
        "null"
      ]
    },
    "page": {
      "type": [
        "number",
        "null"
      ]
    },
    "next_page": {
      "type": [
        "number",
        "null"
      ]
    },
    "trials": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "trial_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "internal_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "record_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    },
    "sort": {
      "type": [
        "string",
        "null"
      ]
    },
    "data_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string"
    },
    "caveat": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "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 ir-irct pack

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

See Getting Started for client-specific install steps.

ir_irct_trial_search