Skip to main content

​
MCP tool: get_account

Retrieves detailed information about a specific account by its unique identifier. This tool provides comprehensive account details including status, classification, health, industry, and contact information.

​
Example prompt

Get account with ID ACC001

​
Input parameters

NameTypeRequiredDescription
idstringYesThe unique identifier of the account to retrieve

​
Response fields

Below are the fields you may see 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"
  },
  "status": true,
  "message": "Account retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}