Valet Trash Guide for developers and AI agents
Everything on the site is available to software for free: a JSON API, an MCP server, WebMCP tools and a Markdown version of every page. No key, no signup.
What you can use
| Surface | Address | Use it for |
|---|---|---|
| JSON API | https://valettrashguide.com/api/v1/ (reference, OpenAPI) |
Search, page lists, state rules and data, sourced statistics, cost estimates |
| MCP server | https://valettrashguide.com/mcp (docs) |
Connecting an AI assistant or agent that speaks MCP |
| WebMCP tools | Registered on every page | Browser agents working on the site itself |
| Markdown | Page path plus .md, or Accept: text/markdown |
Reading a guide or policy page without the HTML |
| llms.txt | /llms.txt and /llms-full.txt | A map of the site and the full text of every page |
| Bulk JSON | /api/v1/*.json | Downloading pages, states or statistics in one file |
Free, no key, no signup
Everything here is free and read-only. Nothing needs an API key, an account or a signup. The API allows 60 requests per 60 seconds per IP address and the MCP server 120; see rate limits.
Quote freely, with a link to the canonical page URL that comes with each result.
Quickstart
Search the guide:
curl -sS 'https://valettrashguide.com/api/v1/search?q=valet+trash&limit=3'
Estimate the cost for a 250-unit community with pickup five nights a week:
curl -sS 'https://valettrashguide.com/api/v1/estimate?units=250&nights=5'
Read a page as Markdown:
curl -sS -H 'Accept: text/markdown' https://valettrashguide.com/about/
Add the MCP server to Claude Code:
claude mcp add --transport http valet-trash-guide https://valettrashguide.com/mcp
Other clients and the raw protocol are on the MCP server page.
WebMCP tools in the browser
Every page registers the same five read-only tools for in-browser agents with document.modelContext.registerTool(): search_guides, read_page, get_state_guide, get_statistic, estimate_valet_trash_cost. Each declares readOnlyHint: true and calls the JSON API or a page’s Markdown version. WebMCP runs in Chrome with the WebMCP origin trial or the chrome://flags/#enable-webmcp-testing flag; other browsers skip the script.
Discovery files
- /.well-known/ard.json: Agentic Resource Discovery catalog of the MCP server, the API and the agent skill (also at /.well-known/ai-catalog.json).
- /.well-known/api-catalog: RFC 9727 API catalog pointing to the OpenAPI description.
- /mcp/server-card: MCP server card (also at /.well-known/mcp/server-card.json).
- /.well-known/agent-skills/index.json: Agent Skills index with the valet-trash-guide skill.
- /robots.txt: every search engine and AI crawler is allowed; content signals allow search, AI input and AI training.
- /sitemap.xml: every canonical URL with its last-modified date.
More developer docs
- Valet Trash Guide API: Free, read-only JSON API for valet trash guides, state rules, statistics and cost estimates: operations, examples, pagination, rate limits and errors.
- Valet Trash Guide MCP server: Connect an AI assistant to Valet Trash Guide over MCP (Streamable HTTP): search guides, read pages, get state rules, cite statistics, estimate costs.
- API error codes: Every error the Valet Trash Guide API returns, as RFC 9457 problem+json: what each code means and how to fix the request.