Overview
Repsly MCP lets Admins ask questions about Repsly data in their own AI tool. Repsly provides the numbers, and your AI tool writes the answer. It can only answer questions we've built a tool for, so if Repsly doesn't store the data or there's no tool for it yet, there's no correct answer, even if the AI tool sounds confident.
What it can answer
Area |
Example questions |
|---|---|
Visit compliance |
"How does this week's compliance compare to last week?" "Which Representatives are at risk?" |
Missed visits |
"Which visits did we miss last week, and what tasks were on them?" |
Upcoming visits |
"What's on my team's schedule next week?" |
Completed visits |
"What did [Representative] complete this week, and how long were they in each store?" |
Form submissions |
"How many forms came in per template last month?" "Who submitted the [form name] at [store] last week?" |
Form answers |
"What did Representatives report in the [form name] last week?" "Which stores answered No to [question] in [form name] this month?" |
Name lookups |
Finds the right Representative, place or form from a name, code or email, and asks you when several match |
What it can't answer (yet)
Repsly doesn't store the data:
Reasons, for example "Why did [Representative] miss this visit?"
Change history, for example "Who moved this visit?" (the Schedule Audit Log is in progress)
Data from your own systems, such as targets, sales or payroll. You can give the AI tool a target in the chat, for example "our target is 25 visits per Representative per week".
Repsly stores it, but there's no tool yet:
Photos themselves. Form answers include a link to each photo, not the image.
Time in store and visit share rolled up by account or territory, and visit counts by territory or team
Other modules, such as Time & Mileage, orders and place tags
The AI tool should tell you when it can't answer. Sometimes it guesses from nearby data instead. Treat a confident answer to one of these as a red flag.
How to read an answer
The numbers come from Repsly. The explanation comes from your AI tool. The data is accurate, but the answer can still be off if the AI tool:
summarizes a partial list as if it were complete (see limits below)
uses the wrong date range or the wrong Representative (for example, one of two "Jamie"s)
adds a reason the data doesn't support
For anything important, ask "Which Repsly tool and date range did you use?" and check the number in Repsly.
Limits during the beta
Limit |
What it means for you |
|---|---|
Lists return up to 50 rows (100 for completed visits), newest first |
For bigger questions, the AI tool sees only the most recent rows. It always gets the true total, so ask it to say when a list is partial, or narrow the question (shorter dates, one Representative or store) |
Visit lists cover up to 32 days per question |
For longer periods, the AI tool has to ask several times. Ask for one month at a time |
Form submission lists cover up to 90 days, counts per form up to 32 days |
Same as above |
Form answers cover up to 31 days per question, for all forms or one form |
Same as above. Name the form when you can, so the AI tool only reads the answers you need |
Name searches return up to 50 matches |
Use more of the name, a code or an email |
Up to 10,000 calls per company per day |
You're unlikely to hit this with normal use |
Tips for good answers
Be specific: a date range, a team or territory, a Representative, a store. "Last week" works, "recently" doesn't.
Say "in Repsly" if the AI tool doesn't use Repsly on its own.
Start a new chat for a new topic. Long chats get slower and use more of your AI tool's allowance.
Give it your context. Targets, which Representatives cover which accounts, what "good" looks like. Repsly doesn't know your targets.
Use the starter prompts and skills in [Repsly MCP Beta: Starter Prompts and Skills] instead of starting from a blank chat.
Good for exploring, not for pay or billing
Use Repsly MCP for quick questions, weekly check-ins and spotting issues. Don't use it as the source for anything someone gets paid, billed or penalized on (Representative pay, incentives, client invoicing, chargebacks, labor audits). Two people asking the same question can get differently worded answers, and there's no single official run. For those, use Repsly's reports and Insights Dashboard.
Data, security and costs
Read-only. It can't create, edit or delete anything in Repsly. Write actions come later, once the Schedule Audit Log is built.
Same data you see in Repsly. An Admin in Team LG and Territory West Coast only gets that team and territory's data. During the beta, Admins limited to specific teams can't ask about missed visits or visit compliance.
Your Repsly login. You sign in on Repsly's own sign-in page, so your AI tool never sees your password. You can sign out at any time.
Your AI tool's terms apply. Data the AI tool reads is processed by your AI provider under your agreement with them. Check with your IT team if you're not sure what's allowed.
What Repsly logs. For each question, Repsly logs who asked, which tool was used and the data it returned, plus a one-sentence summary of what you were trying to find out (the AI tool is instructed to leave people's names out of it). We use this for security auditing and to see what's useful and what's missing. More detail for your IT team is in [Repsly MCP Beta: Security and Data FAQ].
Costs. Repsly MCP is included at no added cost during the beta. Each question also uses your AI tool's own allowance, which Repsly doesn't provide or pay for.
Known beta issues
Upcoming visits can include Representatives who were deactivated.
Some times come back in UTC. Ask the AI tool to convert to local time if a check-in looks off by a few hours.
Very occasionally, a weekly count can be off by one compared with Repsly. If you see this, please tell us.
FAQ
Which AI tool should I use? The one your company already approves for work data. Repsly MCP works with Claude, ChatGPT, Gemini and Microsoft Copilot. Most of our own testing was done in Claude.
Can Representatives use it? Not during the beta. It's for Admins only.
-
Why doesn't a number match a Repsly report? Usually one of these:
Visit compliance counts planned visits only, while completed visits also include unplanned ones.
The date range is different. Days are counted in the store's local time, while some times come back in UTC.
-
The list was partial, so the AI tool only saw the most recent rows.
Ask "Which Repsly tool and date range did you use?" and if it still doesn't match, send us a screenshot.
Why can't it find a Representative or store? Name searches only cover the Representatives and stores you can see in Repsly, and only active ones unless you ask for inactive ones too. Try their ID or email, or more of the name.
Can I combine Repsly data with other data, like sales or targets? Yes, if your AI tool also has that data (through another connector or a file you upload). Repsly MCP only provides Repsly data and your AI tool does the combining, so check the result.
Can I share what the AI tool builds, like a dashboard or summary? Yes, but it's a snapshot from when it ran, and anyone you share it with sees that data even if they can't see it in Repsly. Add the date, and check before sharing outside your company.
Can I set up a report that runs every week on its own? Some AI tools can run a saved prompt on a schedule. Repsly MCP works there too, as long as you stay signed in (up to 45 days, and you need to use it at least once every 10 days).
What happens after the beta? We'll decide on general availability based on beta usage and feedback, and we'll let you know before anything changes for you.
Is our data safe? Can our IT team review it? See Repsly MCP Beta: Security and Data FAQ.
Feedback
This is a beta, so feedback shapes what we build next. When an answer looks wrong, take a screenshot, note the date and time, and send it to nika.besker@repsly.com or your Customer Success Manager. Tell us which of these it was:
Wrong data: the numbers don't match Repsly
Wrong reading: right data, but wrong dates, wrong person, a partial list or a made-up reason
Missing: a question you wanted to ask that it couldn't answer