MCP server (AI agents)

Connect an AI agent to HGV Traders' public stock, jobs, business, and article search via the Model Context Protocol.

See /ai-search for an overview of why this exists.

Connection

URL: https://hgvtraders.com/api/mcp
Transport: MCP Streamable HTTP
Authentication: none — this is a public, read-only endpoint, open the same way the marketing site's search is.

Tool	Purpose	Parameters
`search_stock`	Search published stock listings (trucks, trailers, plant) by keyword and filters.	`query`, `assetClass`, `make`, `model`, `bodyType`, `minYear`, `maxYear`, `minPricePence`, `maxPricePence`, `condition`, `locationPostcode`, `radiusKm`, `page`, `perPage`, `sortBy`
`get_stock_detail`	Fetch full detail for one published stock listing by id or slug.	`id`, `slug`
`search_businesses`	Search published dealers/suppliers by keyword and filters.	`query`, `businessType`, `city`, `categorySlug`, `verified`, `hasStock`, `radiusKm`, `page`, `perPage`, `sortBy`
`get_business_detail`	Fetch full detail for one published dealer/supplier by id or slug.	`id`, `slug`
`search_jobs`	Search published job listings by keyword and filters.	`query`, `categorySlug`, `department`, `contractType`, `remote`, `city`, `experienceLevel`, `minSalaryPence`, `maxSalaryPence`, `radiusKm`, `page`, `perPage`, `sortBy`
`get_job_detail`	Fetch full detail for one published job listing by id or slug.	`id`, `slug`
`search_articles`	Search published news/articles by keyword and category.	`query`, `categorySlug`, `page`, `perPage`

All list tools return { hits, total, page, totalPages }; detail tools return the listing directly, or an error if not found.

Shared with the public read API: 60 requests per minute per IP. See Rate limits.

Claude Desktop / Claude.ai: Settings → Connectors → Add custom connector → paste https://hgvtraders.com/api/mcp.

Any MCP-compatible client that supports the Streamable HTTP transport connects the same way — point it at the URL above, no API key required.