# 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.

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.

## Start Here

- [Introduction](https://revnu.com/docs/introduction.md): What the Revnu API is for, what it can and cannot do, and where to start.
- [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.
- [Authentication and Scopes](https://revnu.com/docs/authentication.md): How personal tokens work, the five 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.

## 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: every 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 Desktop, Claude Code or Cursor to your Revnu agent with one config snippet.

## 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.
- [List leads](https://revnu.com/docs/leads.md): Leads newest first with status, score and primary contact, paged by an opaque cursor. Never draft bodies.
- [Get a lead](https://revnu.com/docs/lead.md): One lead with its contacts.

## 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.