# Changelog

> What changed in the Revnu API, CLI, MCP server and these docs, newest first.

Canonical: https://revnu.com/docs/changelog
Last updated: 2026-10-20

Every change so far is additive: none removed a field or changed what one means.

## 2026-10-20

- **Background research in message status.** [`GET /agent/messages/{requestId}`](https://revnu.com/docs/agent-message-status.md) adds `backgroundTasks` (each research task the message started, with its `state`) and `done`, which is `true` only once the turn has ended and every task's result has been reported. The report joins `replies`. `waitSeconds` on `POST /agent/messages` now waits for `done`. The `agent_message_status` MCP tool takes `waitSeconds` to wait here too.

## 2026-10-18

- **People a run found on an existing company.** A workflow run that adds people to a company's research list without saving them as contacts now lists that company under [`GET /leads?workflowRunId=`](https://revnu.com/docs/leads.md), with those people in `runPeople`. Runs count them in `found.people`.
- **Roles and already-known people in `runPeople`.** Each person carries `role` (`economic` for the buyer, `champion`, `technical`, `user` or `null`). A run that returns people a company already had now lists that company too, with those people marked `alreadyKnown: true`, so the run's list matches what it reported.

## 2026-10-15

- **Docs.** New pages: [Developers](https://revnu.com/docs/developers.md), the start of the developer docs; [API, CLI, MCP or Chat](https://revnu.com/docs/api-cli-mcp-or-chat.md), on which to use when; and [Inbound Webhooks](https://revnu.com/docs/webhooks.md), on sending Revnu events from your own systems. [Authentication](https://revnu.com/docs/authentication.md) lists the smallest scope sets for read-only and status tokens, and [MCP Server Setup](https://revnu.com/docs/mcp.md) covers reconnecting a broken connector and which tools send, publish or spend.
- **Claude Code.** The documented command is now `claude mcp add --transport http --scope user revnu https://revnu.com/api/mcp`, so Revnu is available in every project rather than only the directory it was added in.

## 2026-10-14

- **Sign up from a terminal.** `npx @revnu/cli setup` signs a person up (or in) in the browser and runs the same setup as the `setup_*` tools, so a coding agent can set someone up without restarting to load the MCP server. `--json` gives agents one object with `stage`, `next` and `command`. `revnu login` signs in on its own. See [Install the CLI](https://revnu.com/docs/cli.md).

## 2026-10-10

- **Run a workflow now.** [`POST /workflows/{id}/runs`](https://revnu.com/docs/workflow-run.md) starts a workflow's next run within about a minute and returns its id, without changing the schedule. Runs gain a `queued` status. Also `revnu workflows run <id>` and the `workflow_run` MCP tool.

## 2026-10-06

- **Sign up through your agent.** Connecting the MCP server can now create the account, and the setup routes take it through onboarding: [`GET /setup`](https://revnu.com/docs/setup-status.md), [`POST /setup/website`](https://revnu.com/docs/setup-website.md), [`POST /setup/confirm`](https://revnu.com/docs/setup-confirm.md), [`POST /setup/checkout`](https://revnu.com/docs/setup-checkout.md) and [`POST /setup/finish`](https://revnu.com/docs/setup-finish.md), plus the matching `setup_*` MCP tools. Until the first subscription, other routes answer `402` with `error: "setup_pending"`. `GET /me` reports `inSetup`. The recipe agents follow is at [revnu.com/setup.md](https://revnu.com/setup.md).

## 2026-10-02

- **Workflow runs.** Each run reports `found: { leads, contacts }`, every lead and contact carries the `workflowRunId` that found it, and [`GET /leads?workflowRunId=`](https://revnu.com/docs/leads.md) lists one run's leads with `runContactIds`. Also `revnu leads list --workflow-run <id>`.

## 2026-10-01

- **LinkedIn.** [`GET /linkedin/person`](https://revnu.com/docs/linkedin-person.md) reads one person's LinkedIn relationship with each connected account: connected or not, any pending invite and when it was sent, and the conversation. Read-only. Also `revnu linkedin person` and the `linkedin_person` MCP tool.

## 2026-09-29

- **OpenAPI.** [`/openapi.json`](https://revnu.com/openapi.json) describes every route with its scope, parameters and error statuses.
- **Docs.** New pages: [How Revnu Works](https://revnu.com/docs/concepts.md), [Errors](https://revnu.com/docs/errors.md) and this changelog. Every page now shows when it was last updated.

## 2026-09-28

- **Agent messages.** `queue: true` on [`POST /agent/messages`](https://revnu.com/docs/agent-messages.md) hands the agent another job without stopping the one it is running.
- **Block list.** [`POST /blocklist`](https://revnu.com/docs/blocklist-add.md) accepts LinkedIn profile links as well as domains and email addresses.

## 2026-09-25

- **Remote MCP server.** Connect Claude, ChatGPT or Cursor to `https://revnu.com/api/mcp` with OAuth, no install. On hosts that support MCP Apps, the review queue opens as cards with buttons. See [MCP Server Setup](https://revnu.com/docs/mcp.md).
- **CLI.** `revnu` and its local MCP server cover every public API route.

## 2026-09-24

- **Measurement.** Docs for the [Revnu Tag](https://revnu.com/docs/revnu-tag.md) and the server-side [Event API](https://revnu.com/docs/event-api.md).
- **Content API.** Canonical URLs follow your site's trailing-slash convention.

## 2026-09-22

- **Leads.** [`GET /leads/{id}`](https://revnu.com/docs/lead.md) returns your columns, the surfaced draft and the research behind each value. [`PATCH /leads/{id}`](https://revnu.com/docs/lead-update.md) sets vertical, archetype and tags.
- **Block list.** [Read](https://revnu.com/docs/blocklist.md), [add](https://revnu.com/docs/blocklist-add.md) and [remove](https://revnu.com/docs/blocklist-remove.md) do-not-contact entries.
- **Workflows.** [Create](https://revnu.com/docs/workflow-create.md), [update](https://revnu.com/docs/workflow-update.md), [pause](https://revnu.com/docs/workflow-pause.md), [resume](https://revnu.com/docs/workflow-resume.md) and [delete](https://revnu.com/docs/workflow-delete.md) recurring workflows.

## 2026-09-20

- **Docs.** revnu.com/docs launched: every page as markdown, an [llms.txt](https://revnu.com/docs/llms.txt) index and search.

## 2026-09-19

- **Public API.** Personal tokens with scopes; the review queue, agent messages, results, workflows and leads over `https://revnu.com/api/v1`. [`GET /me`](https://revnu.com/docs/me.md) verifies a token, and `waitSeconds` holds a message request open for the reply.
- **CLI.** The `@revnu/cli` package with a local MCP server.

## Frequently asked questions

### Is the API versioned?

Yes, by path: everything lives under `/api/v1`. New fields and routes arrive without a version change, so ignore fields you do not recognise.

### How do I hear about changes?

This page and [`/openapi.json`](https://revnu.com/openapi.json) change together. The docs index at [`/docs/llms.txt`](https://revnu.com/docs/llms.txt) and the sitemap carry each page's last-updated date.
