Gosset

Estimate the probability that a clinical trial advances to its next development phase (for example Phase 2 to Phase 3), using Gosset's trial phase-transition model (PTRS, probability of technical and regulatory success). Use when the user asks for a trial's probability of success, its chance of reaching the next phase, or what drives that estimate. This is one phase transition only, not the probability of eventual approval: a Phase 2 result of 0.44 means a 44% chance of reaching Phase 3. Do not multiply or extend it into an approval probability. Input: either nct_id (the trial is looked up in Gosset) or trial_params describing a trial. Returns: - phase, and transition_probability (the one-step probability). - source and confidence: "benchmark-v3"/"high" when 3 or fewer parameters are given (the base rate for the phase and disease); "sdk-api-v3"/"high" for an nct_id or a nearly complete description; "sdk-api-v3"/"low" for a partial description, with a warning. Adding avg_arm_size, targets, sponsors, has_designations or num_sites raises confidence. - warnings, e.g. a disease or modality name that could not be classified (ignored), or a value clamped to its valid range (avg_arm_size to 1-10000, negative counts to 0). A non-integer highest_phase such as 2.5 is rejected with an error. - param_importance: the signed influence of each input parameter on the estimate. - trial_params_used: the parameters given to the model. On failure it returns {"error": reason} and no score. Calls count toward the account's prediction allowance.

estimate_trial_phase_transition_probability

Estimate how many days remain until a clinical trial's primary completion, with an 80% prediction interval, using Gosset's trial duration model. Use when the user asks when a trial will finish or read out, or whether it is likely to run past its posted completion date. The estimate is conditioned on how long the trial has already run, and works for trials that are running, not yet started or completed. For a trial missing from the model's data, its public ClinicalTrials.gov record is fetched (about 1 second). Returns trial_status (running, not_started, completed or not_found), elapsed_days, expected_remaining_days, lower_bound_days and upper_bound_days (the 80% interval), expected_completion_date, sponsor_estimated_completion (the date the sponsor posted), actual_completion_date (for completed trials), model_version and warnings. Calls count toward the account's monthly prediction allowance.

estimate_trial_time_to_completion

Search Gosset's database of clinical trials, built from ClinicalTrials.gov, with a natural-language query. Use when the user asks for clinical trials by drug, target, modality, sponsor, disease, phase, status, design, dates or eligibility (age, sex, country), or for the details of a trial by NCT ID. Each trial has nct_id, official_title, brief_summary, status, phase, sponsors, start and completion dates, main_drug, targets, modalities, diseases, enrollment {count, type} (type ACTUAL or ESTIMATED; null when there is no ClinicalTrials.gov record), primary_outcomes [{measure, time_frame}] and eligibility criteria. Results are cached for up to 7 days; refresh=True bypasses the cache. Example queries: "phase 3 trials for atopic dermatitis", "completed PD-1 inhibitor trials with results", "industry-sponsored breast cancer trials started after 2022", "recruiting lung cancer trials in the United States". Returns a list of trial records.

find_clinical_trials

Search Gosset's database of drugs and drug candidates by name, target, disease, developer, modality, development phase or route of administration, using a natural-language query. Use when the user asks which drugs exist for a target, disease or mechanism, which drugs a company is developing, or for facts about a named drug (developer, target, modality, phase, indications, approval status). Behavior and limits: - The search returns broad matches: loosely related drugs can appear, so filter the returned records to what the user asked for. - The query filters only by name, disease, target, developer, modality, phase and route of administration. Other constraints (dates, geography, biomarkers, dosing) are not applied; filter the results for those. - effort="low" (default) queries the database directly and returns in about a second. effort="medium" or "high" adds semantic search, LLM reranking and a web search and takes 30 to 200 seconds; use them only when a low-effort search returns nothing relevant for a drug that should exist, such as a very new compound or an unusual spelling. - Records without an id are drugs found in publications or on the web that are not yet in the database. - Results are cached for up to 7 days; refresh=True bypasses the cache. Example queries: "pembrolizumab", "PD-1 inhibitors", "Merck antibody", "approved breast cancer", "phase 3 oral obesity drugs". Returns {items, count, query}: the matching drug records (names, developers, targets, modalities, diseases, phase), the number returned, and the parsed query.

find_drugs

Search Gosset's database of biotech and pharmaceutical companies by name, category, therapeutic area, modality, target, development stage or location, using a natural-language query. Use when the user asks about a company's focus, pipeline or status, or for companies that match criteria such as "clinical-stage gene therapy companies in Boston". effort="low" (default) searches the company database and returns in about a second. effort="medium" or "high" adds a web search and LLM reranking and takes 30 to 200 seconds; use them only when a low-effort search returns nothing relevant for a company that should exist. Example queries: "Genentech", "Boston biotech companies", "PD-1 antibody developers", "clinical stage gene therapy". Returns {items, count, query}: the matching company records (therapeutic focus, pipeline, financial status), the number returned, and the parsed query.

find_pharma_companies

Search Gosset's database of biopharma transactions: licensing agreements, acquisitions and mergers, collaborations and similar deals. Use when the user asks about deals involving a company, drug, target, modality or therapeutic area, or for precedent transactions and their terms (upfront payment, total value, date). effort="medium" (default) combines the database search with a web search and LLM ranking to match deals to drugs and diseases. effort="low" searches the database only; it is faster and can miss deals for narrow queries. effort="high" runs a wider search and takes longer. Results are cached for up to 7 days; refresh=True bypasses the cache. Example queries: "Merck licensing deals", "PD-1 acquisitions over 1 billion", "Roche acquisitions 2023", "anti-TL1A antibody deals". Returns {items, count, query}: the matching deals (parties, deal type, date, values, assets), the number returned, and the parsed query.

find_pharma_deals

Search Gosset's timeline of dated pharma and biotech events, such as approvals, FDA designations, discontinuations, deals, financings and trial readouts. Event types: drug approvals, FDA designations (Breakthrough Therapy, Fast Track, Orphan Drug, Priority Review, RMAT), program discontinuations, licensing and acquisition deals, company financings (venture rounds, IPOs), clinical trial milestones and result readouts, and news. Use when the user asks what happened over a period for a drug, company, target, modality or disease, or for events of one type, such as Breakthrough Therapy designations granted this year. The query can name entities, an event type and a date window ("last week", "in 2024", "between 2025-01-01 and 2025-06-30"). Results are cached for up to 7 days; refresh=True bypasses the cache. Each event has event_type, date, title, summary, url, importance and the linked drugs, companies, diseases, targets and modalities, plus type-specific fields such as designation_type or amount_usd. Returns a list of events, newest first.

find_pharma_events

Search Gosset's stored feed of pharma and biotech news articles and company press releases. Use when the user asks for recent news or press releases about a company, drug, disease or target, or for news of one kind, such as FDA decisions or acquisitions. Only articles already stored in Gosset are searched; the web is not searched at request time. Results are cached for up to 7 days; refresh=True bypasses the cache. Each article has title, date, source, url, companies, drugs, diseases, targets, categories (for example M&A, FDA, Clinical, Conference) and article_type. Example queries: "Merck press releases about pembrolizumab", "FDA approvals 2024", "atopic dermatitis news". Returns a list of articles, newest first.

find_pharma_news

Get the status of one research report and, once it is finished, its output. Use when the user wants to check on or read a report started with submit_research_report, given its report_id (returned by submit_research_report or list_research_reports). Only reports submitted by the caller's own account can be read. Status is one of pending, processing, qc (waiting for human review), done, error, paused or quota_exceeded. While the status is pending or processing, check again later; reports usually take 10 to 45 minutes. Returns {report_id, status, final_output, created_at, error}. final_output is markdown with links to the report files and is empty until the status is done.

get_research_report

List the research reports the caller's account has submitted, newest first. Use when the user asks which reports they have, or needs the report_id of an earlier report to read it with get_research_report. Only the caller's own reports are returned. Optional filters: status, and a text match on the prompt. Returns {reports: [{report_id, prompt, status, agent_type, created_at, completed_at}], count}.

list_research_reports