Analytics

Analytics tools include field-level argument descriptions and runnable examples for MCP clients.

Tools Covered

Tool	Mutation	Backend Routes
`analytics_fetch_pitch`	No	`/retrieve-pitch-analytics`
`analytics_chat_grounded`	No	–

`analytics_fetch_pitch`

Fetch pitch analytics payload.

Backend routes: /retrieve-pitch-analytics

Arguments

Field	Type	Required	Description	Example
`pitch_id`	string	Yes	Deal room / playbook pitch identifier.	`PCH1774126974294428638749`
`page`	number	No	Pagination page number (1-based).	`1`
`limit`	number	No	Maximum records to return.	`20`
`viewer_id`	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	`IGH6969811447860000000000`
`organisation_id`	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	`PDX7478889578460000000000`

Example Request

Fetch analytics payload for a deal room

{
  "jsonrpc": "2.0",
  "id": "analytics_fetch_pitch-1",
  "method": "tools/call",
  "params": {
    "name": "analytics_fetch_pitch",
    "arguments": {
      "pitch_id": "PCH1774126974294428638749",
      "page": 1,
      "limit": 500
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "analytics_fetch_pitch",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for analytics_fetch_pitch.",
    "status": 400,
    "retryable": false
  }
}

`analytics_chat_grounded`

Grounded analytics Q&A with citations.

Backend routes: Derived/indirect handler route.

Arguments

Field	Type	Required	Description	Example
`pitch_id`	string	Yes	Deal room / playbook pitch identifier.	`PCH1774126974294428638749`
`question`	string	Yes	Grounded analytics question asked by assistant.	`Which buyer persona is most engaged this week and what should I do next?`
`buyer_email`	string	No	Optional buyer email to focus analytics/journey data to one contact.	`buyer@acme.com`
`session_id`	string	No	Optional session identifier for narrowing buyer journey results.	`SES1774126974294428638749`
`thread_id`	string	No	Mailbox thread ID.	`THR1774126974294428638749`
`email_account`	string	No	Optional mailbox account ID to resolve thread in multi-mailbox setups.	`MBA1774126974294428638749`
`include_emails`	boolean	No	When true, include email signal data in journey/analytics context.	`true`
`include_meetings`	boolean	No	When true, include meeting signal data in journey/analytics context.	`true`
`analytics_limit`	number	No	Max analytics rows fetched for grounded answer context.	`200`
`journey_limit`	number	No	Max buyer journey rows fetched for grounded answer context.	`200`
`search_context_query`	string	No	Optional scoped semantic query used to narrow context before answering analytics question.	`security and procurement objections`
`viewer_id`	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	`IGH6969811447860000000000`
`organisation_id`	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	`PDX7478889578460000000000`

Example Request

Ask grounded analytics question

{
  "jsonrpc": "2.0",
  "id": "analytics_chat_grounded-1",
  "method": "tools/call",
  "params": {
    "name": "analytics_chat_grounded",
    "arguments": {
      "pitch_id": "PCH1774126974294428638749",
      "question": "What is the best next action based on recent engagement?",
      "include_emails": true,
      "include_meetings": true,
      "analytics_limit": 200,
      "journey_limit": 200
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "analytics_chat_grounded",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for analytics_chat_grounded.",
    "status": 400,
    "retryable": false
  }
}