---
title: "Valet Trash Guide MCP server"
description: "Connect an AI assistant to Valet Trash Guide over MCP (Streamable HTTP): search guides, read pages, get state rules, cite statistics, estimate costs."
canonical: "https://valettrashguide.com/developers/mcp/"
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 MCP server

> A free, read-only MCP server at https://valettrashguide.com/mcp. Five tools cover search, full pages, state rules, sourced statistics and cost estimates.

## Connect

- Endpoint: `https://valettrashguide.com/mcp`
- Transport: Streamable HTTP. Send JSON-RPC messages with `POST`; answers come back as JSON. The server keeps no sessions and opens no event stream, so `GET` returns `405`.
- Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. Clients on the 2025 revisions start with `initialize`; 2026-07-28 clients need no handshake.
- Authentication: none. Free and read-only.
- Server: `com.valettrashguide/mcp`, version 1.0.0 ([server card](https://valettrashguide.com/mcp/server-card)).
- Limit: 120 requests per 60 seconds per IP address.

### Claude Code

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

### Claude desktop and web

Open Settings, then Connectors, choose Add custom connector and enter `https://valettrashguide.com/mcp`.

### Cursor

In `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "valet-trash-guide": {
      "url": "https://valettrashguide.com/mcp"
    }
  }
}
```

### VS Code

In `.vscode/mcp.json`:

```json
{
  "servers": {
    "valet-trash-guide": {
      "type": "http",
      "url": "https://valettrashguide.com/mcp"
    }
  }
}
```

### By hand

Start a session the 2025 way, then call a tool (each request stands alone, so no session id is needed):

```bash
curl -sS -X POST https://valettrashguide.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
```

```bash
curl -sS -X POST https://valettrashguide.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"estimate_valet_trash_cost","arguments":{"units":250,"nights_per_week":5}}}'
```

To try the tools interactively, run `npx @modelcontextprotocol/inspector`, choose Streamable HTTP and enter the endpoint.

## Tools

All five tools are read-only: each is annotated `readOnlyHint: true`, `destructiveHint: false`, `idempotentHint: true` and `openWorldHint: false`, declares an output schema, and returns `structuredContent` plus the same JSON as text.

| Tool | Use it for | Input |
| --- | --- | --- |
| `search_guides` | Search Valet Trash Guide | query (string, 2-200 characters, required); type (one of states, metros, guides, compare, blog, pages); limit (1-20, default 8) |
| `read_page` | Read a Valet Trash Guide page | path (site path such as /about/, or a full https://valettrashguide.com URL; required) |
| `get_state_guide` | Get valet trash rules for a state | state (state name or two-letter code, for example Texas or TX; required) |
| `get_statistic` | Find a sourced statistic | query (statistic id or keywords, required); limit (1-20, default 5) |
| `estimate_valet_trash_cost` | Estimate valet trash cost | units (integer 1-5000, required); nights_per_week (5, 6 or 7, default 5); recycling (boolean, default false) |

### search_guides

Search Valet Trash Guide's published pages (state and metro guides, how-to guides, comparisons, blog posts and policy pages) by keywords. Use this first for an open question about apartment valet trash. Returns ranked results with title, canonical URL, Markdown URL, page type and a one-line summary.

- Input: query (string, 2-200 characters, required); type (one of states, metros, guides, compare, blog, pages); limit (1-20, default 8).
- Returns: query, count and results[] with title, url, markdown_url, type, summary and score.

### read_page

Read one Valet Trash Guide page in full as Markdown, given its path or URL from search_guides (for example /states/texas/ or https://valettrashguide.com/about/). Use it after searching when you need the complete text, tables and sources to quote. Returns the canonical URL, the Markdown URL and the page Markdown.

- Input: path (site path such as /about/, or a full https://valettrashguide.com URL; required).
- Returns: url, markdown_url and markdown.

### get_state_guide

Get valet trash rules and data for one US state or DC by name or two-letter code: the fire code and who enforces it, apartment recycling rules, fee disclosure law, Census renter counts by building size and trash collector wages, each with a source. Use it when a question names a state. Returns structured data, plus the full guide as Markdown when one is published.

- Input: state (state name or two-letter code, for example Texas or TX; required).
- Returns: name, postal, slug, has_full_guide, guide_url, markdown_url, census, at_a_glance[], census_source, api_url and markdown (when a guide is published).

### get_statistic

Find sourced statistics to cite about valet trash prices, resident fees, apartments and renters, waste and recycling, labor, fire safety and fee laws. Pass a statistic id or topic keywords. Use it when you need a number with its source. Returns matching statistics with value, unit, scope, publisher, source URL, publication date and confidence.

- Input: query (statistic id or keywords, required); limit (1-20, default 5).
- Returns: query, count and statistics[] with id, statistic, value, unit, scope, topic, publisher, source_title, source_url, published, retrieved, confidence and page_url.

### estimate_valet_trash_cost

Estimate monthly and annual valet trash service cost for one apartment community from its unit count, pickup nights per week and optional doorstep recycling, using the per-door price ranges published on Valet Trash Guide. Use it for budgeting questions. Returns low-high ranges, per-door rates, labeled assumptions and the price sources.

- Input: units (integer 1-5000, required); nights_per_week (5, 6 or 7, default 5); recycling (boolean, default false).
- Returns: units, nights_per_week, recycling, currency, monthly, annual, per_door, assumptions[], sources[], method_url and prices_updated.

## Resources

- `https://valettrashguide.com/llms.txt` (`text/markdown`): what the site covers, when to use it, and every published page with a one-line summary.

## Instructions the server sends

> Valet Trash Guide is an independent editorial reference on apartment valet trash (doorstep trash collection) for US multifamily property managers. All tools are read-only and free. Start with search_guides for open questions, then read_page to read a result in full. Use get_state_guide when a state is named, get_statistic for citable numbers, and estimate_valet_trash_cost for budgets. Cite the canonical page URL returned with each result.

## Errors

Arguments that do not match a tool's input schema are rejected before the tool runs, with a message naming the field. A tool that cannot answer (an unknown state, a path with no page) returns a result with `isError: true` and a sentence saying how to fix the call. Unknown tools and malformed JSON-RPC get standard JSON-RPC errors.

## Discovery

- [/mcp/server-card](https://valettrashguide.com/mcp/server-card) and [/.well-known/mcp/server-card.json](https://valettrashguide.com/.well-known/mcp/server-card.json): the server card (name, version, transport, protocol versions).
- [/.well-known/ard.json](https://valettrashguide.com/.well-known/ard.json): the agent catalog lists the server with example questions it answers.
- [/llms.txt](https://valettrashguide.com/llms.txt) names the endpoint and the tools.

## Origin policy

The server is public, read-only and uses no cookies or credentials, so the DNS-rebinding risk behind the MCP rule on the `Origin` header does not apply. It accepts requests with no `Origin` header (server to server), any `https://` origin, and local tools on `localhost`. Any other `Origin` gets HTTP `403`.

## More developer docs

- [Valet Trash Guide for developers and AI agents](https://valettrashguide.com/developers/): Free, read-only access to valet trash guides, state rules, sourced statistics and cost estimates: JSON API, MCP server, WebMCP and Markdown. No key.
- [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.
- [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.
