search_by_condition
Find clinical trials for specific medical conditions by filtering study phase and recruitment status to identify relevant research studies.
Instructions
Search for clinical trials focusing on specific medical conditions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| condition | Yes | Medical condition, disease, or syndrome | |
| phase | No | Study phase filter | |
| recruitmentStatus | No | Filter by recruitment status | |
| pageSize | No | Number of results to return (default 10, max 100) |
Implementation Reference
- build/index.js:841-903 (handler)Implementation of the search_by_condition tool handler.
async handleSearchByCondition(args) { if (!args?.condition) { throw new McpError(ErrorCode.InvalidParams, "Condition parameter is required"); } const params = { format: "json", pageSize: args?.pageSize || 10, "query.cond": args.condition, }; if (args?.phase) { params["filter.phase"] = args.phase; } if (args?.recruitmentStatus) { params["filter.overallStatus"] = args.recruitmentStatus; } try { const response = await this.axiosInstance.get("/studies", { params }); const studies = response.data.studies || []; const results = studies.map((study) => ({ ...this.formatStudySummary(study), conditions: study.protocolSection.conditionsModule?.conditions || [], eligibility: { sex: study.protocolSection.eligibilityModule?.sex || "Unknown", minimumAge: study.protocolSection.eligibilityModule?.minimumAge || "Not specified", maximumAge: study.protocolSection.eligibilityModule?.maximumAge || "Not specified", healthyVolunteers: study.protocolSection.eligibilityModule?.healthyVolunteers || false, }, })); return { content: [ { type: "text", text: JSON.stringify({ searchCriteria: { condition: args.condition, phase: args.phase, recruitmentStatus: args.recruitmentStatus, }, totalCount: response.data.totalCount || 0, resultsShown: results.length, studies: results, }, null, 2), }, ], }; } catch (error) { if (axios.isAxiosError(error)) { return { content: [ { type: "text", text: `Clinical Trials API error: ${error.response?.data?.message || error.message}`, }, ], isError: true, }; } throw error; } } - build/index.js:159-192 (registration)Tool registration and schema definition for search_by_condition in the ListToolsRequest handler.
name: "search_by_condition", description: "Search for clinical trials focusing on specific medical conditions", inputSchema: { type: "object", properties: { condition: { type: "string", description: "Medical condition, disease, or syndrome", minLength: 2, }, phase: { type: "string", description: "Study phase filter", enum: ["PHASE1", "PHASE2", "PHASE3", "PHASE4", "NA"], }, recruitmentStatus: { type: "string", description: "Filter by recruitment status", enum: [ "RECRUITING", "NOT_YET_RECRUITING", "ACTIVE_NOT_RECRUITING", ], }, pageSize: { type: "number", description: "Number of results to return (default 10, max 100)", minimum: 1, maximum: 100, }, }, required: ["condition"], }, },