MCP Server

All tools are called via the tools/call JSON-RPC method:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "tool-name",
    "arguments": { ... }
  },
  "id": 1
}

vendorId is automatically set from your API key. You do not need to include it in tool arguments.

Query tools

get-stats

Fast, lightweight tool returning unfiltered totals for your workspace plus rewards activity. Minimum privilege: Content Viewer | Parameters: None required. Response:

{
  "data": {
    "tools": {
      "get-people": { "total": 619 },
      "get-companies": { "total": 526 },
      "get-contents": { "total": 3322 }
    },
    "rewards": {
      "totalRedemptions": 124,
      "totalRedeemedAmount": 9300,
      "totalRedeemableAmount": 4150
    }
  }
}

Use the rewards section when users ask about redemptions, total redeemed, rewards given, or outstanding rewards.

get-people

Query references and prospects with filtering, sorting, and pagination. Minimum privilege: Content Viewer

Parameter	Type	Required	Description
search	String	No	Free-text search. 3+ words triggers AI semantic search; 1–2 words filters by name/email/content.
userPrivileges	String	No	`reference` or `prospect`
page	Number	No	Page number (default: 1)
pageSize	Number	No	Items per page (default: 100)
orderBy	String	No	`createdAt`, `updatedAt`, `authenticatedUser.firstName`, `authenticatedUser.lastName`, `account.companyName`
orderDirection	String	No	`ASC` or `DESC` (default: DESC)
fields	Array	No	`basic`, `status`, `tags`, `contributions`, `availability`
context	Object	No	Advanced filtering (see below)

Context filters — by criteria:

{
  "context": {
    "type": "filters",
    "filters": {
      "referenceStatus": ["referrer-confirmed", "confirmed", "pending"],
      "callAvailabilities": ["100", "6", "3", "1"],
      "additionalFields": [
        { "customizedFormFieldId": "uuid", "value": ["value"] }
      ]
    }
  }
}

callAvailabilities values: "100" (as needed), "6" (up to 6/quarter), "3" (up to 3/quarter), "1" (up to 1/quarter), "0" (not available), "suspended" (deactivated). For “available for calls”: ["100", "6", "3", "1"]. For “unavailable”: ["0", "suspended"]. Context filters — by ID:

{
  "context": {
    "type": "views",
    "views": { "peopleIds": ["uuid1", "uuid2"] }
  }
}

The response metadata includes availableAdditionalFields with customizedFormFieldId, fieldName, and allowed values for your workspace.

get-companies

Query companies and accounts with search, filtering, and pagination. Minimum privilege: Content Viewer

Parameter	Type	Required	Description
search	String	No	Search by company name
page	Number	No	Page number (default: 1)
pageSize	Number	No	Items per page
fields	Array	No	`basic`, `extended`, `tags`
context	Object	No	Filter by companyIds or companyNames

get-contents

Query content assets including quotes, reviews, video testimonials, case studies, and more. Minimum privilege: Content Viewer By default, returns both approved and internal only assets. Internal only assets (e.g. Gong transcripts) are safe for AI generation context but are not for external sharing. Pass vendorPublishPolicies explicitly to restrict to specific statuses.

Parameter	Type	Required	Description
search	String	No	Full-text search
includeFullContent	Boolean	No	When true, returns full un-truncated publishedContent. Use when the user wants to read or paste the full quote.
type	String	No	`Quote`, `Review`, `VideoTestimonial`, `url`, `pdf`, `CaseStudy`, `QuestionsAndAnswers`, `extractedText`
page	Number	No	Page number
pageSize	Number	No	Items per page
orderBy	String	No	`createdAt`, `vendorPublishPolicy`, `name`, `lastEditedAt`
context	Object	No	Filter by types (array), tags, companyIds

To filter by multiple content types, use context.filters.types (array) instead of the type parameter (single value only). Q&A content: QuestionsAndAnswers assets include a qa: field with full question/answer pairs formatted as qa: Q: <question> | A: <answer>; .... Answers are truncated to 300 chars each.

get-prospects-dashboard

Retrieve the prospect pipeline view with optional meeting data. Minimum privilege: Rep

Parameter	Type	Required	Description
page	Number	No	Page number (default: 1)
pageSize	Number	No	Items per page
fields	Array	No	`basic`, `meetings`, `full`
opportunityOwnerIds	Array	No	Filter by opportunity owner UUIDs
prospectTemplateIds	Array	No	Filter by prospect template UUIDs

get-content-instructions

Get the schema, validation rules, and examples for creating content of a specific type. Minimum privilege: Rep

Parameter	Type	Required	Description
contentType	String	Yes	`CaseStudy` or `WinLossReport`

Always call get-content-instructions before using save-draft-content to understand the expected structure.

Create tools

create-company

Create a new company in your workspace. Minimum privilege: Admin

Parameter	Type	Required	Description
companyName	String	Yes	Must be unique in workspace
website	URL	No	Company website
companySize	String	No	Size category
linkedInProfile	String	No	LinkedIn company page URL

Response:

{
  "success": true,
  "data": {
    "accountId": "uuid",
    "companyName": "Acme Corp"
  }
}

create-person

Create a new reference contact. Minimum privilege: Admin

Parameter	Type	Required	Description
email	String	Yes	Must be unique
firstName	String	Yes	First name
lastName	String	Yes	Last name
companyName	String	Yes	Associated company
title	String	No	Job title
linkedInProfile	String	No	LinkedIn URL

Response:

{
  "success": true,
  "data": {
    "accountContactId": "uuid",
    "email": "..."
  }
}

save-draft-content

Save a content draft (case study or win/loss report). Minimum privilege: Admin The publishedContent array is required and must contain the actual content blocks. This tool does not generate content — build the content first, then pass it here to save.

Parameter	Type	Required	Description
context	Object	Yes	`{ "conversationId": "uuid" }`
messageId	UUID	Yes	ID of the assistant message creating this draft
type	String	Yes	`CaseStudy` or `WinLossReport`
name	String	Yes	Draft name (min 3 chars, unique per type in conversation)
title	String	No	Display title (defaults to name)
publishedContent	Array	Yes	Array of content blocks
tags	Array	No	Tags for categorization
metadata	Object	No	Additional metadata

Content block types:

Block type	Description	Key fields
title	Content title heading	text
paragraph	Text paragraph (supports inline HTML)	text
container	Reference to source content	sourceContentObjectId, content
quoteBlock	Quote from a reference	text
author	Author attribution	text, participant info

AI Agent tool

start-agent

Trigger an AI agent workflow that can reason over your Deeto workspace data and complete multi-step tasks autonomously. Minimum privilege: Admin

This tool is available in the backend but is in active development. Behavior and parameters may evolve. Contact your Customer Success Manager before building workflows that depend on it.

Parameter	Type	Required	Description
prompt	String	Yes	Natural language instruction for the agent to execute
context	Object	No	Optional context such as specific record IDs or filters to scope the agent’s work

The agent can use other MCP tools internally (get-people, get-contents, etc.) to gather data before producing a result. It returns a structured response containing the agent’s output and any tool calls it made.

Pagination

All list tools support consistent pagination:

// Request
{ "page": 1, "pageSize": 50 }

// Response
{
  "pagination": {
    "totalCount": 1000,
    "returned": 50,
    "hasNext": true,
    "isLastPage": false
  }
}

Limit	Value
Default page size	100
Max response size	90 KB

Responses exceeding the size limit are automatically truncated with hasNext: true.

Support: Contact your Deeto Customer Success Manager or email support@deeto.ai.

HubSpot

Salesforce

Other Integrations

MCP Server — Tools Reference

Query tools

get-stats

get-people

get-companies

get-contents

get-prospects-dashboard

get-content-instructions

Create tools

create-company

create-person

save-draft-content

AI Agent tool

start-agent

​Query tools

​get-stats

​get-people

​get-companies

​get-contents

​get-prospects-dashboard

​get-content-instructions

​Create tools

​create-company

​create-person

​save-draft-content

​AI Agent tool

​start-agent

​Pagination

Query tools

get-stats

get-people

get-companies

get-contents

get-prospects-dashboard

get-content-instructions

Create tools

create-company

create-person

save-draft-content

AI Agent tool

start-agent

Pagination