QuailOS MCP Server

About QuailOS

Remote MCP server for QuailOS (Undique LLC). Public tools work without an account (farm directory, guides, NPIP stock codes, genetics). Farm data tools need X-Api-Key and X-Farm-Id headers from QuailOS Settings > Integrations. Streamable HTTP endpoint: https://www.quailos.com/api/mcp/message. Docs: https://www.quailos.com/auth.md. Official registry: com.quailos/quailos. License: Proprietary (hosted service).

QuailOS tools (102)

Read from the live server on Nov 8, 2026. These are the tools your AI assistant can call once connected.

plan_flock

Calculate chicken/quail flock sizing, incubation guidelines, weekly feed, spaces, and costs for any of the 310 avian breeds.

start_signup

Start a QuailOS signup from chat: returns a personal prefilled signup link for the farmer (name, email, optional farm name/state/phone/species). The link expires in 7 days and nothing is created until the farmer opens the link, verifies ema

update_order_notes

Appends a timestamped 'via AI' note by default

list_vehicles

Retrieve registered farm vehicles for mileage logging. Requires farmId and apiKey authorization.

get_support_tickets

List support tickets created by this farm. Requires farmId and apiKey authorization.

create_support_ticket

Create a new support ticket. ALWAYS ask for confirmation before writing.

reply_to_ticket

Add a reply message to an open support ticket. ALWAYS ask for confirmation before writing.

get_feature_requests

List feature requests submitted by this farm. Requires farmId and apiKey authorization.

create_feature_request

Submit a new feature request or upvote an existing matching request. ALWAYS ask for confirmation before writing.

get_ticket_thread

Retrieve full reply history and messages thread of a support ticket. Requires farmId and apiKey authorization.

get_hatches

Retrieve incubation and hatch batches. Requires farmId and apiKey authorization.

log_hatch_set

Start a new incubation batch, auto-calculating lockdown/hatch dates. ALWAYS ask for confirmation before writing.

log_candling

Log egg candling fertility results for an active batch. ALWAYS ask for confirmation before writing.

log_hatch_result

Complete a batch by logging final hatch count, calculating stats, and optionally creating a bird batch. ALWAYS ask for confirmation before writing.

log_hive_inspection

Log a detailed beekeeping hive inspection. ALWAYS ask for confirmation before writing.

log_varroa_treatment

Record a mite treatment chemical or acid application. ALWAYS ask for confirmation before writing.

log_honey_harvest

Log honey extracted and optionally add directly to stock inventory. ALWAYS ask for confirmation before writing.

update_queen_status

Update the live queenright and breeder metadata settings of a hive. ALWAYS ask for confirmation before writing.

create_hive

Register a new beehive in an apiary yard. ALWAYS ask for confirmation before writing.

ping

Verify server connectivity, handshake responsiveness, and platform status.

get_npip_stock_codes

Resolve biological poultry and game-bird varieties to regulatory federal NPIP stock numbers.

get_public_farms

Search the QuailOS public farm directory. Retrieve farm names, locations, specialties, and bios.

get_public_wiki_pages

Search published public QuailOS poultry, game-bird, and hatchery guide articles and walkthroughs.

list_quail_varieties

List all registered Coturnix quail varieties with their display names, unique IDs, description, and exact genotype mappings.

predict_quail_cross

Calculate offspring plumage color probability distributions and percentages when crossing a specific sire and dam variety.

find_quail_pairings

Perform a reverse genetic lookup to find all possible parent pairings (sire and dam) that can produce a targeted plumage color variety.

get_tasks

Retrieve farm management tasks, newest due date first by default (tasks without a due date last). Filters: status (Pending | In Progress | Completed, case-insensitive, string or array; omit for all), excludeCompleted, dueFrom/dueTo (inclusi

get_calendar_events

Retrieve calendar events for the farm including hatches, local events, rentals, and task due dates. Requires farmId and apiKey authorization.

get_orders

Retrieve the farm's sales orders (manual, connected stores and incoming dropships), newest first. Returns { totalMatches, totalMatchesIsExact, truncated, hasMore, nextCursor, orders }. For connected store orders, includes marketplaceStatus

get_order_feedback

List customer feedback left on online orders (the Online Orders > Feedback tab): hatch-rate reports with eggs set/hatched, star rating and comments, plus shipping damage reports. Damage reports carry a masked contact (contactMasked) by defa

get_customer_details

Retrieve detailed profile of a specific customer in your CRM by email or name. Requires farmId and apiKey authorization.

get_meat_inventory

Retrieve meat processing logs and cold storage/freezer inventory. Requires farmId and apiKey authorization.

get_beekeeping_apiary

Retrieve active yards, hives, queen statuses, and varroa inspections. Requires farmId and apiKey authorization.

get_financial_pnl

Retrieve summarized expenses, income, cash flow, and profit-and-loss details. Requires farmId and apiKey authorization.

get_feed_inventory

Retrieve active feed inventory, feed purchases, and feed mill logs. Requires farmId and apiKey authorization.

get_vendors_and_pos

Retrieve purchase orders and vendor profiles. Requires farmId and apiKey authorization.

get_egg_collections

Retrieve daily egg production logs and collection counts. Requires farmId and apiKey authorization.

get_mileage_logs

Retrieve registered vehicle mileage logs for tax and expense auditing.

get_bird_batches

Retrieve active and archived poultry census batches from the flock inventory.

get_time_logs

Retrieve registered worker time clocks and logged task labor hours.

How to connect QuailOS to Claude, Cursor or VS Code

QuailOS runs as a hosted remote MCP server at https://www.quailos.com/api/mcp/message. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "quailos": {
      "url": "https://www.quailos.com/api/mcp/message"
    }
  }
}

Claude Code: claude mcp add --transport http quailos https://www.quailos.com/api/mcp/message. VS Code's .vscode/mcp.json uses a servers key instead of mcpServers (see how). Servers that require OAuth or an API key will prompt on first use.