Quickstart

From nothing to answering questions about your reviews, in about two minutes.

Connect an assistant

The fastest path needs no key at all.

1. Add the server

   claude mcp add --transport http reputably https://app.reputably.net/api/mcp
   

   On a white-label domain, use your own domain instead.

2. Sign in

   Run /mcp inside Claude Code and choose Authenticate. A browser opens, you approve once, and the connection persists.

3. Ask something

   Which of my locations have reviews still waiting on a reply?

   Show me leads from the last 7 days, strongest buying signal first.

   Do AI assistants mention us when someone asks for a physio in Newcastle?

If the first answer looks empty, you are probably reading the wrong workspace. See Workspaces.

Other clients, including Claude Desktop, Codex and Cursor, are on Connect your assistant.

Call the API

1. Create a key

   Sign in, open Settings → API & MCP and create an agent key. Copy it now; it is shown once.

2. Make a request

   Every operation is a POST with a JSON body.

   curl https://app.reputably.net/api/functions/listLeadsWithMentions \
     -H "Authorization: Bearer rpk_your_key_here" \
     -H "Content-Type: application/json" \
     -d '{"stage":"new","limit":10,"sort":"intent"}'
   
3. Read entities directly

   Generic reads are also available, filtered by a JSON query.

   curl -G https://app.reputably.net/api/entities/Review \
     -H "Authorization: Bearer rpk_your_key_here" \
     --data-urlencode 'q={"needs_response":true}' \
     --data-urlencode 'limit=25'
   

The full surface is in the API reference.

Paging

Every list takes skip alongside limit (list_mentions takes page). Anything past the first page is reachable only by asking for it, so a tool that returns exactly limit rows is usually not the whole set. Ask for the next page before concluding you have everything.