---
title: "Valet Trash Guide for developers and AI agents"
description: "Free, read-only access to valet trash guides, state rules, sourced statistics and cost estimates: JSON API, MCP server, WebMCP and Markdown. No key."
canonical: "https://valettrashguide.com/developers/"
last-updated: "2026-11-15"
author: "Valet Trash Guide Editorial Team"
publisher: "Valet Trash Guide"
license: "Quote with attribution and a link to the canonical URL."
---
# 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](https://valettrashguide.com/developers/api/), [OpenAPI](https://valettrashguide.com/openapi.json)) | Search, page lists, state rules and data, sourced statistics, cost estimates |
| MCP server | `https://valettrashguide.com/mcp` ([docs](https://valettrashguide.com/developers/mcp/)) | 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](https://valettrashguide.com/llms.txt) and [/llms-full.txt](https://valettrashguide.com/llms-full.txt) | A map of the site and the full text of every page |
| Bulk JSON | [/api/v1/*.json](https://valettrashguide.com/developers/api/#bulk-downloads) | 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](https://valettrashguide.com/developers/api/#rate-limits).

Quote freely, with a link to the canonical page URL that comes with each result.

## Quickstart

Search the guide:

```bash
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:

```bash
curl -sS 'https://valettrashguide.com/api/v1/estimate?units=250&nights=5'
```

Read a page as Markdown:

```bash
curl -sS -H 'Accept: text/markdown' https://valettrashguide.com/about/
```

Add the MCP server to Claude Code:

```bash
claude mcp add --transport http valet-trash-guide https://valettrashguide.com/mcp
```

Other clients and the raw protocol are on the [MCP server](https://valettrashguide.com/developers/mcp/) 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](https://valettrashguide.com/.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](https://valettrashguide.com/.well-known/ai-catalog.json)).
- [/.well-known/api-catalog](https://valettrashguide.com/.well-known/api-catalog): RFC 9727 API catalog pointing to the OpenAPI description.
- [/mcp/server-card](https://valettrashguide.com/mcp/server-card): MCP server card (also at [/.well-known/mcp/server-card.json](https://valettrashguide.com/.well-known/mcp/server-card.json)).
- [/.well-known/agent-skills/index.json](https://valettrashguide.com/.well-known/agent-skills/index.json): Agent Skills index with the [valet-trash-guide skill](https://valettrashguide.com/.well-known/agent-skills/valet-trash-guide/SKILL.md).
- [/robots.txt](https://valettrashguide.com/robots.txt): every search engine and AI crawler is allowed; content signals allow search, AI input and AI training.
- [/sitemap.xml](https://valettrashguide.com/sitemap.xml): every canonical URL with its last-modified date.

## More developer docs

- [Valet Trash Guide API](https://valettrashguide.com/developers/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](https://valettrashguide.com/developers/mcp/): 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](https://valettrashguide.com/developers/errors/): Every error the Valet Trash Guide API returns, as RFC 9457 problem+json: what each code means and how to fix the request.
