# Reputably

> Connect an AI assistant to your Reputably data over MCP, or call the HTTP API directly.

- [Reputably for developers and agents](https://docs.reputably.net/index.md): Read your reviews, mentions, leads and AI visibility from an assistant or from your own code.
- [Quickstart](https://docs.reputably.net/guides/quickstart.md): From nothing to answering questions about your reviews, in about two minutes.
- [Authentication](https://docs.reputably.net/guides/authentication.md): Sign in with OAuth, or create an agent key. Both land on the same permissions.
- [Workspaces](https://docs.reputably.net/guides/workspaces.md): Every read is scoped to one workspace. This is the setting that makes results look empty.
- [What agents cannot do](https://docs.reputably.net/guides/limits.md): The permission ceiling, and why it is drawn where it is.
- [Connect your assistant](https://docs.reputably.net/mcp/connect.md): Configuration for Claude Code, Claude Desktop, Codex, Cursor and other MCP clients.
- [MCP tool reference](https://docs.reputably.net/mcp/tool-reference.md): Every tool the Reputably MCP server exposes, with its parameters.
- [API overview](https://docs.reputably.net/api-reference/introduction.md): Base URL, authentication, shapes and error codes.
- [List AI traffic daily rollups](https://docs.reputably.net/api-reference/ai-traffic/list-ai-traffic-daily-rollups.md): Reads AI traffic daily rollups in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI traffic daily rollup](https://docs.reputably.net/api-reference/ai-traffic/get-one-ai-traffic-daily-rollup.md): Reads a single AI traffic daily rollup by id. Ids do not cross workspaces.
- [List AI traffic sites](https://docs.reputably.net/api-reference/ai-traffic/list-ai-traffic-sites.md): Reads AI traffic sites in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI traffic site](https://docs.reputably.net/api-reference/ai-traffic/get-one-ai-traffic-site.md): Reads a single AI traffic site by id. Ids do not cross workspaces.
- [List brand trackers](https://docs.reputably.net/api-reference/brand-tracking/list-brand-trackers.md): Reads brand trackers in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one brand tracker](https://docs.reputably.net/api-reference/brand-tracking/get-one-brand-tracker.md): Reads a single brand tracker by id. Ids do not cross workspaces.
- [Competitor share of voice](https://docs.reputably.net/api-reference/brand-tracking/competitor-share-of-voice.md): Mention volume and sentiment per competitor for one brand tracker.
- [List businesses](https://docs.reputably.net/api-reference/businesses/list-businesses.md): Reads businesses in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one business](https://docs.reputably.net/api-reference/businesses/get-one-business.md): Reads a single business by id. Ids do not cross workspaces.
- [Generate AI insights for a business](https://docs.reputably.net/api-reference/businesses/generate-ai-insights-for-a-business.md): Drafts an insight summary. Computes only, and publishes nothing.
- [Get plan usage for one business](https://docs.reputably.net/api-reference/businesses/get-plan-usage-for-one-business.md): Tracker, prompt and sync usage for a single business against its plan limits.
- [List leads](https://docs.reputably.net/api-reference/leads/list-leads.md): Reads leads in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one lead](https://docs.reputably.net/api-reference/leads/get-one-lead.md): Reads a single lead by id. Ids do not cross workspaces.
- [List leads with their source mention](https://docs.reputably.net/api-reference/leads/list-leads-with-their-source-mention.md): Leads joined to the mention that produced them, which carries the public post URL.
- [Mark leads triaged](https://docs.reputably.net/api-reference/leads/mark-leads-triaged.md): Marks specific leads seen. Idempotent, first-seen wins, and unknown ids are skipped rather than erroring.
- [List brand mentions](https://docs.reputably.net/api-reference/brand-mentions/list-brand-mentions.md): Reads brand mentions in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one brand mention](https://docs.reputably.net/api-reference/brand-mentions/get-one-brand-mention.md): Reads a single brand mention by id. Ids do not cross workspaces.
- [Draft a reply to a mention](https://docs.reputably.net/api-reference/brand-mentions/draft-a-reply-to-a-mention.md): Generates reply text and saves it as the suggested reply. It does not post to the platform.
- [Headline mention counts](https://docs.reputably.net/api-reference/brand-mentions/headline-mention-counts.md): Aggregated counts per window. Use this instead of paging mention rows to count them.
- [Search the mention feed](https://docs.reputably.net/api-reference/brand-mentions/search-the-mention-feed.md): The unified mention feed across X, Reddit, YouTube, Facebook communities and the open web.
- [List posts](https://docs.reputably.net/api-reference/posts/list-posts.md): Reads posts in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one post](https://docs.reputably.net/api-reference/posts/get-one-post.md): Reads a single post by id. Ids do not cross workspaces.
- [Draft a Google Business Profile post](https://docs.reputably.net/api-reference/posts/draft-a-google-business-profile-post.md): Creates a draft post. It does not publish.
- [List Google Business Profile posts](https://docs.reputably.net/api-reference/posts/list-google-business-profile-posts.md): Posts and drafts for a business.
- [List reports](https://docs.reputably.net/api-reference/reports/list-reports.md): Reads reports in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one report](https://docs.reputably.net/api-reference/reports/get-one-report.md): Reads a single report by id. Ids do not cross workspaces.
- [Download a rendered report as CSV](https://docs.reputably.net/api-reference/reports/download-a-rendered-report-as-csv.md): Returns the CSV body for a report that has finished rendering.
- [Queue a report render](https://docs.reputably.net/api-reference/reports/queue-a-report-render.md): Asynchronous. Returns immediately, then poll the Report entity for completion. It never emails the report.
- [List reviews](https://docs.reputably.net/api-reference/reviews/list-reviews.md): Reads reviews in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one review](https://docs.reputably.net/api-reference/reviews/get-one-review.md): Reads a single review by id. Ids do not cross workspaces.
- [List AI Visibility daily rollups](https://docs.reputably.net/api-reference/ai-visibility/list-ai-visibility-daily-rollups.md): Reads AI Visibility daily rollups in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI Visibility daily rollup](https://docs.reputably.net/api-reference/ai-visibility/get-one-ai-visibility-daily-rollup.md): Reads a single AI Visibility daily rollup by id. Ids do not cross workspaces.
- [List AI Visibility prompts](https://docs.reputably.net/api-reference/ai-visibility/list-ai-visibility-prompts.md): Reads AI Visibility prompts in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI Visibility prompt](https://docs.reputably.net/api-reference/ai-visibility/get-one-ai-visibility-prompt.md): Reads a single AI Visibility prompt by id. Ids do not cross workspaces.
- [List AI Visibility runs](https://docs.reputably.net/api-reference/ai-visibility/list-ai-visibility-runs.md): Reads AI Visibility runs in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI Visibility run](https://docs.reputably.net/api-reference/ai-visibility/get-one-ai-visibility-run.md): Reads a single AI Visibility run by id. Ids do not cross workspaces.
- [List AI Visibility trackers](https://docs.reputably.net/api-reference/ai-visibility/list-ai-visibility-trackers.md): Reads AI Visibility trackers in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one AI Visibility tracker](https://docs.reputably.net/api-reference/ai-visibility/get-one-ai-visibility-tracker.md): Reads a single AI Visibility tracker by id. Ids do not cross workspaces.
- [Per-prompt AI Visibility performance](https://docs.reputably.net/api-reference/ai-visibility/per-prompt-ai-visibility-performance.md): Mention and citation rates per prompt, aggregated server-side.
- [AI Visibility fan-out and retrieval stats](https://docs.reputably.net/api-reference/ai-visibility/ai-visibility-fan-out-and-retrieval-stats.md): What the engines searched for behind each prompt, where a trail is disclosed.
- [Countries available for AI Visibility](https://docs.reputably.net/api-reference/ai-visibility/countries-available-for-ai-visibility.md): The countries AI Visibility runs can be pinned to.
- [Sources cited in AI answers](https://docs.reputably.net/api-reference/ai-visibility/sources-cited-in-ai-answers.md): The domains and pages the engines cited, classified by source type.
- [List prompts for a tracker](https://docs.reputably.net/api-reference/ai-visibility/list-prompts-for-a-tracker.md): The prompts an AI Visibility tracker asks each engine.
- [Suggest AI Visibility prompts](https://docs.reputably.net/api-reference/ai-visibility/suggest-ai-visibility-prompts.md): Proposes prompts for a business. Suggests only, and saves nothing.
- [List workspaces](https://docs.reputably.net/api-reference/account/list-workspaces.md): Reads workspaces in the selected workspace. Filter with `q`, a JSON object of field matches. Reads only: writes through this route are refused for every entity and every credential.
- [Get one workspace](https://docs.reputably.net/api-reference/account/get-one-workspace.md): Reads a single workspace by id. Ids do not cross workspaces.
- [Show syncs in progress](https://docs.reputably.net/api-reference/account/show-syncs-in-progress.md): Which platform syncs and AI Visibility runs are currently running.
- [List in-app notifications](https://docs.reputably.net/api-reference/account/list-in-app-notifications.md): The signed-in account’s notification bell items.
- [List workspaces across every agency](https://docs.reputably.net/api-reference/account/list-workspaces-across-every-agency.md): Platform-scoped credentials only. Refuses itself for an ordinary key.
- [List prospect audits](https://docs.reputably.net/api-reference/account/list-prospect-audits.md): Audits already generated, plus the agency’s remaining monthly quota. Generating a new audit is not exposed to agent credentials.
- [Persist a tracking setup](https://docs.reputably.net/api-reference/setup/persist-a-tracking-setup.md): Creates the proposed trackers and prompts. Fills empty capacity only and never overwrites existing rows. Caps are enforced server-side.
- [Propose a starter tracking setup](https://docs.reputably.net/api-reference/setup/propose-a-starter-tracking-setup.md): Suggests the starter bundle of trackers and prompts. Proposes only, and persists nothing.

## OpenAPI Specs

- [openapi](/openapi.json)