About
Verity is BTS's sales practice platform. Verity is operated by BTS (bts.com) and runs on the wonderway.io platform domain.
- Server URL
https://mcp.wonderway.io/mcp- Transport
- Streamable HTTP
- Authentication
- OAuth 2.1 authorisation code flow with PKCE
What it reads and writes
The connector works within your Verity tenant only.
- Reads: the organisations you belong to, bots, characters, scorecards, assignments, practice transcripts and evaluations, and analytics.
- Writes (full access only): bots, characters, scorecards, share links, assignments and practice sessions.
Your Verity role still applies on every call. The server reloads your permissions on each call, so a role change takes effect straight away.
Connect
-
Add the connector:
-
Claude: add Verity from the connector
directory, or go to Settings → Connectors → Add custom
connector and enter
https://mcp.wonderway.io/mcp. -
ChatGPT: add Verity as an app with the URL
https://mcp.wonderway.io/mcp.
-
Claude: add Verity from the connector
directory, or go to Settings → Connectors → Add custom
connector and enter
- Sign in with your Verity account.
-
Approve the consent screen, choosing one of:
-
Full access (
verity:write): every tool your role allows. -
Read only (
verity:read): exactly 12 tools are registered:list_organisations,ask_verity,get_practice_debrief,list_events,list_scorecards,get_scorecard,search,fetch,list_bots,get_bot_configuration,get_evaluationandexport_bot_assignment_report.
-
Full access (
Admins on Claude Team or Enterprise, and on ChatGPT Business or Enterprise, can add the connector for their whole organisation. Each user still signs in to Verity once.
To disconnect, go to Verity → Settings → Integrations → API keys and remove the app. You can also remove the connector in your AI client.
Choosing an organisation (tenant)
-
list_organisationsshows the organisations you can reach through the connector, and any whose admin has revoked access. - If you can reach one organisation, it is selected automatically.
-
If you can reach several, each call carries a
tenantargument. Say which organisation you mean and the assistant passes it on. -
For analytics across organisations,
ask_veritytakes atenantslist of up to 50 organisations in one call; batches of 25 or fewer answer fastest. This needs company-wide data access andreport:viewin every organisation listed.
Permissions
Prerequisites
An organisation is reachable through the connector only when all of the following hold:
- the organisation has the integrations feature enabled;
-
your Verity role has both
mcp_key:viewandmcp_key:organize; - your user in that organisation is not deleted.
What each permission unlocks
Each tool also needs the Verity permissions below in the organisation it runs against. Permissions marked “Full access” are only available on a Full access connection.
| Verity permission | What it unlocks | Tools |
|---|---|---|
report:view |
Analytics, your own debrief, events, and reading scorecards |
ask_verity, get_practice_debrief,
list_events (with lumi:view),
search, fetch,
list_scorecards, get_scorecard
|
report:export |
The bot assignment spreadsheet export | export_bot_assignment_report |
lumi:view |
Practice events (needs report:view too) |
list_events |
bot:view |
Listing and reading bots, and running practices |
list_bots, get_bot_configuration,
start_practice, send_message,
end_practice, get_evaluation,
practice_the_fix,
get_practice_context,
set_practice_context,
add_practice_context_file
|
bot:organize (Full access, with
bot:view)
|
Building and editing bots, the character library and the bot builder; also reading scorecards |
create_bot_configuration,
update_bot_configuration,
delete_bot_configuration,
list_characters, get_character,
create_character,
update_character,
delete_character,
start_bot_builder,
send_bot_builder_message,
get_bot_builder_reply,
list_scorecards, get_scorecard
|
bot:share (Full access, with
bot:view)
|
Assigning bots and managing public share links |
assign_bot, create_bot_share_link,
delete_bot_share_link
|
scorecard:view |
Reading scorecards |
list_scorecards, get_scorecard
|
scorecard:organize (Full access)
|
Creating, editing and deleting scorecards; also reading them |
create_scorecard,
update_scorecard,
delete_scorecard, list_scorecards,
get_scorecard
|
list_scorecards and get_scorecard need any
one of scorecard:view, scorecard:organize,
bot:organize or report:view.
list_organisations needs only the prerequisites above.
These checks are a first gate. Verity's own API checks your permissions again on every request the connector makes.
Tools
The connector exposes 33 tools. Read tools never change data. Write
tools appear only on a Full access connection, as do
list_characters, get_character and
get_bot_builder_reply, which read but need
bot:organize.
| Tool | Title | Purpose | Read or write | Permissions |
|---|---|---|---|---|
list_organisations |
List organisations | Lists the organisations you can reach, any with revoked access, and your monthly tool-call quota. | Read | Prerequisites only |
ask_verity |
Ask Verity | Answers a plain-English question about practice analytics for one organisation or several. | Read | report:view |
get_practice_debrief |
Get practice debrief | Returns the scored debrief of your own most recent practice. | Read | report:view |
list_events |
List events | Lists recent practice events with status and participant counts. | Read | report:view and lumi:view |
create_scorecard |
Create scorecard | Creates a scorecard from an ordered list of questions, headings and labels. | Write | scorecard:organize |
list_scorecards |
List scorecards | Lists the organisation's scorecards, paged. | Read | One of scorecard:view, scorecard:organize, bot:organize, report:view |
get_scorecard |
Get scorecard | Returns one scorecard with its full question list. | Read | One of scorecard:view, scorecard:organize, bot:organize, report:view |
update_scorecard |
Update scorecard | Renames a scorecard or replaces its questions. Built-in scorecards cannot be edited. | Write | scorecard:organize |
delete_scorecard |
Delete scorecard | Permanently deletes a scorecard. Built-in scorecards cannot be deleted. | Write | scorecard:organize |
create_bot_configuration |
Create bot configuration | Creates a practice bot from finished content in one step. | Write | bot:view and bot:organize |
update_bot_configuration |
Update bot configuration | Changes selected fields of an existing bot. | Write | bot:view and bot:organize |
delete_bot_configuration |
Delete bot configuration | Removes a bot from listings and practice; past transcripts and evaluations are kept. | Write | bot:view and bot:organize |
assign_bot |
Assign bot | Assigns a bot to a region, sub-region, group or named users. Existing assignments are never removed. | Write | bot:view and bot:share |
create_bot_share_link |
Create bot share link | Creates a passphrase-protected public link to practise a bot without a Verity account, or returns the existing one. | Write | bot:view and bot:share |
delete_bot_share_link |
Delete bot share link | Turns off a bot's public share link. | Write | bot:view and bot:share |
search |
Search |
Turns an analytics question into a result handle that
fetch runs.
|
Read | report:view |
fetch |
Fetch |
Runs the question behind a search result and
returns the answer as a document.
|
Read | report:view |
list_bots |
List bots | Lists the practice bots your role can access, paged. | Read | bot:view |
get_bot_configuration |
Get bot configuration | Returns one bot's full configuration. | Read | bot:view |
list_characters |
List characters | Lists the characters in the organisation's character library. | Read | bot:view and bot:organize |
get_character |
Get character | Returns one library character and the roleplays it is cast in. | Read | bot:view and bot:organize |
create_character |
Create character | Adds a character to the library. | Write | bot:view and bot:organize |
update_character |
Update character | Changes a library character's details. | Write | bot:view and bot:organize |
delete_character |
Delete character | Removes a character from the library; roleplays that cast it keep their copy. | Write | bot:view and bot:organize |
start_practice |
Start practice | Starts a practice with a bot, either as a text roleplay in the conversation or as a link to the Verity web app. | Write | bot:view |
send_message |
Send message | Sends your next turn in a text practice and returns the bot's reply. | Write | bot:view |
end_practice |
End practice | Ends a text practice and submits it for scoring. | Write | bot:view |
get_evaluation |
Get evaluation | Returns the score of a submitted practice, then its debrief a few minutes later. | Read | bot:view |
practice_the_fix |
Practice the fix | Starts a new text practice that replays the turning point of a finished practice so you can try it again. | Write | bot:view |
get_practice_context |
Get practice context | Shows the situation and files you added to a roleplay that allows your own context. | Read | bot:view |
set_practice_context |
Set practice context | Saves your situation in your own words so the roleplay adapts to it from your next practice. Your managers can see what you type. | Write | bot:view |
remove_practice_context |
Remove practice context | Removes your context and every file you added to a roleplay. | Write | None (your own data) |
add_practice_context_file |
Add practice context file | Adds a PDF of up to 10 MB to your context. The desktop extension reads it from your computer; other connections link to the practice page to attach it. Your managers cannot see your files. | Write | bot:view |
remove_practice_context_file |
Remove practice context file | Removes one file from your context. | Write | None (your own data) |
start_bot_builder |
Start bot builder | Creates a draft bot and opens a session with Verity's AI bot builder. | Write | bot:view and bot:organize |
send_bot_builder_message |
Send bot builder message | Passes your message to the bot builder. | Write | bot:view and bot:organize |
get_bot_builder_reply |
Get bot builder reply | Returns the bot builder's latest reply. | Read | bot:view and bot:organize |
export_bot_assignment_report |
Export bot assignment report | Exports current bot assignments with activity and scores as an .xlsx download. | Read | report:export |
Prompts
The server also provides two prompts:
-
verity-practice: running a practice or roleplay, presenting the debrief, and working with the bot builder. -
verity-insights: wide analysis across organisations that stays within the monthly quota.
Hosts list both in their prompts or attach menu.
Limits
| Limit | Value |
|---|---|
| Per signed-in user | 60 requests per minute |
| Per IP address | 200 requests per minute |
| Per user, rolling 30 days | 2000 tool calls (production) |
Only tool calls count toward the monthly quota; connection set-up
does not. list_organisations reports how much of your
quota you have used.
-
A per-minute rejection returns HTTP 429 with body
{"error":"rate_limit_exceeded"}. -
A monthly rejection returns HTTP 429 with body
{"error":"rate_limit_exceeded","scope":"monthly"}.
To raise your monthly limit, email veritysupport@bts.com.
Troubleshooting
- 401 errors, or the client asks you to reconnect
- Remove the connector and add it again, then sign in.
- Write tools are missing
- The connection is read only, so reconnect and choose Full access, or your Verity role lacks the permission the tool needs.
- An organisation is “not in this token's scope”
-
You are not a member of that organisation, or it does not meet the
prerequisites above. Check the name with
list_organisations. - An organisation is listed as revoked
- An admin of that organisation revoked the app's access. Signing in again does not restore it: disconnect and re-authorise Verity in your AI client.
- HTTP 429, per-minute limit
- Wait a minute and try again.
- HTTP 429 with
"scope":"monthly" - Your monthly quota is spent. Contact support to raise it.
- A debrief shows
processing - Scoring takes a few minutes after a session ends, and the debrief follows the score a few minutes later. Check again shortly.
- You belong to several organisations
- Name the organisation you mean in your request.