the whole setup

> Fetch and follow the setup instructions for Revised at https://getrevised.com/docs/agent-setup/prompt.md

Works in any MCP client. The five below are the ones with a written guide.

Your agent fetches [the instructions](/docs/agent-setup/prompt), adds the MCP server, reads your plan and reveal allowance, and learns the handful of things about this directory that are not guessable — that category codes are ours and not English words, that search does not match real domain names, and that only `open`-tier names may be republished. Authentication is OAuth, so there is a step your agent cannot do for you: it will add the server and then wait while you sign in through your browser. No key to paste, and none sitting in a config file. For CI or a container with no browser, create an API key at [getrevised.com/account](https://getrevised.com/account) instead. ## Rather do it by hand Each of these is a real guide, not a variant of the same page — the config file and the login step differ per client. One `claude mcp add`, then the first tool call opens the browser handshake. Add it as a connector in settings, or edit the desktop config JSON. Two lines in `mcp.json`, then **Needs login** in Settings → MCP. `codex mcp add --url`, then `codex mcp login` for the OAuth round trip. The generic shape, and what every client needs to be told. ## What it can do once it is in | | | | --- | --- | | **Search** | The whole directory, filtered on category, TLD, tier, spam band, age, Revised Score and Agent Citability. Free and unlimited inside your rate limit. | | **Read** | Referring domains, archived snapshots, the sites that link in, and when availability was last re-checked — as bands, not invented precision. | | **Reveal** | Turn a masked listing into a real name. The only tool that spends, and `open`-tier names cost nothing. | | **Hold** | Reserve a candidate inside Revised while a person decides, instead of revealing five more. | Nine tools in total. [Tools](/docs/mcp/tools) is the reference; [Find domains with Claude Code](/docs/guides/claude-code) is the workflow. ## What it will not do **It will not spend without asking.** The instructions tell the agent to report your reveal position before anything costs, and to ask before revealing a `regular` or `featured` listing. **It will not republish masked names.** `regular` and `featured` names are disclosed under the [API terms](https://getrevised.com/terms) only. The setup prompt says so, and says it before the agent has any names to be careless with. **It will not tell you a name is available.** `availability_checked_at` is when Revised last looked. Verify at a registrar before you act.