# Revnu Docs

> The Revnu API, CLI and MCP server: read your review queue, approve or decline cards, message your growth agent and pull results from your own software.

Revnu (revnu.com) runs GTM on autopilot for software businesses: pipeline, ads and GEO, without a growth team. These docs cover its developer surface. Last updated 2026-10-14.

Every page below is available as markdown at the linked `.md` URL, or by requesting the HTML URL with `Accept: text/markdown`. The introduction lives at /docs itself; its markdown twin is /docs/introduction.md.

- OpenAPI 3.1 description of every route: https://revnu.com/openapi.json
- Remote MCP server: https://revnu.com/api/mcp (OAuth; setup at https://revnu.com/docs/mcp.md)
- Every page in one file: https://revnu.com/llms-full.txt

## Start Here

- [Introduction](https://revnu.com/docs/introduction.md): The Revnu API, CLI and MCP server let your software read and approve your growth agent's review queue, message it and pull results. Start here.
- [Quickstart](https://revnu.com/docs/quickstart.md): From a fresh token to approving a card and getting a reply from your agent, using nothing but curl.
- [How Revnu Works](https://revnu.com/docs/concepts.md): The model behind the API: a growth agent that does the work, review cards for your say-so, and a trust ladder that lets work ship.
- [Authentication and Scopes](https://revnu.com/docs/authentication.md): How personal tokens work, the seven scopes, and which scope each route needs.
- [Rate Limits](https://revnu.com/docs/rate-limits.md): Per-token and per-account limits, the burst allowance, and what to do on a 429.
- [Errors](https://revnu.com/docs/errors.md): Every error the Revnu API returns, the JSON body each one carries, and whether to retry, fix the request or re-read the card.
- [Changelog](https://revnu.com/docs/changelog.md): What changed in the Revnu API, CLI, MCP server and these docs, newest first.

## Guides

- [Build a Review Screen](https://revnu.com/docs/build-a-review-screen.md): Put your review queue on a wall, in Slack or in your admin, driven entirely by each card's actions.
- [Talk to Your Agent](https://revnu.com/docs/talk-to-your-agent.md): Send messages, wait for the reply inline or poll, and keep retries safe with a client request id.
- [Pull Results Into Reporting](https://revnu.com/docs/pull-results-into-reporting.md): Read the same scoreboard the agent reads, plus workflows and run history, into your own dashboards.

## CLI & MCP

- [Install the CLI](https://revnu.com/docs/cli.md): The revnu command: sign up and set up from a terminal, every API route as a subcommand, JSON on stdout, and a login that keeps the token out of your shell history.
- [MCP Server Setup](https://revnu.com/docs/mcp.md): Connect Claude, ChatGPT, Cursor or any MCP host to your Revnu agent, as a remote connector or a local server.

## API Reference

- [Get the current token](https://revnu.com/docs/me.md): Who this token is: label, scopes, the account it belongs to, and the rate limits it is held to. Needs no scope.
- [List the review queue](https://revnu.com/docs/review-list.md): What is waiting for the customer's approval, each card carrying the exact verbs the API accepts for it.
- [Get one card](https://revnu.com/docs/review-get.md): One review card by id, any status, including its full payload.
- [Answer a card](https://revnu.com/docs/review-answer.md): Resolve a card the way the dashboard's primary button would: approve, answer a question, or choose an option.
- [Send a Gmail card](https://revnu.com/docs/review-send.md): Approve and send a Gmail reply or draft, optionally with an edited body. This sends real email.
- [Request changes](https://revnu.com/docs/review-request-changes.md): Send a card back to the agent with feedback. A revised version returns to the queue.
- [Snooze a card](https://revnu.com/docs/review-snooze.md): Hide a card until a time. Cancels any auto-ship deadline on it.
- [Dismiss a card](https://revnu.com/docs/review-dismiss.md): Decline a card. It closes without shipping, the agent's trust for that kind of work resets, and the reason teaches it.
- [Send a message](https://revnu.com/docs/agent-messages.md): Message your agent exactly as the dashboard chat does, and optionally hold the request open for the reply.
- [Poll a message](https://revnu.com/docs/agent-message-status.md): One message's status and every reply the agent has sent since it landed.
- [Read the thread](https://revnu.com/docs/agent-thread.md): This token's conversation with the agent, newest first.
- [Get agent status](https://revnu.com/docs/agent-status.md): Whether the agent is up and busy: sandbox state, last activity, and the next scheduled wake.
- [Get results](https://revnu.com/docs/results.md): The growth scoreboard for a window ending now: per-channel sections that are either available with data or unavailable with a reason.
- [List workflows](https://revnu.com/docs/workflows.md): The account's recurring workflows with their schedule, next run and step list.
- [List workflow runs](https://revnu.com/docs/workflow-runs.md): Run history for one workflow, newest first, with per-step outcomes.
- [Run a workflow now](https://revnu.com/docs/workflow-run.md): Start a workflow's next run within about a minute, without changing its schedule.
- [Create a workflow](https://revnu.com/docs/workflow-create.md): Compose a recurring workflow from a schedule in plain words and a list of steps.
- [Update a workflow](https://revnu.com/docs/workflow-update.md): Change a workflow's name, schedule, steps, destination or status. Steps are replaced whole.
- [Pause a workflow](https://revnu.com/docs/workflow-pause.md): Stop a workflow firing without losing its steps or history.
- [Resume a workflow](https://revnu.com/docs/workflow-resume.md): Set a paused workflow live again; the next run is scheduled from its cadence.
- [Delete a workflow](https://revnu.com/docs/workflow-delete.md): Remove a workflow. Nothing fires again, and it drops out of every read.
- [List leads](https://revnu.com/docs/leads.md): Leads newest first with status, score, primary contact and your own columns, paged by an opaque cursor. Draft bodies are only on GET /leads/{id}.
- [Get a lead](https://revnu.com/docs/lead.md): One lead with its contacts, the surfaced draft, and the research behind each column.
- [Update a lead's labels](https://revnu.com/docs/lead-update.md): Set vertical, archetype and tags on a lead. The one write on a lead.
- [List the block list](https://revnu.com/docs/blocklist.md): The do-not-contact entries the send and research gates enforce, newest first.
- [Add block list entries](https://revnu.com/docs/blocklist-add.md): Block companies, mailboxes or LinkedIn profiles from outreach. Idempotent, up to 500 per call.
- [Remove a block list entry](https://revnu.com/docs/blocklist-remove.md): Unblock one company or mailbox by the id the list returns.
- [Look up a LinkedIn person](https://revnu.com/docs/linkedin-person.md): One person's LinkedIn relationship with each connected account, read live from LinkedIn: connected or not, any pending invite and when it was sent, and the conversation.
- [Get setup status](https://revnu.com/docs/setup-status.md): Where a new account is in setup (website, researching, review, payment, start or done) and the exact next step. Works before the account has paid.
- [Set the business website](https://revnu.com/docs/setup-website.md): Give a new account its website. Revnu checks the site exists, then researches the business, which takes about a minute.
- [Confirm the business details](https://revnu.com/docs/setup-confirm.md): Save the customer's answers to the setup review. Becomes Revnu's memory of the business, exactly as the dashboard review does.
- [Get a checkout link](https://revnu.com/docs/setup-checkout.md): A Stripe Checkout link that starts the customer's subscription, with a free trial when their account has one. The customer finishes it on Stripe's page, where any card is entered.
- [Start Revnu](https://revnu.com/docs/setup-finish.md): Once the trial is running, start Revnu's first work now rather than waiting for the automatic start 15 minutes after the trial begins.

## Content API

- [Host Your Blog Anywhere](https://revnu.com/docs/content-api.md): The Content API serves the posts Revnu writes and publishes as JSON, so your own site renders them on your own domain and framework.
- [List posts](https://revnu.com/docs/content-posts.md): Every published post, newest first, with cursor paging and filters by content type and time.
- [Get a post](https://revnu.com/docs/content-post.md): One post, render-ready: markdown and safe HTML, table of contents, head metadata, JSON-LD and related posts.
- [Render Posts in Next.js or Astro](https://revnu.com/docs/host-your-blog.md): Complete examples for rendering Revnu posts on your own site with Next.js App Router or Astro, plus how updates reach a build-time site.

## Measurement

- [Set Up Outcomes](https://revnu.com/docs/set-up-outcomes.md): Choose what counts as a result on your site, connect it, and check it works. Covers purchases, trial starts and booked calls, including the booking webhook for Cal.com and Calendly.
- [Install the Revnu Tag](https://revnu.com/docs/revnu-tag.md): One script tag that tells Revnu where your visitors come from, including ChatGPT, Perplexity and other AI assistants, search engines and ads.
- [Send Events](https://revnu.com/docs/event-api.md): Tell Revnu from your server when a visitor signs up, books a call or pays, so the result is tied back to where they came from.