# Sign Up for Revnu From an AI Agent

> Tell Claude, ChatGPT, Codex or another assistant "Set me up with revnu.com" and it creates your Revnu account, researches your business and starts a three-day free trial with no card. You sign in yourself, and add a card in the dashboard to keep Revnu after the trial.

Canonical: https://revnu.com/docs/agent-signup
Last updated: 2026-11-07

You can create and set up a Revnu account without opening the dashboard. Connect Revnu to the assistant you already use, then ask it:

> Set me up with revnu.com

The assistant walks you through setup with Revnu's `setup_*` tools. It does the typing; you make the decisions. Signing in, confirming what Revnu learned about your business, and paying are always yours.

### 1. Connect Revnu to your assistant

Add the MCP server at `https://revnu.com/api/mcp`. The commands for each app are below. The first time it connects, a browser opens where you sign in or create your Revnu login and pick what the assistant may do.

### 2. Give it your website

The assistant asks for your website and passes it to Revnu. Revnu checks the site exists, then researches the business, which takes about a minute.

### 3. Review what Revnu found

The assistant shows you what Revnu learned, row by row, each with its source: what you sell, who you sell to, what to never say. Correct anything wrong. What you confirm becomes Revnu's [Memory](https://revnu.com/docs/memory.md) of the business. A good assistant never confirms these for you.

### 4. Start the trial

A sign-up through an assistant gets a three-day free trial with no card, and it starts straight away with nothing to open. Add a card in the dashboard before the three days end to keep Revnu working. You type the card details on Stripe's own page; the assistant never sees them.

### 5. Start Revnu

Once the trial is running, the assistant can start Revnu's first work straight away. If it doesn't, Revnu starts on its own 15 minutes after the trial begins. Its first drafts land in your [review queue](https://revnu.com/docs/review-list.md).

## Connect it in your app

### Claude Code

```bash
claude mcp add --transport http --scope user revnu https://revnu.com/api/mcp
```

Then run `/mcp` inside Claude Code, pick **revnu** and choose **Authenticate**. Leave **Agent: Message** ticked.

### Codex

```bash
codex mcp add revnu --url https://revnu.com/api/mcp
codex mcp login revnu
```

### Gemini CLI

```bash
gemini mcp add --transport http --scope user revnu https://revnu.com/api/mcp
```

Then run `/mcp auth revnu` inside Gemini CLI.

### ChatGPT

Open **Settings → Apps & Connectors → Advanced** and turn on Developer mode. Create a connector named Revnu with the URL `https://revnu.com/api/mcp` and OAuth as the authentication.

### Claude, Cursor and VS Code

Use the install link for your app on [revnu.com/agents](https://revnu.com/agents). It works in Claude on the web, desktop and mobile.

To connect Claude Code, Codex and Gemini CLI in one go:

```bash
curl -fsSL https://revnu.com/install | sh
```

It only connects the apps and adds the Revnu skill. Nothing is created or paid for until you sign in. Every option, with troubleshooting, is in [MCP Setup and Troubleshooting](https://revnu.com/docs/mcp.md).

**From a terminal instead**

The CLI runs the same setup without an assistant in the middle:

```bash
npx @revnu/cli setup --json --website acme.com
```

See [Install the CLI](https://revnu.com/docs/cli.md).

**Look before you make an account**

An assistant can research a website and show you the plan Revnu would follow before any account exists. It gets a claim link to hand you. See [Preview a Plan Without an Account](https://revnu.com/docs/preview.md).

## For people building an assistant

The full recipe an assistant follows is at [revnu.com/setup.md](https://revnu.com/setup.md). It drives setup from [Setup Status](https://revnu.com/docs/setup-status.md), which always names the stage (`website`, `researching`, `review`, `payment`, `start` or `done`) and the exact next step.

Three rules keep it safe:

- **One login holds one business.** Check `account.website` before you start, so you don't set up a second business inside someone's existing account.
- **The person confirms the review.** Show every row and its source, and save only what they agreed to.
- **Never handle card details.** When `setup_checkout` returns a link instead of starting the trial, hand it over and let the person pay on Stripe's page.

## Frequently asked questions

### Can an assistant sign me up without me?

The assistant handles every step except three that stay yours: you sign in to Revnu, you confirm what it learned about your business, and you add a card yourself, in the dashboard or on Stripe's page, when one is needed.

### Does the assistant see my card details?

No. A sign-up through an assistant starts with no card at all; when a card is needed you enter it on Stripe's page or in the dashboard, never with the assistant. It only learns whether the trial or plan started.

### Why does every tool say setup_pending?

Until your trial or plan starts, only the `setup_*` tools work. Once `setup_status` reaches `start` (a few seconds after the trial starts), the rest, `ask_revnu` included, work.

### Which assistants can do this?

Any that connects to MCP servers with OAuth: Claude, Claude Code, ChatGPT, Codex, Gemini CLI, Cursor and VS Code, among others.

### What if I already have a Revnu account?

Connecting while signed in connects that account, and the assistant can use it straight away. It will not create a second one for you.
