---
title: "Americans Home developer portal — agent context"
description: "Scoped context for integrating: quickstart, MCP servers, sandbox, and SDKs."
canonical: https://americanshomeqa.com/mattress-finder/developers/llms.txt
last-updated: 2026-09-09
site: Americans Home
---
# Americans Home for developers

> Everything needed to integrate: a public REST API, two MCP servers, a natural-language endpoint, and a sandbox that never touches production.

Portal: [https://americanshomeqa.com/mattress-finder/en/developers](https://americanshomeqa.com/mattress-finder/en/developers)

## Start here, with no signup

```bash
curl 'https://americanshomeqa.com/mattress-finder/api/v1/recommend?position=side&weight=k60to90&thermal=hot'
```

Reads need no credential at all. For writes, the published sandbox key `ah_test_sandbox` is always valid and never persists anything:

```bash
curl -X POST https://americanshomeqa.com/mattress-finder/api/v1/shortlists \
  -H 'Authorization: Bearer ah_test_sandbox' \
  -H 'Idempotency-Key: unique-1' \
  -H 'Content-Type: application/json' \
  -d '{"outcomeId":"side-sleeper-sleeps-hot-60-90kg"}'
```

## MCP servers

Both speak streamable HTTP and need no auth.

- `https://americanshomeqa.com/mattress-finder/mcp` — product tools: `recommend_mattress`, `lookup_qatar_mattress_size`, `browse_products`
- `https://americanshomeqa.com/mattress-finder/mcp/docs` — documentation tools: `search_documentation`, `fetch_document`, `list_faq_topics`

Cards: [product](https://americanshomeqa.com/mattress-finder/.well-known/mcp/server-card.json) · [docs](https://americanshomeqa.com/mattress-finder/.well-known/mcp/docs/server-card.json)

## Sandbox

A `ah_test_` key validates a write exactly as a live key does, returns the same response shape, and stores nothing. Nobody at the showroom is contacted. Use it to exercise error paths without consequences.

## Skills

Each capability is published as a SKILL.md with a sha256 digest in the [skills index](https://americanshomeqa.com/mattress-finder/.well-known/agent-skills/index.json).

## Also

- [Authentication](https://americanshomeqa.com/mattress-finder/auth.md)
- [API context](https://americanshomeqa.com/mattress-finder/api/llms.txt)
- [OpenAPI](https://americanshomeqa.com/mattress-finder/openapi.json)
- [Versioning policy](https://americanshomeqa.com/mattress-finder/api/v1/versions)