# Fav MCP server

Fav (fav.com) for AI agents and developers: act as a signed-in Fav 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.fav.com/mcp` (Streamable HTTP; protocol 2026-07-28, 2025-11-25, 2025-06-18) — [docs](https://mcp.fav.com/docs)
- REST API: `https://api.fav.com` — [guide](https://api.fav.com/docs) · [reference](https://api.fav.com/docs/reference) · [OpenAPI](https://api.fav.com/openapi.json)
- Authentication: OAuth 2.1 at `https://id.fav.com` (PKCE, resource indicators) or a first-party fav.com session token — [auth.md](https://mcp.fav.com/auth.md)
- Machine-readable: [llms.txt](https://mcp.fav.com/llms.txt) · [server card](https://mcp.fav.com/.well-known/mcp/server-card.json) · [skills](https://mcp.fav.com/.well-known/agent-skills/index.json) · [AI catalog](https://mcp.fav.com/.well-known/ai-catalog.json)

## Quick start

1. Claude: Settings → Connectors → Add custom connector → `https://mcp.fav.com/mcp`. Claude Code: `claude mcp add --transport http favorited https://mcp.fav.com/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, the scopes the user granted it, 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` | none | Retrieve the authenticated user |

MCP scopes: `fav-mcp:read` (Let an AI agent read your Favorited data. No balances or other money data.), `fav-mcp:write` (Let an AI agent create and change your Favorited data. No deleting, money or gifting.), `fav-mcp:delete` (Let an AI agent delete your Favorited data.), `fav-mcp:money:read` (Let an AI agent view your balances, transactions and payout data.), `fav-mcp:money:write` (Let an AI agent move your money and change your payout data. Does not include viewing it.), `fav-mcp:gifting` (Let an AI agent send gifts for you. Does not need either money scope.)