Skip to main content

​
MCP tool: filter_accounts_by_ids

Filters accounts based on a list of account IDs. This tool is useful for retrieving specific accounts when you have their IDs, or for bulk operations on a set of known accounts.

​
Example prompt

Filter accounts by IDs ["ACC001", "ACC002", "ACC003"]

​
Input parameters

NameTypeRequiredDescription
idsstring[]YesList of account IDs to filter by

​
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"
    },
    {
      "id": "ACC002",
      "name": "TechCorp Solutions",
      "description": "Technology consulting firm",
      "source": "manual",
      "logo": "https://example.com/techcorp-logo.png",
      "statusId": "STATUS002",
      "status": "Prospect",
      "statusConfiguration": {
        "id": "STATUS002",
        "name": "Prospect",
        "color": "#F59E0B"
      },
      "classificationId": "CLASS002",
      "classification": "Mid Market",
      "classificationConfiguration": {
        "id": "CLASS002",
        "name": "Mid Market",
        "color": "#8B5CF6"
      },
      "healthId": "HEALTH002",
      "health": "Yellow",
      "healthConfiguration": {
        "id": "HEALTH002",
        "name": "Yellow",
        "color": "#F59E0B"
      },
      "industryId": "IND001",
      "industry": "Technology",
      "industryConfiguration": {
        "id": "IND001",
        "name": "Technology",
        "color": "#8B5CF6"
      },
      "primaryDomain": "techcorp.com",
      "secondaryDomain": null,
      "accountOwner": "Jane Smith",
      "accountOwnerId": "USER002",
      "accountOwnerEmail": "jane.smith@company.com",
      "accountOwnerAvatarUrl": "https://example.com/jane-avatar.jpg",
      "annualRevenue": 2000000,
      "employees": 100,
      "website": "https://techcorp.com",
      "billingAddress": "456 Tech Ave, Innovation City, CA 94025",
      "shippingAddress": "456 Tech Ave, Innovation City, CA 94025",
      "customFieldValues": [],
      "metadata": {
        "leadSource": "Website",
        "dealStage": "Qualification"
      },
      "createdAt": "2025-07-24T08:19:10.258Z",
      "updatedAt": "2025-07-24T08:19:10.258Z"
    }
  ],
  "status": true,
  "message": "Accounts filtered successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}