Connect your AI (MCP)
Use your FirstMRR space from Claude, ChatGPT, Codex, Cursor or VS Code: the MCP server, the steps for each tool, the tools, the limits and troubleshooting.
What it is
FirstMRR has a remote MCP (Model Context Protocol) server. Once connected, your AI tool reads the same context as the coach Leo (your project, your roadmap, your numbers, the library) and can create or tick your tasks, for your account only. Your tool's model does the thinking: nothing is taken from your credits.
https://firstmrr.app/mcpFor agents: connect to https://firstmrr.app/mcp (Streamable HTTP, OAuth). The tools are listed below.
Who can use it
- Members enrolled as testers of the feature: it is still being tested, and may change or stop without affecting the rest of your subscription.
- With an active subscription. When the subscription ends, access ends too, at the next request.
- From 18 years old, per the age given at sign-up.
- The space's owner only: neither team guests nor creators.
Connect, tool by tool
Claude (claude.ai and Claude Desktop)
- Open Customize → Connectors (claude.ai/customize/connectors).
- Add custom connector, paste
https://firstmrr.app/mcp. - Leave authentication on "Sign in now" and the OAuth client on Claude's published identity, then Add and Connect.
- Sign in to FirstMRR in the window that opens and approve.
Claude Code
claude mcp add --transport http --scope user firstmrr https://firstmrr.app/mcpChatGPT
- Open chatgpt.com/plugins, +, then Add custom MCP server.
- Give it a name (FirstMRR), paste the URL
https://firstmrr.app/mcp, choose OAuth authentication and accept the warning. - Create it, then in a new chat type @ and pick FirstMRR.
Codex
codex mcp add firstmrr --url https://firstmrr.app/mcp
codex mcp login firstmrrCursor: install in Cursor, or add the server to ~/.cursor/mcp.json.
{
"mcpServers": {
"firstmrr": {
"url": "https://firstmrr.app/mcp"
}
}
}VS Code (GitHub Copilot): install in VS Code, or Command Palette → MCP: Add Server → HTTP, or:
{
"servers": {
"firstmrr": {
"type": "http",
"url": "https://firstmrr.app/mcp"
}
}
}Devin (formerly Windsurf) and tools without remote servers
devin mcp add -s user firstmrr https://firstmrr.app/mcp
devin mcp login firstmrrMCP Inspector (for a developer who wants to see the exchanges)
npx @modelcontextprotocol/inspector@2.12.0
# Streamable HTTP → https://firstmrr.app/mcp → ConnectThe tools
Your AI only sees the tools of the categories you shared on the consent screen, and those of your plan (Distribution alone has no guides and no playbook).
| Tool | Access | Description |
|---|---|---|
get_overview | read | Project overview. The member's context, as the coach Leo reads it: first name, product, roadmap step and what checks it, week goal, onboarding answers, starting analysis, project sheet, setup guide, and what is connected (site, app, revenue, Distribution). Call it first in a conversation. Category : Your project. |
list_tasks | read | List tasks. The tasks of their roadmap (title, detail, due date, status, who added it), paginated. The ids are used by update_task and complete_task. Category : Your tasks. |
list_notes | read | List coach notes. What the coach remembers about their project: decisions, preferences, constraints and context, newest first, paginated. Category : The coach's notes. |
get_site_stats | read | Site or app stats. The totals FirstMRR measured on their site or app, from day "from" to day "to" inclusive (400 days at most): visits, page views, signups, activations, trials, payments, cancellations, declared revenue, per day, pages and sources. Never a row per visitor. Category : Your site and app. |
get_revenue | read | Revenue. Their revenue read from their connected payment tool (Stripe, Whop, RevenueCat, Polar, Paddle, Superwall), from day "from" to day "to" inclusive: collected (by day, week or month), MRR and paying subscribers at start and end, departures, churn, plans. Totals only, never a row per customer. Category : Your revenue. |
get_videos | read | TikTok and Instagram videos. Their Distribution numbers, TikTok and Instagram only, from day "from" to day "to" inclusive: views gained per platform, account, format and video, best videos, FirstMRR sales estimates with their range, revenue per 1,000 views, experiment calendar, impact analyses. video_query finds a video by words of its caption or its link. Category : Your TikTok and Instagram videos. |
find_formats | read | Find viral formats. Searches FirstMRR's library of proven video formats for apps and software for those that fit their niche and constraints, with each format's expert sheet and at most 5 examples (link and our two analyses). 50 examples a day at most. Category : The FirstMRR library. |
list_guides | read | List guides. The method guides of the FirstMRR library: slug, title, level and promise. Category : The FirstMRR library. |
read_guide | read | Read a guide. The text of a FirstMRR library guide, in parts (part). Read it before giving a method on a topic it covers. For the member's personal use, capped per day. Category : The FirstMRR library. |
read_app_playbook | read | Read the app playbook. One sheet of FirstMRR's know-how for building an app that sells: idee (idea), ecran-viral (viral screen), onboarding, paiement (payment), mvp, videos, chiffres (numbers), references. Category : The FirstMRR library. |
search_help | read | Search help. Searches the FirstMRR help center (how the product works, where each page is) and returns the matching articles with their slug. |
read_help | read | Read a help article. The text of a FirstMRR help center article. Read it before answering a question about how FirstMRR works. "ou-trouver-quoi" is the product map. |
create_task | write | Create a task. Adds a dated task to their roadmap when they commit to an action (due today up to 60 days ahead). client_request_id makes the call safe to retry: the same id never creates two tasks. The task is marked as added by this AI service. Category : Your tasks. |
update_task | write | Update a task. Fixes the title, detail or due date of a task of their roadmap. It replaces the existing text: ask them first. Category : Your tasks. |
complete_task | write | Complete a task. Marks a task of their roadmap as done, when they say they did it. Category : Your tasks. |
save_note | write | Save a note. Saves a lasting fact about their project in the coach's memory: a decision, a preference, a constraint or some context, in one sentence. An identical note is never saved twice. Category : The coach's notes. |
Read, write and categories
read: read your data in the shared categories.write: create, change or tick a task, save a note. Never a deletion. Every item written is labelled with the AI tool's name.- Categories: Your project, Your tasks, The coach's notes, Your site and app, Your revenue, Your TikTok and Instagram videos, The FirstMRR library. FirstMRR's help is always readable.
Without write, a write tool answers 403 with insufficient_scope: your AI tool then offers to reconnect with write kept ticked.
What is never shared
- Your YouTube and Google Search Console data: it stays visible in FirstMRR only.
- Your conversations with the coach, your screenshots and your images.
- Your e-mail, your Apple, Google or Whop ids, your payments, your age, how you found us.
- The text and authors of Instagram comments (only their count), post images, raw TikTok ids and covers.
- Rows per customer or per visitor: totals only.
- Your team's and your creators' data, and anyone else's.
- Your payment tools' keys, our internal settings and our costs.
Your videos' captions, your visitors' pages and sources arrive in untrusted_* fields: your AI treats them as data, never as instructions.
Disconnect
In Settings → Connected AI, Disconnect cuts access at once: the tool's next request answers 401. What the tool already received stays with it, under its own terms.
On the tool's side: claude mcp logout firstmrr, disconnecting the connector in Claude, ChatGPT or Cursor, or rm -rf ~/.mcp-auth for mcp-remote.
Limits
- 300 requests per 15-minute window, all AI tools together, including 20 writes. Beyond that, the tool answers
rate_limitedwithretry_after_seconds. - Library: 5 video examples per call and 50 per day. Guides: 40 parts read per day. Counters reset at midnight UTC.
- Every answer stays under 20,000 characters; lists come in pages of 50 at most with
next_cursor. - Every call is logged (tool, outcome, duration, never the content) and kept 6 months.
Troubleshooting
- "Couldn't reach the MCP server": check the URL (
https://firstmrr.app/mcp, nowww, no trailing/) and your network (VPN or company network). - The consent page refuses access: the feature is for testers aged 18 and over who own their space, with an active subscription.
- The browser opened but the tool never connects: in Claude Code, paste the callback URL into the session; in Cursor, close the other windows (port 8787 is shared); in the Inspector,
localhostand127.0.0.1are two different addresses. - Sign-in loop or "Authorization failed": clear the authentication in the tool (
/mcp→ Clear authentication,claude mcp logout, Cursor logout,rm -rf ~/.mcp-auth) and connect again. - Connected to the wrong FirstMRR account: sign out on firstmrr.app, then reconnect the tool.
- "Needs additional permissions" when creating a task: reconnect with write kept ticked.
- Disconnected after weeks without use, or after Settings → Connected AI****: connect again.
- Tools missing or outdated: ChatGPT → Refresh; Claude → reconnect; VS Code → MCP: List Servers → Restart; Claude Code →
/mcp→ Reconnect. - `rate_limited` or `quota_exceeded`: wait for the delay given by
retry_after_seconds.
Example prompts
- "Look at where I am on FirstMRR and tell me what to do this week."
- "How many visits and signups on my site since Monday?"
- "Find me a no-face video format for my revision app, and create the task of filming the first video on Thursday."