---
name: favorited-connect
description: Connect an AI agent to Favorited: the MCP server, the REST API and how to authenticate.
---

# Connect to Favorited

- **MCP server:** `https://mcp.fav.com/mcp` (Streamable HTTP). Call `whoami` first, then `fav.search` → `fav.describe` → `fav.run`.
- **REST API:** `https://api.fav.com`. Send `Fav-Version: 2026-09-24.albus` to pin the response shape; the OpenAPI document is `https://api.fav.com/openapi.json`.
- **Authentication:** `Authorization: Bearer <access token>` on both hosts. The procedure is in `https://mcp.fav.com/auth.md`.
- Every call acts as the signed-in Favorited user and only ever sees that user’s data.