Cortexa research tool·drug discovery·ChEMBL

ChEMBL Search Molecules

Search molecules by name, ChEMBL ID, or other criteria. Supports filtering and pagination. Note: some text-based filters (especially `pref_name__contains`) may legitimately return zero results because `pref_name` coverage is incomplete and may not contain common drug names. For reliable retrieval, prefer ID-based filters like `molecule_chembl_id` or use `ChEMBL_get_molecule` when you already have a ChEMBL ID.

Livelast probed 2026-04-30 23:07Z· 2336msCortexa

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed: 1d ago
Last success: 1d ago
Last latency: 2336ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "fields": {
      "description": "Optional list of ChEMBL molecule fields to include in each returned molecule object (projection). Cortexa Tool Mesh maps this to ChEMBL's `only` query parameter (comma-separated). Supported fields: molecule_chembl_id, pref_name, molecule_type, max_phase, first_approval, black_box_warning, withdrawn_flag, molecule_structures, molecule_properties.",
      "items": {
        "enum": [
          "molecule_chembl_id",
          "pref_name",
          "molecule_type",
          "max_phase",
          "first_approval",
          "black_box_warning",
          "withdrawn_flag",
          "molecule_structures",
          "molecule_properties"
        ],
        "type": "string"
      },
      "type": "array",
      "uniqueItems": true
    },
    "format": {
      "default": "json",
      "enum": [
        "json",
        "xml",
        "yaml"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of results (default: 20, max: 1000)",
      "maximum": 1000,
      "type": "integer"
    },
    "max_results": {
      "default": 20,
      "description": "Maximum number of results to return. Alias for limit.",
      "maximum": 1000,
      "type": "integer"
    },
    "molecule_chembl_id": {
      "description": "Filter by ChEMBL ID (exact match)",
      "type": "string"
    },
    "molecule_type": {
      "description": "Filter by molecule type (e.g., 'Small molecule', 'Antibody')",
      "type": "string"
    },
    "offset": {
      "default": 0,
      "description": "Offset for pagination (default: 0)",
      "type": "integer"
    },
    "pref_name__contains": {
      "description": "Filter by preferred name (contains). Note: `pref_name` coverage is incomplete in ChEMBL, so this can legitimately return zero results even for common names; prefer `molecule_chembl_id` for reliable retrieval.",
      "type": "string"
    },
    "query": {
      "description": "Molecule name to search for. Alias for pref_name__contains.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

Default ChEMBL Search Molecules call

public-safeinput

{
  "fields": [],
  "limit": 3,
  "max_results": 1,
  "offset": 1,
  "query": "BRCA1"
}

Expected response keys: success

Anonymous-safe example. Rate-limited; no sign-in required.

Identifiers

Catalog ID: tu_ChEMBL_search_molecules
Tool name: ChEMBL_search_molecules
Added: 2026-04-30 22:47Z
Tags: tooluniverse

ChEMBL Search Molecules

Livelast probed 2026-04-30 23:07Z· 2336msCortexa

Schema

JSON Schema the agent (or your API call) must match.

{ "properties": { "fields": { "description": "Optional list of ChEMBL molecule fields to include in each returned molecule object (projection). Cortexa Tool Mesh maps this to ChEMBL's `only` query parameter (comma-separated). Supported fields: molecule_chembl_id, pref_name, molecule_type, max_phase, first_approval, black_box_warning, withdrawn_flag, molecule_structures, molecule_properties.", "items": { "enum": [ "molecule_chembl_id", "pref_name", "molecule_type", "max_phase", "first_approval", "black_box_warning", "withdrawn_flag", "molecule_structures", "molecule_properties" ], "type": "string" }, "type": "array", "uniqueItems": true }, "format": { "default": "json", "enum": [ "json", "xml", "yaml" ], "type": "string" }, "limit": { "default": 20, "description": "Maximum number of results (default: 20, max: 1000)", "maximum": 1000, "type": "integer" }, "max_results": { "default": 20, "description": "Maximum number of results to return. Alias for limit.", "maximum": 1000, "type": "integer" }, "molecule_chembl_id": { "description": "Filter by ChEMBL ID (exact match)", "type": "string" }, "molecule_type": { "description": "Filter by molecule type (e.g., 'Small molecule', 'Antibody')", "type": "string" }, "offset": { "default": 0, "description": "Offset for pagination (default: 0)", "type": "integer" }, "pref_name__contains": { "description": "Filter by preferred name (contains). Note: `pref_name` coverage is incomplete in ChEMBL, so this can legitimately return zero results even for common names; prefer `molecule_chembl_id` for reliable retrieval.", "type": "string" }, "query": { "description": "Molecule name to search for. Alias for pref_name__contains.", "type": "string" } }, "required": [], "type": "object" }