# Favorited — MCP server

> Favorited (fav.com) for AI agents and developers: act as a signed-in Favorited user — read their profile today, more of the product as it ships — over an MCP server or a versioned REST API. Every call sees only that user’s data.

MCP endpoint: https://mcp.api-mcp-fav-com.preprod.favorited.app/mcp (Streamable HTTP; protocol 2026-07-28, 2025-11-25, 2025-06-18). REST API: https://api.api-mcp-fav-com.preprod.favorited.app (send `Fav-Version: 2026-09-24.albus`). Authentication: a first-party fav.com session token (OAuth for third-party clients is not open yet) — the procedure is in auth.md.

## Docs

- [MCP server: what it is and how to connect](https://mcp.api-mcp-fav-com.preprod.favorited.app/docs)
- [REST API guide](https://api.api-mcp-fav-com.preprod.favorited.app/docs) · [API reference](https://api.api-mcp-fav-com.preprod.favorited.app/docs/reference) · [OpenAPI](https://api.api-mcp-fav-com.preprod.favorited.app/openapi.json)
- [Authentication recipe (auth.md)](https://mcp.api-mcp-fav-com.preprod.favorited.app/auth.md)
- [MCP server card](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/mcp/server-card.json)
- [AI catalog](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/ai-catalog.json) · [API catalog (RFC 9727)](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/api-catalog)

## MCP tools

- `whoami` (read) — Report who this connection acts as: the Favorited user (id, username, avatar), how the token was issued, its effective scopes, the API version results are rendered in, and how many catalog operations this connection may run. Call first when unsure who "me" is or what you may do.
- `ping` (read) — Connectivity and authentication check: answers pong with the server version and the signed-in user id, without calling any backing service.
- `fav.search` (read) — Search the catalog of everything Favorited can do for the signed-in user. Lists only the operations this connection may run, with their id, kind and REST equivalent. Use before fav.describe and fav.run.
- `fav.describe` (read) — One catalog operation in full: what it does, its parameter JSON Schema, its result JSON Schema, required scopes, REST equivalent and how to run it.
- `fav.run` (read) — Run a read operation from fav.search by id, with parameters per fav.describe. Returns the operation result: a JSON object whose `object` field names its type.

## Operations

- `me.get` — Retrieve the authenticated user. REST `GET /me`; MCP `fav.run`.

## Skills

- [favorited-connect](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/agent-skills/favorited-connect/SKILL.md): Connect an AI agent to Favorited: the MCP server, the REST API and how to authenticate.
- [favorited-users](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/agent-skills/favorited-users/SKILL.md): Users operations of the Favorited API and MCP server: me.get.