# Build with Emora Health

Emora connects kids, teens, and young adults (ages 0–25+) with licensed therapists, psychiatrists, and psychologists — virtual, evidence-based, insurance-covered, and usually bookable within a week. This page describes the surfaces AI agents and developers can use to help people get to the right provider, faster.

## What agents can do

- Match a family to a great provider — by state, specialty, age, insurance, and availability.
- Check real-time appointment slots for a specific clinician.
- Estimate the user's exact copay from their insurance and member ID.
- Read clinically-reviewed editorial content on conditions, specialties, and care.
- Surface the canonical crisis-resource payload (988, 911, Crisis Text Line) the moment a user signals risk.
- Hand the user a pre-filled booking or matching-session URL — they confirm.

## MCP server

`POST https://www.emorahealth.com/api/mcp/v1` — Streamable-HTTP MCP, JSON-RPC 2.0, anonymous.

- Server card: https://www.emorahealth.com/.well-known/mcp/server-card.json
- Manifest (microsites): `/.well-known/mcp.json`

## A2A agent card

https://www.emorahealth.com/.well-known/agent-card.json

## Agent skills (v0.2.0)

https://www.emorahealth.com/.well-known/agent-skills/index.json

Conformant to https://schemas.agentskills.io/discovery/0.2.0/schema.json. Each entry references a per-skill SKILL.md plus a sha256 digest.

## OpenAPI 3.1 spec

https://www.emorahealth.com/openapi.json — same surface, OpenAPI flavor. Each operation maps 1:1 to an MCP tool.

## OpenAI plugin manifest

https://www.emorahealth.com/.well-known/ai-plugin.json

## llms.txt

- https://www.emorahealth.com/llms.txt
- https://www.emorahealth.com/llms-full.txt
- https://www.emorahealth.com/providers/llms.txt
- https://www.emorahealth.com/conditions/llms.txt
- https://www.emorahealth.com/insurance/llms.txt
- https://www.emorahealth.com/resources/llms.txt

## RFC 9727 API catalog

https://www.emorahealth.com/.well-known/api-catalog

## Auth

Anonymous read access. Just call.

- OAuth Protected Resource metadata (RFC 9728): https://www.emorahealth.com/.well-known/oauth-protected-resource
- Web Bot Auth directory (RFC 9421): https://www.emorahealth.com/.well-known/http-message-signatures-directory

## Rate limits

Public agent endpoints emit `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `Retry-After` headers. Default: 120 requests / minute / IP. Email `hello@emorahealth.com` if you need more.

## Errors

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "resolution": "Wait and retry; see Retry-After header.",
    "retry_after": 30
  }
}
```

## Microsites

Our condition-specific microsites — childadhd.ai, teenadhd.ai, childanxiety.ai, teenanxiety.ai, childpsychiatry.ai, teenpsychiatry.ai, psychiatryforkids.com, teentherapy.ai, aprilfeels.com — each expose the same discovery surface scoped to their editorial corpus. Each is its own publisher with its own brand; this server is the canonical source for clinical-care actions.

## Contact

- Email: hello@emorahealth.com
- HTML version of this page: https://www.emorahealth.com/developers