Tools¶
The server registers 12 tools. Every tool is auto-documented from the live registry — the pages below are regenerated on every build, so the schemas you see here always match the running server.
| Tool | What it does |
|---|---|
compare_calls |
Compare two calls side-by-side |
detect_changes |
Compare two time periods and detect significant changes across signals, scores, agents, drivers, dimensions, and guid… |
get_agent_performance |
Get per-agent performance over a date range: call volume, average Compass Score, predicted-CSAT, average agent lift, … |
get_call_detail |
Get full detail for a single call: metadata, transcript, Compass scores, agent lift, trust, signals, guidance, dimens… |
get_project_context |
Get context about this client's data: agent roster, call volume, date range, verticals (industry), interaction driver… |
get_project_summary |
Get high-level metrics for this project: total calls evaluated, average Compass Score, Compass-score distribution, ag… |
get_signals |
List signal definitions for this project |
query_interactions |
Execute a MongoDB aggregation pipeline against evaluated interactions |
query_knowledge_base |
Semantic search over the project's configured knowledge base (product docs, policy pages, internal wiki) |
query_user_activity |
Query user activity within your project for admin users |
search_calls |
Find calls by date range, agent name, Compass-score range, or agent-lift band |
search_guidance |
Search the Compass guidance catalog (coaching opportunities and excellence behaviors) |
How tools work¶
All tools share the same calling convention:
- The MCP client invokes a tool by name with a JSON object of parameters.
- The server injects
project_idandaccess_scopefrom the bearer token. - The tool executes against the live Compass database and returns a JSON
result. Errors come back as
{ "error": "..." }.
See the Python integration guide for an end-to-end example.
RBAC summary¶
| Tool | Honours allowed_agents? |
Role-gated? |
|---|---|---|
search_calls |
yes | no |
get_call_detail |
yes (404 on cross-agent) | no |
compare_calls |
yes | no |
get_project_summary |
yes | no |
get_agent_performance |
yes | no |
get_project_context |
yes (roster + aggregations) | no |
query_interactions |
yes (pipeline injection) | no |
detect_changes |
yes | no |
query_user_activity |
n/a — admin tool | Admin / SuperAdmin |
get_signals |
no (global catalog) | no |
search_guidance |
no (global catalog) | no |
query_knowledge_base |
no (per-project KB) | no |
See Authentication & RBAC for the full story.