vetsorcery-mcp
Officialby AIVA-VET
README.md
# vetsorcery-mcp
MCP server for VetSorcery — query problem lists, SOAP notes, and patient summaries from Claude Desktop, Cursor, Windsurf, or any MCP-compatible agent.
This repo is the primary integration point for local-first AI workflows around VetSorcery clinical data.
## Connection
VetSorcery MCP expects an authorized clinic context. Configure the server with the clinic scope granted by your VetSorcery deployment. Cross-tenant access is enforced at the database layer.
## Tools
| Tool | Purpose |
| :--- | :--- |
| `query_problem_list` | Active problems for a patient |
| `get_soap_history` | SOAP notes by problem and date range |
| `search_clinical_notes` | Full-text search over flat SOAP collection |
| `write_soap_draft` | Create a draft SOAP note from AI-generated content |
| `get_patient_overview` | Aggregated patient history and recent events |
## Related
- `AIVA-VET/vet-spec` — `.vet` format standard
- VetSorcery clinical docs: `CLINICAL_SPEC.md`, `DATA_MODEL.md`, `RUNTIME_MODEL.md`
## License
MIT
TDQS
B3.2/5.0
Scored across 5 tools
Disambiguation5/5
Each tool targets a distinct aspect of veterinary clinical data: patient overview, SOAP history, problem list, full-text search, and draft creation. No overlap in functionality.
Naming Consistency5/5
All tool names follow a consistent verb_noun pattern (e.g., get_patient_overview, write_soap_draft), making the set predictable and easy to navigate.
Tool Count5/5
With 5 tools, the set is well-scoped for a veterinary EHR assistant, covering key operations without being excessive or too sparse.
Completeness4/5
Core workflows like retrieving and writing SOAP notes, querying problems, and searching are covered. Missing update/delete operations for problems or notes, but the set handles primary clinical tasks.
Maintenance
ActivityInactive
ResponsivenessNo issues