# emrr, for AI agents

You're reading this because someone asked you to connect their emrr account. emrr (https://emrr.uz) is a
revenue app for founders: it reads Stripe, the App Store, Google Play, RevenueCat, Paddle, Lemon Squeezy,
Polar, Payme, Click, Shopify, PayPal, Telegram, YouTube, Instagram and more with read-only keys, and keeps
MRR, churn, sales, refunds, trials, downloads, ad spend and followers in one place. It speaks MCP, so you can read those numbers and answer questions
about them.

## 1. Sign in, or get a key

If your app supports MCP authorization (OAuth), just add `https://mcp.emrr.uz`: you'll get a 401 that
points at emrr's OAuth metadata, and the person signs in to emrr and chooses what you may do (read, or
read and write). Claude, ChatGPT and Claude Code work this way; nothing to paste. More:
https://emrr.uz/ai.

Otherwise, ask them to open https://emrr.uz/settings/agents, pick you, choose the access, tap **Create key**, and
paste the key (or the prompt it gives them) here. Keys come in two kinds, and they can revoke either on
that page; each has an expiry (30, 90 or 365 days, or none):

- **Read only**: reads the REST API and calls every MCP tool. Changes nothing.
- **Read and write**: also manages goals, share links, investor update drafts and suggestions, and the
  dashboard. No key can send investor updates, approve suggestions, delete a startup or touch billing,
  the team, the account or integrations' credentials; those stay with the person.

Treat a key like a password: don't print it back in full or put it in anything you share.

## 2. Connect

- Server: `https://mcp.emrr.uz` (Streamable HTTP; each POST is answered with JSON, there's no server stream)
- Auth: OAuth 2.1 (metadata at `https://mcp.emrr.uz/.well-known/oauth-protected-resource`), or the header
  `Authorization: Bearer <KEY>`
- For apps that only take a URL: `https://mcp.emrr.uz/<KEY>`

Set yourself up the way your app does it:

| App | How |
| --- | --- |
| Claude Code | `claude mcp add --transport http emrr https://mcp.emrr.uz`, then `/mcp` to sign in (or add `--header "Authorization: Bearer <KEY>"`) |
| Cursor | `~/.cursor/mcp.json`: `{"mcpServers": {"emrr": {"url": "https://mcp.emrr.uz", "headers": {"Authorization": "Bearer <KEY>"}}}}` |
| VS Code, GitHub Copilot | `.vscode/mcp.json`: `{"servers": {"emrr": {"type": "http", "url": "https://mcp.emrr.uz", "headers": {"Authorization": "Bearer <KEY>"}}}}` |
| Gemini CLI | `~/.gemini/settings.json`: `{"mcpServers": {"emrr": {"httpUrl": "https://mcp.emrr.uz", "headers": {"Authorization": "Bearer <KEY>"}}}}` |
| Codex | `~/.codex/config.toml`: `[mcp_servers.emrr]` with `url = "https://mcp.emrr.uz/<KEY>"` |
| Claude (app or claude.ai) | The person adds it: Settings → Connectors → emrr in the directory, or Add custom connector with URL `https://mcp.emrr.uz`, then signs in |
| ChatGPT | The person adds it: emrr in the apps directory, or Settings → Apps → Advanced settings → Developer mode → Create, URL `https://mcp.emrr.uz`, OAuth, then signs in |

If you can't change your own settings, tell the person exactly what to paste where.

## 3. Tools (read-only first; two write)

| Tool | What it returns |
| --- | --- |
| `list_startups` | The startups this person can see: id, name, address, role |
| `get_overview` | Key numbers for 7d, 30d, 90d or 12m (MRR, ARR, net new MRR, subscriptions, trials, churn, revenue, refunds, downloads, ad spend…) with the change against the period before |
| `get_metric` | One metric by day, week or month between two dates |
| `list_metrics` | Every metric key, its name, unit and meaning |
| `recent_activity` | The latest sales, renewals, trials, refunds, failed payments and reviews |
| `list_suggestions` | emrr's open suggestions to improve the numbers, with the evidence and their ids |
| `list_goals` | The startup's goals and where each stands (on track, behind, reached, missed) |
| `create_goal` | Writes: sets a goal (metric, target, optional date). Needs write access; only when asked |
| `update_suggestion` | Writes: marks a suggestion done, dismisses, snoozes or reopens it. Needs write access; only when asked |

Every tool but `list_startups` and `list_metrics` takes `startup` (an id, address or name); leave it out
when the person has one startup. Money is in US dollars. `change` is relative: 0.12 means +12%.

## The REST API

The same key works on the REST API the apps use: base `https://emrr.uz/v1`, header
`Authorization: Bearer <KEY>`. The OpenAPI document is https://emrr.uz/v1/openapi.json and the reference
https://emrr.uz/v1/docs. A call the key's access doesn't allow answers 403 and says why.

## Good first questions

- "How is my revenue doing this month?" → `get_overview` with `range: "30d"`
- "What did I sell last night?" → `recent_activity`
- "Why did MRR drop in March?" → `get_metric` for `mrr`, `churned_mrr` and `contraction_mrr` by week
- "What should I fix first?" → `list_suggestions`

Answer in the person's language, with the numbers and the period they cover.

## More

- emrr: https://emrr.uz · pricing: https://emrr.uz/#pricing (free under $1,000 MRR)
- About emrr for language models: https://emrr.uz/llms.txt
- Help: hello@emrr.uz
