# 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 server: `https://mcp.api-mcp-fav-com.preprod.favorited.app/mcp` (Streamable HTTP; protocol 2026-07-28, 2025-11-25, 2025-06-18) — [docs](https://mcp.api-mcp-fav-com.preprod.favorited.app/docs)
- REST API: `https://api.api-mcp-fav-com.preprod.favorited.app` — [guide](https://api.api-mcp-fav-com.preprod.favorited.app/docs) · [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: a first-party fav.com session token (OAuth for third-party clients is not open yet) — [auth.md](https://mcp.api-mcp-fav-com.preprod.favorited.app/auth.md)
- Machine-readable: [llms.txt](https://mcp.api-mcp-fav-com.preprod.favorited.app/llms.txt) · [server card](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/mcp/server-card.json) · [skills](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/agent-skills/index.json) · [AI catalog](https://mcp.api-mcp-fav-com.preprod.favorited.app/.well-known/ai-catalog.json)

## Quick start

1. Claude: Settings → Connectors → Add custom connector → `https://mcp.api-mcp-fav-com.preprod.favorited.app/mcp`. Claude Code: `claude mcp add --transport http favorited https://mcp.api-mcp-fav-com.preprod.favorited.app/mcp`. Any other client: add a Streamable HTTP server with that URL.
2. Authenticate (see auth.md).
3. Ask: "Using the Favorited tools, who am I?"

## Tools (5)

| Tool | Kind | What it does |
| --- | --- | --- |
| `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. |

The tool list is fixed. Everything Favorited can do is an **operation** in the catalog: find it with `fav.search`, read its schema with `fav.describe`, run it with `fav.run`. Results are rendered in API version `2026-09-24.albus`.

## Operations

| Operation | REST | Scopes | What it does |
| --- | --- | --- | --- |
| `me.get` | `GET /me` | `user:read` | Retrieve the authenticated user |

MCP scopes: `mcp:read` (Let an AI agent read your Favorited data.), `mcp:write` (Let an AI agent act on your behalf.)