Skip to main content
The OnePerfectSlice MCP server exposes 9 tools. Each tool maps to one or more API endpoints but is designed for conversational use — flat parameters, composite operations, and error messages that guide the agent to the right next step.

list_slices

Discover what analyses are available, or get full details for a specific slice.
ParameterTypeRequiredDescription
slice_keystringNoIf provided, returns full detail with output schema. Otherwise returns the full catalog.
Example prompts:
  • “What slices do I have access to?”
  • “Show me the details for the high_intent_deals slice”

preview_slice_count

Check how many calls match your filters — without starting a run or using AI credits.
ParameterTypeRequiredDescription
slice_keystringYesWhich slice to preview
date_fromstringYesStart date (ISO format, e.g., 2026-03-26)
date_tostringYesEnd date
call_typesstring[]NoFilter by call type keys
call_owner_emailsstring[]NoFilter by rep emails
company_domainsstring[]NoFilter by company domains
crm_deal_stagesstring[]NoFilter by CRM deal stages
crm_deal_idsinteger[]NoFilter by CRM deal IDs
crm_company_idsinteger[]NoFilter by CRM company IDs
crm_amount_minnumberNoMinimum deal amount
crm_amount_maxnumberNoMaximum deal amount
crm_field_filtersstring[]NoCustom CRM filters ("field=value" syntax)
Example prompts:
  • “How many discovery calls happened last month?”
  • “Preview how many calls match the high_intent_deals slice for Q1”

run_slice

Run an AI analysis and get results. Waits up to 30 seconds for completion — if the run takes longer, returns a run ID for polling with get_run.
ParameterTypeRequiredDescription
slice_keystringYesWhich slice to run
date_fromstringYesStart datetime (ISO format)
date_tostringYesEnd datetime
call_typesstring[]NoFilter by call type keys
call_owner_emailsstring[]NoFilter by rep emails
company_domainsstring[]NoFilter by company domains
crm_deal_stagesstring[]NoFilter by CRM deal stages
crm_deal_idsinteger[]NoFilter by CRM deal IDs
crm_company_idsinteger[]NoFilter by CRM company IDs
crm_amount_minnumberNoMinimum deal amount
crm_amount_maxnumberNoMaximum deal amount
crm_field_filtersstring[]NoCustom CRM filters ("field=value" syntax)
What happens behind the scenes:
  1. Starts an async run via the API
  2. Polls for up to 30 seconds
  3. If completed, automatically fetches evidence and returns everything together
  4. If still running, returns the run ID with a progress message
Example prompts:
  • “Run the high intent deals analysis on last month’s calls”
  • “Analyze discovery calls from the past 2 weeks for the enterprise team”

get_run

Retrieve results from a past run, or check progress on a running one. By default it returns the synthesized result without pulling all evidence — drill into evidence only when you need it.
ParameterTypeRequiredDescription
run_idintegerYesThe run ID (returned by run_slice or list_runs)
summary_onlybooleanNoReturn just the synthesis — a convenience alias for include=["result"]
includestring[]NoWhat to return: any of result, evidence
element_keysstring[]NoWhen fetching evidence, limit to these analysis elements
call_owner_emailsstring[]NoWhen fetching evidence, limit to these reps
Example prompts:
  • “Get the summary for run 12345”
  • “Show me the budget-objection evidence from run 12345”
  • “Check if my last analysis is done yet”

list_runs

Browse your team’s run history with optional filtering.
ParameterTypeRequiredDescription
slice_keystringNoFilter by slice
statusstringNopending, running, completed, or failed
call_owner_emailsstring[]NoFilter to runs scoped to these reps
limitintegerNoNumber of results (1–100)
offsetintegerNoPagination offset
Example prompts:
  • “Show me recent completed runs”
  • “What runs are currently active?”
  • “List the last 5 high_intent_deals runs”
  • “Find Jane’s recent runs I can reuse”

search_posts

Find AI-generated summaries and scorecards matching your criteria. Returns compact rows by default — each carries a fileId so summary and scorecard rows for the same call can be deduplicated. Use template_type to narrow to one artifact, or detail=true / get_post for full content.
ParameterTypeRequiredDescription
template_typestringNosummary or scorecard
call_type_idsinteger[]NoFilter by call type IDs
date_fromstringNoStart datetime
date_tostringNoEnd datetime
call_owner_emailsstring[]NoFilter by rep emails
company_domainsstring[]NoFilter by company domains
crm_deal_stagesstring[]NoFilter by CRM deal stages
crm_deal_idsinteger[]NoFilter by CRM deal IDs
crm_company_idsinteger[]NoFilter by CRM company IDs
crm_amount_minnumberNoMinimum deal amount
crm_amount_maxnumberNoMaximum deal amount
crm_field_filtersstring[]NoCustom CRM filters
detailbooleanNoReturn full structured content instead of compact rows
fieldsstring[]NoLimit the returned fields
limitintegerNoResults per page (1–100)
offsetintegerNoPagination offset
Example prompts:
  • “Find scorecards for Jane’s calls last week”
  • “Search for summaries mentioning Acme Corp”
  • “Get the most recent 10 discovery call summaries”

get_post

Retrieve a single post with full structured content.
ParameterTypeRequiredDescription
post_idintegerYesThe post ID
Example prompts:
  • “Show me post 456”
  • “Get the full scorecard for that call”

search_evidence

Search for evidence quotes across all completed runs. Useful for finding patterns or specific mentions across multiple analyses.
ParameterTypeRequiredDescription
element_keysstring[]YesWhich elements to search (e.g., ["intent_signal"])
querystringNoFree-text search across quotes
call_typesstring[]NoFilter by call type keys
call_owner_emailsstring[]NoFilter by rep emails
date_fromstringNoStart date
date_tostringNoEnd date
limitintegerNoMax results (1–100)
Example prompts:
  • “Find evidence of budget objections in discovery calls”
  • “Search for competitive mentions from the last quarter”
  • “Show me intent signals from Jane’s calls last month”
search_evidence filters by element, rep, call type, and date — not by company. To scope evidence to one account, use search_posts (which supports company_domains) or run a slice filtered to that company.

get_filter_options

Discover valid values for any filter type. Call this before filtering when you’re not sure what values are available.
ParameterTypeRequiredDescription
filter_typestringYesSee table below
querystringNoPrefix search (for typeahead-capable filters)
Available filter types:
ValueWhat it returnsSupports query
call_typesCall type keys and labelsNo
elementsAnalysis element keys and labelsNo
call_ownersRep names and emailsYes
company_domainsCompany domainsYes
crm_dealsCRM deal namesYes
crm_companiesCRM company namesYes
crm_deal_stagesPipeline stagesNo
crm_fieldsCustom CRM field definitionsNo
post_filtersAvailable post filter keysNo
Example prompts:
  • “What call types are available?”
  • “Search for call owners named Jane”
  • “What CRM deal stages exist?”
  • “Show me available CRM custom fields”