Clinical Trials MCP Server

Instructions

Implementation Reference

• build/index.js:1387-1464 (handler)

  The handleGetPediatricStudies function executes the logic for the get_pediatric_studies tool, querying the ClinicalTrials.gov API with age filters.

  async handleGetPediatricStudies(args) {
      const params = {
          format: "json",
          pageSize: args?.pageSize || 10,
          "filter.stdAge": "CHILD",
      };
      if (args?.condition) {
          params["query.cond"] = args.condition;
      }
      if (args?.ageRange) {
          switch (args.ageRange) {
              case "INFANT":
                  params["filter.minimumAge"] = "0 Years";
                  params["filter.maximumAge"] = "2 Years";
                  break;
              case "CHILD":
                  params["filter.minimumAge"] = "2 Years";
                  params["filter.maximumAge"] = "12 Years";
                  break;
              case "ADOLESCENT":
                  params["filter.minimumAge"] = "12 Years";
                  params["filter.maximumAge"] = "18 Years";
                  break;
          }
      }
      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,
              },
              locations: study.protocolSection.contactsLocationsModule?.locations?.slice(0, 2) || [],
          }));
          return {
              content: [
                  {
                      type: "text",
                      text: JSON.stringify({
                          searchCriteria: {
                              targetPopulation: "PEDIATRIC",
                              condition: args?.condition,
                              ageRange: args?.ageRange,
                              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:402-433 (registration)

  Registration of the get_pediatric_studies tool in the ListToolsRequestSchema handler.

      name: "get_pediatric_studies",
      description: "Find clinical trials specifically designed for children and adolescents",
      inputSchema: {
          type: "object",
          properties: {
              condition: {
                  type: "string",
                  description: "Pediatric condition or disease",
              },
              ageRange: {
                  type: "string",
                  description: "Specific pediatric age range",
                  enum: ["INFANT", "CHILD", "ADOLESCENT"],
              },
              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 50)",
                  minimum: 1,
                  maximum: 50,
              },
          },
      },
  },