Verity MCP connector

Connect an AI assistant such as Claude to your Verity sales practice data over the Model Context Protocol.

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

  1. 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.
  2. Sign in with your Verity account.
  3. 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_evaluation and export_bot_assignment_report.

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_organisations shows 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 tenant argument. Say which organisation you mean and the assistant passes it on.
  • For analytics across organisations, ask_verity takes a tenants list of up to 50 organisations in one call; batches of 25 or fewer answer fastest. This needs company-wide data access and report:view in 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:view and mcp_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 permissions and the tools they unlock
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.

Support