Skip to main content
Glama

Search clinical trials

search_clinical_trials
Read-onlyIdempotent

Search ClinicalTrials.gov by condition, intervention, sponsor, phase, recruitment status, location, institution, study type or dates. Returns structured studies with source links and retrieval time.

Input Schema

NameRequiredDescriptionDefault
nearNo
phaseNo
queryNoFree-text search across the registry
nct_idsNo
sponsorNoSponsor or collaborator name
locationNoFree-text place, e.g. 'Boston, Massachusetts'
conditionNoDisease or condition, e.g. multiple sclerosis
page_sizeNo
page_tokenNo
study_typeNo
institutionNoResearch site / facility name
interventionNoDrug or other intervention name
start_date_toNo
updated_sinceNo
location_filterNoShow only sites in this city/state/country in each result
start_date_fromNo
first_posted_sinceNo
recruitment_statusNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds return-value context (structured studies with source links and retrieval time), which is useful, but says nothing about pagination semantics, result caps, or rate limits for a query tool that clearly paginates.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two dense sentences with zero filler; the search scope leads and the return summary follows. It is well front-loaded and correctly sized for a query tool, though being a single enumeration it offers little structural help for such a wide schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 18 parameters, 0 required, nested objects (near, location_filter), no output schema, and low schema coverage, the description is too thin. It leaves the agent without guidance on combining filters, the pagination model, or the distinction between the several geographic filtering mechanisms.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 39% across 18 parameters, so the schema does not fully document itself and the description is expected to compensate. The description names several filter categories (condition, intervention, sponsor, phase, recruitment status, location, institution, study type, dates) that map to real params, but it never clarifies ambiguities like `near` vs `location` vs `location_filter`, `nct_ids`, or `page_token`.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (Search) and resource (ClinicalTrials.gov) and enumerates the filterable dimensions, so the agent knows exactly what this tool retrieves. It does not, however, name or differentiate itself from siblings like search_eu_trials or get_clinical_trial, leaving registry scope to be inferred from the description text.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance, no statement of when this tool is preferable to get_clinical_trial (by NCT ID) or search_eu_trials (other registries), and no mention of pagination or how multiple filters interact. The agent gets a capability list but no routing logic.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources