# Mufmuf

> Mufmuf scores how visually compatible two photos are. Send two images and get
> a 1-10 compatibility score with sub-scores (style, energy, presentation,
> aesthetic harmony) and a short explanation. AI-generated and directional only,
> not a factual judgment. Photos are processed for the comparison and deleted
> automatically within 28 days.

Mufmuf is best used by an agent or tool as a callable capability: "score the
visual compatibility of these two photos." It is not a fact-lookup site. The
same scoring is available as a public HTTP API and as an MCP server.

## For agents and tools

- [Compatibility API (OpenAPI)](https://mufmuf.app/openapi.yaml): `POST /api/v1/compare`. Send two base64 or data-URI images, get `{ score, subScores, summary, disclaimer }`. Auth: `Authorization: Bearer mk_live_...`.
- [MCP server `mufmuf-mcp`](https://www.npmjs.com/package/mufmuf-mcp): exposes a `compare_compatibility` tool over stdio for Claude Desktop, Cursor, VS Code, and other MCP clients. Source: `mcp/` in the repo.
- [Get an API key](https://mufmuf.app/settings/api-keys): mint an `mk_live_...` key (per-key daily request limit).

## Call the API

```bash
curl -sX POST https://mufmuf.app/api/v1/compare \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "userImage":   "data:image/jpeg;base64,<...>",
    "targetImage": "data:image/png;base64,<...>"
  }'
# -> { "score": 8, "subScores": { "style": 8, ... }, "summary": "...", "disclaimer": "..." }
```

## Notes

- Privacy: photos are processed only to produce the comparison; the target image is held in memory for the single request and uploaded match-check photos are deleted automatically within 28 days.
- Limits: each API key has a per-key daily request cap. When exceeded the API returns HTTP 429 with `{ error: "rate_limited", limit, resetsAt }`.
- The result is directional and for fun, not a factual, scientific, or professional judgment.