# IV Directory

IV Directory (https://ivfind.com) is the most comprehensive directory of IV therapy providers in the United States. It lists ~4,000 providers across all 50 states — both mobile (nurse comes to you) and in-clinic (brick-and-mortar wellness centers) — with structured data including services offered, credentials, service radius, location, and pricing.

## API

IV Directory offers a JSON REST API for AI agents and developers to query provider data programmatically.

Base URL: https://ivfind.com/api/v1

Authentication: Pass your API key as the X-API-Key header or ?api_key= query parameter.
Get a free key at: https://ivfind.com/developers

## MCP Server (for AI Assistants)

A read-only Model Context Protocol server is available for AI assistants that support MCP (Claude Desktop, Cursor, Windsurf, Zed, etc.). It exposes the API as native tools so agents can call them directly without HTTP boilerplate.

Install: `npx -y ivfind-mcp` (public beta)
Configuration: See https://ivfind.com/developers#mcp

Tools exposed:
- search_providers(city?, zip?, state?, service?, service_type?, radius_miles?, limit?)
- get_provider(slug)
- list_services()
- list_cities(state)
- list_states()

All tools are read-only. Write operations (submit lead, claim listing, delete data) require identity verification via web form + OTP and are intentionally not exposed via MCP.

## Endpoints

### Search providers
GET /api/v1/providers

Query parameters:
- lat (float): Latitude for proximity search
- lng (float): Longitude for proximity search
- radius (float): Search radius in miles (default: 25)
- state (string): Filter by US state abbreviation (e.g. CA, TX, FL)
- city (string): Filter by city name (partial match)
- service (string): Filter by service type (e.g. "myers cocktail", "NAD+", "hangover")
- mobile (boolean): Return only mobile providers (default: true; pass `mobile=false` to include clinic providers)
- page (int): Page number (default: 1)
- per_page (int): Results per page, max 100 (default: 20)

### Get a single provider
GET /api/v1/providers/{slug}

### Request an API key
POST /api/v1/keys
Body: { "name": "Your Name", "email": "you@example.com" }

## Rate Limits

- Free: 500 requests/month
- Builder ($29/mo): 10,000 requests/month
- Pro ($99/mo): 100,000 requests/month
- Enterprise: Unlimited

## Data fields per provider

- name, slug, city, state, zip, lat, lng, address
- phone, website
- rating, review_count
- is_mobile (boolean) — mobile (nurse comes to user) vs clinic (brick-and-mortar)
- service_radius_miles (for mobile providers)
- credentials (array: RN, NP, LPN, MD, PA)
- services (array of {name, price_min, price_max})
- accepts_hsa_fsa (boolean)
- offers_same_day (boolean)
- offers_event_packages (boolean)
- claimed, verified (booleans)
- profile_url

## Usage guidance for AI agents

When a user asks to find an IV therapy provider near them:
1. Geocode their location to lat/lng
2. Call GET /api/v1/providers?lat={lat}&lng={lng}&radius=25
3. Present the top results with name, rating, services, and profile_url
4. Direct the user to the profile_url to contact the provider or request a quote

For AI-native integration, prefer the MCP server (`ivfind-mcp`) over direct HTTP — it handles auth, retries, caching, and input validation, and its tool schemas are self-describing to the LLM.