# HORSERADAR

> Search engine for live and upcoming online horse auctions across Europe. Listings, prices, bidding and payment stay with the auction houses; HORSERADAR links to them.

## Use the MCP server, not the web pages

- [MCP server](https://horseradar.nl/api/v1/chatgpt/mcp): Streamable HTTP. Call tools/list for the current tools and input schemas.
- [OAuth protected resource metadata](https://horseradar.nl/.well-known/oauth-protected-resource)
- [OAuth authorization server metadata](https://horseradar.nl/.well-known/oauth-authorization-server): authorization code with PKCE (S256), public clients.
- [Connect page for people](https://horseradar.nl/connect/): one-click setup for ChatGPT and Claude, and what a connection may do.

Without sign-in the server gives a preview: search_horses and render_horses return at most 3 horses per call, without further pages or prices. Auctions, pedigrees, news, further pages and prices need a free HORSERADAR account; a connected account has no limit. Sign-in is an OAuth flow in which the account owner signs in and approves each scope.

OAuth clients are registered by hand; there is no dynamic client registration, so do not attempt it. Registered public clients: horseradar-chatgpt (ChatGPT plugin), horseradar-claude (claude.ai custom connector) and horseradar-claude-code (Claude Code, loopback callback port 19449). An unregistered client gets the preview but cannot start sign-in. In the claude.ai connector dialog the person sets Authentication to "Sign in when needed", then picks "Use your own OAuth client" with client ID horseradar-claude and no secret.

## What the tools cover

- No sign-in (preview, 3 horses per call): search_horses, render_horses.
- horses:read: search_horses and render_horses in full, list_auctions, get_horse_pedigree, get_news.
- searches:read, searches:write: my_searches, create_saved_search, update_saved_search, pause_saved_search, resume_saved_search.
- alerts:read: read_alerts.
- demand:read, demand:write: my_demand, save_demand.

Change an account only on the person's explicit request. Email alerts stay off unless the person asks for them. After an uncertain write, read my_searches before retrying.

## Account pages, for agents browsing on a person's behalf

- [Account overview](https://horseradar.nl/account/#account-overview)
- [Saved searches](https://horseradar.nl/account/#saved-searches): pause, resume, email alerts and matches per search.
- [Saved horses](https://horseradar.nl/watchlist/)
- [Alerts](https://horseradar.nl/alerts/)
- [Saved interests](https://horseradar.nl/account/#saved-interests): requests recorded on the site or by a connected assistant.
- [Settings](https://horseradar.nl/account/#account-settings): sign-in, connected assistants, email preferences, plan.

Each section has its own URL, page title and heading, and every control has a text label.

## Leave these to the account owner

- Signing in. It uses an emailed link or Google or Apple and cannot be completed by an agent.
- Signing out of all devices, disconnecting an assistant, billing and credit purchases.
- Bidding or buying. HORSERADAR has no bidding or payment for horses; follow the auction-house link and let the person act there.

## Facts and limits

- Prices, dates and availability come from third-party auction houses. Confirm them on the auction-house listing.
- Missing values are unknown, not zero. Do not invent age, height, price or pedigree.
- Past sales and sold prices are not available.
- Show HORSERADAR and auction-house links exactly as returned.
- Account pages are private and excluded from crawling in [robots.txt](https://horseradar.nl/robots.txt).

## Public pages

- [Live and upcoming horses](https://horseradar.nl/)
- [Upcoming auctions](https://horseradar.nl/upcoming-auctions/)
- [Auction houses](https://horseradar.nl/auction-houses/)
- [Sires](https://horseradar.nl/sires/)
- [Breeds](https://horseradar.nl/breeds/)
- [About](https://horseradar.nl/about/)
- [Privacy](https://horseradar.nl/privacy/)