setup_project
Register a website domain to track. Accepts a domain or URL; returns the project id. Idempotent — calling it again for the same domain returns the…
Cost: Free (0 credits).
setup_project registers a domain so SeoGrep can crawl, audit, and report on it. It is idempotent — running it again for the same domain (in any URL or host form) returns the existing project instead of creating a duplicate.
What it does
Normalizes the input to a canonical domain — a leading www. label is dropped, so www.example.com and example.com are the same site and never open two projects — then creates the project under your account, or returns the existing one if you already track that site.
A domain that does not resolve is registered anyway
After the project is written, SeoGrep asks DNS whether the name exists. If DNS answers no such name, the reply still confirms the project and adds a warning saying a crawl would have nothing to fetch until the domain is live. It does not refuse: a site registered before launch is a legitimate project, and blocking it would be wrong more often than right.
The warning is raised only on that positive finding. A lookup that times out or whose resolver could not be reached is not a missing domain and says nothing — telling a customer their domain does not exist because of a DNS blip is a worse answer than silence. The check runs after the write and is capped, so a slow resolver can delay the reply and can never delay or prevent the registration.
Example
Ask your MCP client in plain language:
Set up example.com as a project.
Input
| Field | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | The website to track, e.g. "example.com" or "https://example.com". |
Returns
One sentence of plain text — not a structured object — naming the canonical domain and carrying project_id and created inside it, as in (project_id: …, created: false). It comes in one of three wordings, not two: the project was created, it already existed, or it was restored from your archive and is tracked again on its original id. The resolution warning above follows when DNS says the name does not exist.