Tool Reference#

Every tool exposed by the GekkoVet MCP server is listed here, grouped by domain. The AI assistant chooses tools automatically based on what you ask — this reference is primarily for understanding capabilities and debugging.

Tool definitions are generated from the same function registry that powers GekkoVet’s own assistants, so the canonical list always matches what’s running in production. To see the exact JSON schema for a given tool, invoke tools/list via the MCP Inspector.

Animal types & diseases#

ToolPurpose
list_animal_typesLists all supported animal types. Common IDs: Dogs=2, Cats=1, Horses=3.
search_diseasesSemantic search for diseases, conditions, and medical issues. Accepts natural-language queries.
search_diseases_by_symptomsFinds diseases commonly associated with a set of symptom IDs, ranked by frequency.
get_disease_infoComprehensive disease record — symptoms, diagnostic criteria, predisposing and downstream conditions.

Treatments#

ToolPurpose
get_treatment_protocolsAvailable treatment protocols/sets for a given disease.
get_treatmentsDetailed treatments for a specific protocol — procedures, medications, follow-up instructions.
get_treatment_detailsFull detail for a single treatment, including drug substances and instructions.

Drugs#

ToolPurpose
search_drug_substancesFind drug substances by name (e.g. “meloxicam”, “carprofen”), optionally filtered by animal type.
get_complete_drug_infoAll dosing protocols, alternatives, and indications for a drug and animal type. Can compute a patient-specific dose.

Symptoms#

ToolPurpose
search_symptomsFind symptom IDs by name or description — used as a building block for symptom-based disease lookup.

Cases#

ToolPurpose
create_caseCreate a new diagnostic case for background analysis (differential diagnosis). Pass the user’s clinical anamnesis directly — symptom extraction happens automatically.
get_caseRetrieve the full case record: patient details, selected diagnoses, selected treatments, symptoms, clinical notes. The single source of truth for everything in a case.
update_caseReplace selected symptoms, add diagnoses, select treatments, or update notes. Symptom updates trigger diagnosis recalculation.

Attachments#

ToolPurpose
get_attachment_infoRetrieve attachment info and extracted text from uploaded files (lab results, PDFs, images).
wait_for_attachment_contentBlock until an attachment finishes processing, then return the extracted content.
check_attachment_statusNon-blocking status check for an in-progress attachment.

Clinical documents#

ToolPurpose
generate_documentGenerate discharge papers, client instructions, case summaries, or referral letters. Uses Claude Opus for highest quality. Respects user-specific writing templates.
revise_documentRevise an existing document based on feedback — creates a new version while preserving the original.
get_documentRetrieve a document by ID.
list_documentsList documents for the current conversation or a specific case.

Diagnostic#

ToolPurpose
whoamiReturns the authenticated veterinarian’s ID, email, name, and Cognito subject. Useful for sanity-checking your MCP session.