Skip to main content

​
MCP tool: get_all_accounts

Retrieves a paginated list of all accounts in the organization. This tool supports search, sorting, and pagination to help you efficiently browse and filter accounts.

​
Example prompt

Get all accounts with search term "enterprise" and sort by name in descending order

​
Input parameters

NameTypeRequiredDescription
pagenumberNoPage number for pagination (default: 1)
limitnumberNoNumber of accounts per page (default: 10)
searchstringNoSearch term to filter accounts
sortstringNoField to sort by (e.g., “name”, “createdAt”)
orderstringNoSort order: “ASC” or “DESC” (default: “ASC”)

​
Response fields

Below are the fields you may see in each account object in the response:
FieldTypeDescription
idstringUnique identifier of the account
namestringName of the account
descriptionstringDescription of the account
sourcestringSource of the account (e.g., “hubspot”)
logostringURL of the account logo
statusIdstringID of the account status
statusstringStatus of the account
statusConfigurationobjectConfiguration of the status
classificationIdstringID of the account classification
classificationstringClassification of the account
classificationConfigurationobjectConfiguration of the classification
healthIdstringID of the account health
healthstringHealth of the account
healthConfigurationobjectConfiguration of the health
industryIdstringID of the account industry
industrystringIndustry of the account
industryConfigurationobjectConfiguration of the industry
primaryDomainstringPrimary domain of the account
secondaryDomainstringSecondary domain of the account
accountOwnerstringName of the account owner
accountOwnerIdstringID of the account owner
accountOwnerEmailstringEmail of the account owner
accountOwnerAvatarUrlstringAvatar URL of the account owner
annualRevenuenumberAnnual revenue of the account
employeesnumberNumber of employees
websitestringWebsite of the account
billingAddressstringBilling address of the account
shippingAddressstringShipping address of the account
customFieldValuesarrayCustom field values for the account
metadataobjectAdditional metadata for the account
createdAtstring (ISO8601)Creation timestamp
updatedAtstring (ISO8601)Last update timestamp

​
Sample response

{
  "data": [
    {
      "id": "ACC001",
      "name": "Acme Corporation",
      "description": "Leading technology solutions provider",
      "source": "hubspot",
      "logo": "https://example.com/logo.png",
      "statusId": "STATUS001",
      "status": "Active",
      "statusConfiguration": {
        "id": "STATUS001",
        "name": "Active",
        "color": "#10B981"
      },
      "classificationId": "CLASS001",
      "classification": "Enterprise",
      "classificationConfiguration": {
        "id": "CLASS001",
        "name": "Enterprise",
        "color": "#3B82F6"
      },
      "healthId": "HEALTH001",
      "health": "Good",
      "healthConfiguration": {
        "id": "HEALTH001",
        "name": "Good",
        "color": "#10B981"
      },
      "industryId": "IND001",
      "industry": "Technology",
      "industryConfiguration": {
        "id": "IND001",
        "name": "Technology",
        "color": "#8B5CF6"
      },
      "primaryDomain": "acme.com",
      "secondaryDomain": "acmecorp.com",
      "accountOwner": "John Doe",
      "accountOwnerId": "USER001",
      "accountOwnerEmail": "john.doe@company.com",
      "accountOwnerAvatarUrl": "https://example.com/avatar.jpg",
      "annualRevenue": 5000000,
      "employees": 250,
      "website": "https://acme.com",
      "billingAddress": "123 Business St, City, State 12345",
      "shippingAddress": "123 Business St, City, State 12345",
      "customFieldValues": [],
      "metadata": {
        "lastContactDate": "2025-07-24T10:00:00Z",
        "dealStage": "Negotiation"
      },
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  },
  "status": true,
  "message": "Accounts retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}