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, soGETreturns405. - 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). - Limit: 120 requests per 60 seconds per IP address.
Claude Code
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:
{
"mcpServers": {
"valet-trash-guide": {
"url": "https://valettrashguide.com/mcp"
}
}
}
VS Code
In .vscode/mcp.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):
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"}}}'
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 and /.well-known/mcp/server-card.json: the server card (name, version, transport, protocol versions).
- /.well-known/ard.json: the agent catalog lists the server with example questions it answers.
- /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: 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: 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: Every error the Valet Trash Guide API returns, as RFC 9457 problem+json: what each code means and how to fix the request.