# RevCent MCP Guide: `GetSites`

Brief MCP-focused guide for RevCent MCP clients and agents using the `GetSites` operation.

---

## Operation Summary

Operation:

```text
GetSites
```

Purpose:

```text
Return a paginated list of RevCent Sites created in the account.
```

Use `GetSites` when the user needs to find or choose a Site before taking a more specific action.

---

## When to Use

Good uses:

- list available RevCent Sites,
- help the user choose the correct Site,
- find a Site ID before calling `GetSite`,
- review high-level Site status across a small result set,
- locate Sites that may need routing, catalog, or deployment attention.

Do not use `GetSites` for broad analytics, long-running exports, or log review.

---

## Input Schema

`GetSites` accepts required query parameters.

```json
{
  "limit": 25,
  "page": 1
}
```

### Required Fields

| Field | Type | Required | Description |
|---|---:|---:|---|
| `limit` | `integer` | Yes | Number of Sites to return. Must be between `1` and `25`. |
| `page` | `integer` | Yes | Page number for pagination. |

### Important Schema Rules

- `limit` cannot exceed `25`.
- Keep pagination bounded.
- Do not loop through all pages unless the user explicitly needs a complete list and the scope is reasonable.

---

## Output Summary

A successful response returns pagination fields and a `results` array of Site objects.

Important Site fields include:

| Field | Meaning |
|---|---|
| `id` | 20-character Site ID. |
| `name` | Site name. |
| `description` | Site description. |
| `campaign` | Campaign associated with Site sale requests. |
| `payment_profile` | Payment Profile used for credit card sales. |
| `paypal_account` | Optional PayPal Account used for PayPal sales. |
| `product_group` | Product Group used as the Site catalog source. |
| `tracking_domain` | Tracking Domain attached to the Site, if any. |
| `github_repo` | Site repository URL for code, design, business-logic customization, and detailed repository documentation. |
| `collaborators` | Collaborator usernames. |
| `deployment` | High-level deployment, branch, routing, and health details. |
| `catalog` | Site catalog generation status and product count. |

Treat returned IDs and status values as authoritative.

---

## Example Request

```json
{
  "limit": 10,
  "page": 1
}
```

---

## Recommended Follow-Up

When the user selects a Site from the list, call:

```text
GetSite
```

Use `GetSite` to retrieve full details for the selected Site before making routing or troubleshooting decisions.

If the user wants to edit supported Site configuration, use `EditSite` after identifying the correct Site. If the user wants to edit Site code, design, page behavior, cart behavior, checkout business logic, offer flow, or custom ecommerce logic, use the Site repository workflow instead of `EditSite`.

After a collaborator clones the Site repository locally, AI should read the repository documentation before making code or business-logic changes. These public MCP markdown files intentionally do not include the full repository-level documentation.

---

## Best Practices

1. Present concise Site choices when multiple Sites are returned.
2. Include Site name, ID, product group, tracking domain, and high-level status when helpful.
3. Ask the user to choose when more than one Site could match the request.
4. Avoid making changes based only on a partial list if the target Site is uncertain.
5. Keep `EditSite` limited to supported configuration changes.
6. Use the Site repository for code and business-logic changes.
7. Read the Site repository documentation after local clone and before repository edits.
8. Require exact Site selection and explicit confirmation before `DeleteSite`.
9. Use `GetSiteEvents` or `GetSiteLogs` for activity and troubleshooting questions.

---

## Final MCP Instruction

Use `GetSites` to find or list RevCent Sites with bounded pagination, then use `GetSite` for exact Site details before taking consequential actions.


---
Document Parent Directory
* [Operations](https://revcent.com/documentation/markdown/mcp/operation/index.md) - AI/MCP details and overviews for operations available within the RevCent MCP.