markdown
# ezyVet MCP Server

An MCP (Model Context Protocol) server for ezyVet veterinary practice management API v1.

## Overview

This MCP server provides AI agents with 8 tools to read and manage animals, contacts, appointments, consults, invoices, and products across an ezyVet veterinary practice deployment.

## Features

- **8 MCP Tools** for veterinary practice management
- **OAuth 2.0 Client Credentials** authentication with auto token renewal
- **Async HTTP** via httpx for efficient API calls
- **Pydantic v2** schemas for type-safe inputs/outputs
- **Write-gated** appointment creation (requires env flag)

## Tools

| Tool | Endpoint | Description |
|------|----------|-------------|
| `list_animals` | GET /animal | List animals with pagination |
| `get_animal` | GET /animal/{id} | Get single animal by ID |
| `list_contacts` | GET /contact | List contacts (pet owners/clients) |
| `list_appointments` | GET /appointment | List appointments with date filtering |
| `create_appointment` | POST /appointment | Create new appointment (write-gated) |
| `list_consults` | GET /consult | List clinical consult records |
| `list_invoices` | GET /invoice | List invoices |
| `list_products` | GET /product | List products |

## Installation