ListPlus

Check and clean B2B contacts in your lists, find leads, size markets, fill work e-mail and mobile.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
96%
Naming quality
95%
Poisoning risk
60%
Permission match
100%
Protocol compliance
100%

Findings (5)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'check_records' description contains placeholder textin check_records
  • MEDIUMTool 'fix_list' description contains placeholder textin fix_list
  • INFOTool description contains placeholder or incomplete textin check_records
  • INFOTool description contains placeholder or incomplete textin fix_list

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~13,145Tokens (tool definitions)
~4.4 KBTypical response size
Significant attention impact (10.27% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "listplus": {
      "url": "https://listplus.ai/mcp"
    }
  }
}

Remote endpoints

https://listplus.ai/mcpstreamable-http

What it can do

Tool inventory

Tools (26)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒what_can_you_do(guide, language)

FREE β€” Use first when you are unsure what ListPlus offers, what something costs or how much budget is left. what ListPlus can do for you: every action, the fields we can fill with their price per record, the free limits, and (with a key) your balance and day budget. With `guide`: one chapter of the manual instead (prices, search, lists, setup, rules, limits, examples).

Input Schema

{
  "type": "object",
  "properties": {
    "guide": {
      "description": "One chapter of the manual as text instead of the overview; `all` = the whole manual",
      "type": "string",
      "enum": [
        "prices",
        "search",
        "lists",
        "setup",
        "rules",
        "limits",
        "examples",
        "all"
      ]
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒find_person(first_name, last_name, name, company, domain, ...)

FREE with a key (rate-limited) β€” Use when your user names a person, or a role at a company, and wants to know who that is: title, company, LinkedIn profile. find a person: name, job title, company, location, LinkedIn profile, how sure. Give first_name + last_name + company (or domain), a LinkedIn URL, a work e-mail, or a question in `query` ("CFO of Tink in Berlin"). No e-mail or phone in the answer β€” those are enrich_records.

Input Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "description": "The person's first name",
      "type": "string"
    },
    "last_name": {
      "description": "The person's last name",
      "type": "string"
    },
    "name": {
      "description": "Full name, when there is no split",
      "type": "string"
    },
    "company": {
      "description": "The company they work at (name)",
      "type": "string"
    },
    "domain": {
      "description": "The company's domain, e.g. acme.com (more exact than the name)",
      "type": "string"
    },
    "linkedin_url": {
      "description": "The person's LinkedIn profile URL",
      "type": "string"
    },
    "email": {
      "description": "A WORK e-mail (not Gmail etc.)",
      "type": "string"
    },
    "query": {
      "description": "A question in plain words, e.g. \"CFO of Tink in Berlin\"",
      "type": "string"
    },
    "eu_only": {
      "description": "Only services in the EU (skips one US web index)",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒check_records(records, categories, ai, language)

FREE (up to 25 records without a key, 1000 with one) β€” Use when your user has contact or company records (a CSV, a CRM export, pasted rows) and wants to know what is wrong with them. check contact records for errors with 100+ checks: typos in e-mail domains, role mailboxes (office@), duplicates and near-duplicates, phone codes that do not fit the country, LinkedIn status text in names, placeholders … Returns findings per record with proposed fixes. Nothing is stored or changed.

Input Schema

{
  "type": "object",
  "properties": {
    "records": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      },
      "description": "Records as JSON objects. Any key names (e.g. first_name, last_name, email, company_name, domain, linkedin_profile_url, job_title, phone, country, city β€” or Vorname, Firma, Mail …); the answer says how each key was read."
    },
    "categories": {
      "description": "Only these areas (any other value is an error)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "name",
          "email",
          "company",
          "linkedin",
          "job_title",
          "phone",
          "address",
          "gender",
          "duplicates",
          "completeness",
          "cross_field",
          "compliance",
          "campaign"
        ]
      }
    },
    "ai": {
      "description": "Also run the AI checks (fake names, a person's name as company, department instead of job title, city vs country) β€” PAID by use, needs a key; never above the `max` this check names in its `options` when called without `ai` (call it so first)",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "records"
  ],
  "additionalProperties": false
}
🟑enrich_records(records, list_id, record_ids, fields, max_credits, ...)

PAID (needs a key) β€” Use when records miss a work e-mail, a mobile number, a job title, a LinkedIn profile or company data. per record from a name + company: work e-mail β‰ˆ2.39, at most 9 credits; mobile β‰ˆ3.84, at most 12; job title β‰ˆ1.41, at most 13.5. Charged per hit for e-mail and phone. Use estimate:true first for the exact price of YOUR records (free, no key). Fills fields of contact records (work e-mail, mobile, job title, LinkedIn profile, company, domain, industry, size, place). Send records for a direct result without creating a list, or list_id and record_ids to update shared rows in place. Waits up to 25 s and returns a job_id to poll (get_job) for longer lookups.

Input Schema

{
  "type": "object",
  "properties": {
    "records": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      },
      "description": "Records as JSON objects. Any key names (e.g. first_name, last_name, email, company_name, domain, linkedin_profile_url, job_title, phone, country, city β€” or Vorname, Firma, Mail …); the answer says how each key was read."
    },
    "list_id": {
      "description": "Enrich rows of this list in place instead of sending records (e.g. the list a search_people answer named)",
      "type": "string"
    },
    "record_ids": {
      "description": "With list_id: the rows' ids (`id` in a search answer)",
      "minItems": 1,
      "maxItems": 5000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fields": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to fill: email, phone, job_title, linkedin_profile_url, company_name, domain, industry, city, country"
    },
    "max_credits": {
      "description": "The most this call may cost (default: the key's day budget left)",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "estimate": {
      "description": "true = only the price for these records, nothing runs (free, no key needed)",
      "type": "boolean"
    },
    "request_id": {
      "description": "Your id for this call β€” a repeat with it gets the same job",
      "type": "string"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "fields"
  ],
  "additionalProperties": false
}
🟒get_job(job_id, language)

FREE (key) β€” Use after enrich_records answered with a job_id, to fetch the result. the state of an enrich_records job; when it ended, the records with the fields we found (in the order you sent them).

Input Schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job_id an enrich_records answer handed out"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}
βšͺverify_email(emails, language)

PAID (needs a key) β€” Use when your user wants to know whether e-mail addresses can receive mail before writing to them. 0.3 credits per address (an address checked in the last 7 days costs nothing), so a call costs at most its addresses Γ— that β€” a fixed price, no estimate: is the e-mail address deliverable (valid, invalid, catch_all, unknown)? Up to 25 addresses per call, answered at once.

Input Schema

{
  "type": "object",
  "properties": {
    "emails": {
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "E-mail addresses to verify (up to 25)"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false
}
🟒search_options(for, category, query, parent, country, ...)

FREE β€” Use before search_people, count_companies or load_companies, to get the exact filter values. the filters search_people, count_companies and load_companies accept, and the exact values they take (seniorities, departments, company size, industries, countries, states, NAICS codes, revenue …). Without arguments: the categories; with `category`: its values; with `query`: look a word up ("saas", "apparel"). Copy values exactly.

Input Schema

{
  "type": "object",
  "properties": {
    "for": {
      "description": "people = search_people; companies = count_companies / load_companies",
      "type": "string",
      "enum": [
        "people",
        "companies"
      ]
    },
    "category": {
      "description": "One category's values, e.g. seniorities, industries, countries, states, naics, employees, revenue (the list: call without arguments)",
      "type": "string"
    },
    "query": {
      "description": "Look a word up in the category, e.g. \"saas\", \"apparel\", a NAICS code start",
      "type": "string"
    },
    "parent": {
      "description": "naics: the code whose children to list (empty = the sectors)",
      "type": "string"
    },
    "country": {
      "description": "states: the ISO country",
      "type": "string"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒count_companies(filters, by, language)

FREE β€” Use when your user asks how big a market is or how many companies fit a description. how many companies match (market size), e.g. { filters: { countries: ["IT"], naics: ["315"] } }; with `by` (needs a key) broken down by one dimension (countries, states, industries, naics, employees, revenue …). Exact values from search_options (for: companies). Loading the companies into a list is load_companies (priced in `options`).

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "type": "object",
      "properties": {
        "regions": {
          "description": "World regions (ids)",
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "countries": {
          "description": "Countries as ISO codes, e.g. US, DE",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "states": {
          "description": "States / regions of ONE country (ids; needs exactly one country)",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "industries": {
          "description": "Industries: \"Wider\" or \"Wider/Part\" names",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "naics": {
          "description": "NAICS 2022 codes, any level (2–6 digits)",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "employees": {
          "description": "Head count classes (estimated), e.g. 51-200",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "reported_employees": {
          "description": "Head count classes as the company reports them",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "revenue": {
          "description": "Annual revenue classes (USD), e.g. 10m-50m",
          "maxItems": 7,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "company_types": {
          "description": "Company types, e.g. private, public, nonprofit",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "categories": {
          "description": "Business models, e.g. b2b, saas, e-commerce",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "growth": {
          "description": "Head count change over 12 months (one value: shrinking, stable, growing, fast)",
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "departments": {
          "description": "Has a team of at least 5 in each of these departments",
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "exclude": {
          "description": "Values a company must NOT have β€” the same keys as the pick filters above",
          "type": "object",
          "properties": {
            "regions": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "countries": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "states": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "industries": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "naics": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "employees": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "reported_employees": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "revenue": {
              "maxItems": 7,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "company_types": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "categories": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        },
        "keywords": {
          "description": "Words describing what the company does (free text); all must fit unless keywords_any",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "keywords_any": {
          "description": "true = any of the keywords is enough",
          "type": "boolean"
        },
        "technologies": {
          "description": "Technologies on the company's website, e.g. Shopify, HubSpot; all must fit unless technologies_any",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "technologies_any": {
          "description": "true = any of the technologies is enough",
          "type": "boolean"
        },
        "name_contains": {
          "description": "Part of the company's name or domain",
          "type": "string"
        },
        "founded_min": {
          "description": "Founded in or after this year",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "founded_max": {
          "description": "Founded in or before this year",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "team": {
          "description": "A department's head count between min and max",
          "type": "object",
          "properties": {
            "department": {
              "type": "string",
              "description": "search_options category team_departments (\"overall\" = the whole company)"
            },
            "min": {
              "description": "At least this many people in it",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max": {
              "description": "At most this many people in it",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "department"
          ],
          "additionalProperties": false
        },
        "team_growth": {
          "description": "A department that grows",
          "type": "object",
          "properties": {
            "department": {
              "type": "string",
              "description": "search_options category team_departments (\"overall\" = the whole company)"
            },
            "months": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 6
                },
                {
                  "type": "number",
                  "const": 12
                },
                {
                  "type": "number",
                  "const": 24
                }
              ],
              "description": "Over 6, 12 or 24 months"
            },
            "min_percent": {
              "type": "number",
              "description": "Grew by at least this many percent (negative = shrank at most)"
            }
          },
          "required": [
            "department",
            "months",
            "min_percent"
          ],
          "additionalProperties": false
        }
      },
      "additionalProperties": false,
      "description": "Company filters. Copy the exact values of each from search_options { for: \"companies\", category: \"<the filter's name>\" }"
    },
    "by": {
      "description": "One dimension to break the total down by: regions, countries, states, industries, sub_industries, naics, employees, reported_employees, revenue, company_types, categories, growth, departments",
      "type": "string"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "filters"
  ],
  "additionalProperties": false
}
🟒search_people(job_titles, exact_titles, seniorities, departments, locations, ...)

PAID (needs a key) β€” Use when your user wants new leads: people by role, seniority, industry, place or company. 2 credits per page of up to 25 people, only for pages the database counts (a repeat within 30 days and an empty result cost nothing). Finds people in the B2B contact database by job title, seniority, department, place, industry, company size or company. The people go into a list in ListPlus (name, job title, company, domain, LinkedIn, place β€” no e-mail or phone: those are enrich_records, priced in `options`). Up to 4 pages per call, a cursor for the next ones (20 pages deep). Exact values from search_options; estimate:true shows the filters as understood and the price (free, no key).

Input Schema

{
  "type": "object",
  "properties": {
    "job_titles": {
      "description": "Matched as CONTAINS unless exact_titles",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exact_titles": {
      "description": "true = job titles match exactly, not as \"contains\"",
      "type": "boolean"
    },
    "seniorities": {
      "description": "Seniorities, e.g. Director, VP, C-Suite β€” values: search_options category seniorities",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "departments": {
      "description": "Departments, e.g. Marketing, Sales β€” values: search_options category departments",
      "maxItems": 14,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "locations": {
      "description": "Where the PERSON is: cities, countries, territories (DACH, EMEA)",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industries": {
      "description": "The company's industries; everyday words like saas or fintech are understood β€” values: search_options category industries",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "headcount": {
      "description": "The company's size class, e.g. 51-100 β€” values: search_options category headcount",
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "companies": {
      "description": "Company names",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "company_domains": {
      "description": "Company domains, e.g. acme.com (more exact than names)",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "keywords": {
      "description": "Words in the person's profile",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "has_email": {
      "description": "Only people the database holds a verified work e-mail for",
      "type": "boolean"
    },
    "has_mobile": {
      "description": "Only people the database holds a verified mobile number for",
      "type": "boolean"
    },
    "pages": {
      "description": "Pages of up to 25 to load in this call (default 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "cursor": {
      "description": "From the last answer: the next pages of the same search into the same list",
      "type": "string"
    },
    "list_id": {
      "description": "Append to this list of the workspace (default: a new list per search)",
      "type": "string"
    },
    "list_name": {
      "description": "The new list's name",
      "type": "string"
    },
    "max_credits": {
      "description": "The most this call may cost; it loads fewer pages / refuses rather than spend more",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "estimate": {
      "description": "true = the filters as understood and the price, nothing runs (free, no key)",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒load_companies(filters, limit, cursor, list_id, list_name, ...)

PAID (needs a key) β€” Use when your user wants the companies of a market as a list, after count_companies sized it. 0.25 credits per company delivered (25 companies = 6.25 credits): the companies a count_companies question found, into a company list in ListPlus β€” name, domain, website, industry, size, place, LinkedIn page. 10, 25, 50 per call (`limit`), a cursor for the next ones. The same page within an hour costs nothing again. estimate:true shows the price (free, no key).

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "type": "object",
      "properties": {
        "regions": {
          "description": "World regions (ids)",
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "countries": {
          "description": "Countries as ISO codes, e.g. US, DE",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "states": {
          "description": "States / regions of ONE country (ids; needs exactly one country)",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "industries": {
          "description": "Industries: \"Wider\" or \"Wider/Part\" names",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "naics": {
          "description": "NAICS 2022 codes, any level (2–6 digits)",
          "maxItems": 60,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "employees": {
          "description": "Head count classes (estimated), e.g. 51-200",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "reported_employees": {
          "description": "Head count classes as the company reports them",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "revenue": {
          "description": "Annual revenue classes (USD), e.g. 10m-50m",
          "maxItems": 7,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "company_types": {
          "description": "Company types, e.g. private, public, nonprofit",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "categories": {
          "description": "Business models, e.g. b2b, saas, e-commerce",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "growth": {
          "description": "Head count change over 12 months (one value: shrinking, stable, growing, fast)",
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "departments": {
          "description": "Has a team of at least 5 in each of these departments",
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "exclude": {
          "description": "Values a company must NOT have β€” the same keys as the pick filters above",
          "type": "object",
          "properties": {
            "regions": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "countries": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "states": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "industries": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "naics": {
              "maxItems": 60,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "employees": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "reported_employees": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "revenue": {
              "maxItems": 7,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "company_types": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "categories": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        },
        "keywords": {
          "description": "Words describing what the company does (free text); all must fit unless keywords_any",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "keywords_any": {
          "description": "true = any of the keywords is enough",
          "type": "boolean"
        },
        "technologies": {
          "description": "Technologies on the company's website, e.g. Shopify, HubSpot; all must fit unless technologies_any",
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "technologies_any": {
          "description": "true = any of the technologies is enough",
          "type": "boolean"
        },
        "name_contains": {
          "description": "Part of the company's name or domain",
          "type": "string"
        },
        "founded_min": {
          "description": "Founded in or after this year",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "founded_max": {
          "description": "Founded in or before this year",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "team": {
          "description": "A department's head count between min and max",
          "type": "object",
          "properties": {
            "department": {
              "type": "string",
              "description": "search_options category team_departments (\"overall\" = the whole company)"
            },
            "min": {
              "description": "At least this many people in it",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max": {
              "description": "At most this many people in it",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "department"
          ],
          "additionalProperties": false
        },
        "team_growth": {
          "description": "A department that grows",
          "type": "object",
          "properties": {
            "department": {
              "type": "string",
              "description": "search_options category team_departments (\"overall\" = the whole company)"
            },
            "months": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 6
                },
                {
                  "type": "number",
                  "const": 12
                },
                {
                  "type": "number",
                  "const": 24
                }
              ],
              "description": "Over 6, 12 or 24 months"
            },
            "min_percent": {
              "type": "number",
              "description": "Grew by at least this many percent (negative = shrank at most)"
            }
          },
          "required": [
            "department",
            "months",
            "min_percent"
          ],
          "additionalProperties": false
        }
      },
      "additionalProperties": false,
      "description": "Company filters. Copy the exact values of each from search_options { for: \"companies\", category: \"<the filter's name>\" }"
    },
    "limit": {
      "description": "Companies in this call: 10, 25, 50 (default 25)",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cursor": {
      "description": "From the last answer: the next companies into the same list",
      "type": "string"
    },
    "list_id": {
      "description": "Append to this list of the workspace (default: a new list per search)",
      "type": "string"
    },
    "list_name": {
      "description": "The new list's name",
      "type": "string"
    },
    "max_credits": {
      "description": "The most this call may cost; it loads fewer pages / refuses rather than spend more",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "estimate": {
      "description": "true = the filters as understood and the price, nothing runs (free, no key)",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒describe_list(list_id, language)

FREE (key) β€” Use first whenever your user refers to one of their ListPlus lists: it names the lists you may work on and what you may do there. without list_id: the lists shared with you (name, kind, rows, what you may do). With list_id: its columns (content types, allowed values, which you may write), statuses, the sublists you are limited to, the pipelines you may hand records to, the filter conditions, and the tools this list allows. Call it before working on a list.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟒query_records(list_id, filter, logic, columns, limit, ...)

FREE (key) β€” Use to read, filter or count the records of a ListPlus list. read records of a list shared with you: `mode` rows (default; columns you may see, each with id and url), count, or ids (up to 10,000, to pass on as record_ids). Filter by column values or conditions (describe_list names them).

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "logic": {
      "description": "How several filter entries combine (default and)",
      "type": "string",
      "enum": [
        "and",
        "or"
      ]
    },
    "columns": {
      "description": "Only these columns in the rows",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Rows per call (capped by the list's share, default 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many rows (paging)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "include_hidden": {
      "description": "Also records hidden in the list (status \"ignored\")",
      "type": "boolean"
    },
    "mode": {
      "description": "rows (default), count, or ids",
      "type": "string",
      "enum": [
        "rows",
        "count",
        "ids"
      ]
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id"
  ],
  "additionalProperties": false
}
🟑add_records(list_id, records, language)

FREE (key) β€” Use when your user wants records kept in a ListPlus list. add records (JSON objects, column names or common field names) to a list shared with you for editing. A record the list already has (same e-mail, LinkedIn, name + company) is filled in, not doubled. Up to 1,000 per call; the answer names each new record's id and url and what was rejected.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "records": {
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      },
      "description": "The records as JSON objects"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "records"
  ],
  "additionalProperties": false
}
πŸ”΄update_records(list_id, records, record_ids, filter, set, ...)

FREE (key) β€” Use when values in a ListPlus list should change. change cells of a list shared with you for editing: per record (`records: [{ id, column: value }]`) or one change for many (`record_ids` or `filter` + `set`). Only the columns you may write (describe_list); `only_empty` fills empty cells only.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "records": {
      "description": "Per record: { id, <column>: <value>, … }",
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      }
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "set": {
      "description": "With record_ids or filter: column β†’ new value",
      "type": "object",
      "additionalProperties": {}
    },
    "only_empty": {
      "description": "Fill empty cells only",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id"
  ],
  "additionalProperties": false
}
πŸ”΄mark_records(list_id, record_ids, filter, status, add_tags, ...)

FREE (key) β€” Use to qualify, tag or put aside records of a ListPlus list (status, tags, hide). set a status (one of the list's, "" clears it β€” may start the list's rules, as in the app), add or remove tags, or hide records (restorable; hide: false shows them again) in a list shared with you for editing. Nothing is deleted.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "status": {
      "description": "A status name of the list (describe_list), or \"\" to clear",
      "type": "string"
    },
    "add_tags": {
      "description": "Tags to add",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "remove_tags": {
      "description": "Tags to remove",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "hide": {
      "description": "true = hide in the list (restorable), false = show again",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id"
  ],
  "additionalProperties": false
}
🟒check_list(list_id, record_ids, categories, language)

FREE (key) β€” Use when your user asks about the data quality of a ListPlus list. run the 100+ data-quality checks on a list shared with you (or on some of its records): a score, the findings per check with the affected record ids and a proposed fix each (fix_list applies one).

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "categories": {
      "description": "Only these areas (any other value is an error)",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "name",
          "email",
          "company",
          "linkedin",
          "job_title",
          "phone",
          "address",
          "gender",
          "duplicates",
          "completeness",
          "cross_field",
          "compliance"
        ]
      }
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id"
  ],
  "additionalProperties": false
}
πŸ”΄fix_list(list_id, check_id, clean_values, dedup_key, record_ids, ...)

FREE (key) β€” Use after check_list, once your user agreed to apply fixes, clean values or merge duplicates. apply ONE of: a check's proposed fixes (`check_id` from check_list), cleaning values (trim, casing, placeholders β€” `clean_values: true`), or merging duplicates (`dedup_key`: email, name_company, linkedin, phone, name β€” merged rows are hidden, not deleted). Needs editing on the list.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "check_id": {
      "description": "A check's id from check_list",
      "type": "string"
    },
    "clean_values": {
      "description": "true = clean values of the given columns / all",
      "type": "boolean"
    },
    "dedup_key": {
      "description": "Merge duplicates found by this key",
      "type": "string",
      "enum": [
        "email",
        "name_company",
        "linkedin",
        "phone",
        "name"
      ]
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "columns": {
      "description": "clean_values: only these columns",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id"
  ],
  "additionalProperties": false
}
βšͺderive_column(list_id, source_columns, target_column, description, only_empty, ...)

PAID (needs a key) β€” Use when a column should be filled by AI from other columns (the gender from the first name, a seniority from the job title). AI tokens by use (usually cents; at most 10 credits per call, within the key's day budget): fill an existing column from others by an instruction (e.g. the gender from the first name, a seniority from the job title, a country from the city). Unique values are asked once.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "source_columns": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The columns to read"
    },
    "target_column": {
      "type": "string",
      "description": "The (existing) column to fill"
    },
    "description": {
      "type": "string",
      "description": "What to put in, e.g. \"male, female or unknown from the first name\""
    },
    "only_empty": {
      "description": "Fill empty cells only (default true)",
      "type": "boolean"
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "source_columns",
    "target_column",
    "description"
  ],
  "additionalProperties": false
}
πŸ”΄copy_records(from_list_id, to_list_id, record_ids, filter, move, ...)

FREE (key) β€” Use to copy or move records between two ListPlus lists. copy records from one list shared with you into another (same kind: contacts or companies) β€” with `move: true` they are then hidden in the source (restorable, never deleted). A record the target already has is filled in, not doubled; a copy never goes back into a list it came through. Up to 1,000 per call.

Input Schema

{
  "type": "object",
  "properties": {
    "from_list_id": {
      "type": "string",
      "description": "The list to copy from"
    },
    "to_list_id": {
      "type": "string",
      "description": "The list to copy into"
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "move": {
      "description": "true = hide the records in the source after the copy",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "from_list_id",
    "to_list_id"
  ],
  "additionalProperties": false
}
🟑send_to_pipeline(list_id, pipeline, record_ids, filter, language)

FREE (key) to hand over β€” Use when records should go to the CRM, a sequencer or Slack through one of the workspace's pipelines. records of a list shared with you go to one of the workspace's pipelines you may use (describe_list names them: HubSpot, Slack, lemlist …). The pipeline's data check and release apply: a manual one waits for a person; one that sends by itself delivers at once and is PAID per record delivered β€” describe_list names each pipeline's `credits_per_record`; it counts on this key's day budget. Tell your user records Γ— that price first. Up to 500 per call.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list without list_id shows the lists shared with you)"
    },
    "pipeline": {
      "type": "string",
      "description": "The pipeline's id or name (describe_list)"
    },
    "record_ids": {
      "description": "The records' ids (`id` in query_records)",
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filter": {
      "description": "Column β†’ value: exact, { \"contains\": \"…\" }, { \"not\": \"…\" }, { \"is_empty\": true } or { \"condition\": \"<one of filter_conditions>\" }; ar_status by status name",
      "type": "object",
      "additionalProperties": {}
    },
    "language": {
      "description": "Language of `tell_your_user` (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "pipeline"
  ],
  "additionalProperties": false
}
🟒describe_setup(list_id, language)

FREE (key, Set up) β€” Use before you build or change a list's columns or rules. what you need before you set something up. Without list_id: whether this connection may set up, the column kinds and the limits. With list_id: the list's columns (kinds), statuses, rules (triggers), the fields a condition may use with their operators, the pipelines you may hand records to, and the HubSpot accounts. Call it before add_column or create_trigger.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list shows the lists shared with you)"
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "additionalProperties": false
}
🟑create_list(name, description, kind, columns, statuses, ...)

FREE (key, Set up) β€” Use when your user wants a new list in their workspace. a new list in the workspace (contacts or companies), with the standard columns or the content types you name, and optional statuses. It is this agent's own list: shared in Full. Then add_column, create_trigger, add_records.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "kind": {
      "description": "Default contacts",
      "type": "string",
      "enum": [
        "contacts",
        "companies"
      ]
    },
    "columns": {
      "description": "Content types (first_name, email, company_name, company_domain, job_title, linkedin_profile_url …); absent = the standard columns",
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "statuses": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "done": {
            "type": "boolean"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": false
      }
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
🟑add_column(list_id, columns, language)

FREE (key, Set up) to set up β€” Use when a list needs a new column: a score, a label, a lookup, a formula or an AI column. plain, select, formula, rule-based score / label, lookup, in_list and job_change columns cost nothing (Edit on the list). A hubspot column asks the workspace's HubSpot and is PAID: 1 credit per request of up to 100 different values, for the first run and for records that come later. AI criteria in a score and ai_text columns are PAID: 0.02 credits per AI answer (unique values once), Full on the list; their first run costs at most the list's records Γ— that and counts on this connection's day budget, later records run under the list's own day limit. Tell your user the price before you add a paid column. Up to 10 columns per call; call describe_setup first for the fields a rule may use.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list shows the lists shared with you)"
    },
    "columns": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "plain"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "string",
                  "number",
                  "date"
                ]
              },
              "content_type": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "title"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "select"
              },
              "title": {
                "type": "string"
              },
              "options": {
                "minItems": 1,
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "kind",
              "title",
              "options"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "formula"
              },
              "title": {
                "type": "string"
              },
              "formula": {
                "type": "string",
                "description": "The app's formula language; columns as {Column title}"
              }
            },
            "required": [
              "kind",
              "title",
              "formula"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "score"
              },
              "title": {
                "type": "string"
              },
              "criteria": {
                "minItems": 1,
                "maxItems": 20,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "points": {
                      "type": "integer",
                      "minimum": -1000,
                      "maximum": 1000
                    },
                    "when": {
                      "description": "The rule (columns, content types, reference lists, job change)",
                      "type": "object",
                      "properties": {
                        "groups": {
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "maxItems": 12,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "field": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "kind"
                                  ],
                                  "additionalProperties": {},
                                  "description": "A field exactly as describe_setup names it, e.g. { \"kind\": \"contentType\", \"key\": \"job_title\" }, { \"kind\": \"column\", \"name\": \"score\" }, { \"kind\": \"status\" }, { \"kind\": \"tags\" }"
                                },
                                "op": {
                                  "type": "string",
                                  "description": "An operator describe_setup offers for that field"
                                },
                                "values": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              },
                              "required": [
                                "field",
                                "op"
                              ],
                              "additionalProperties": false
                            }
                          }
                        }
                      },
                      "required": [
                        "groups"
                      ],
                      "additionalProperties": false
                    },
                    "ai": {
                      "description": "…or a statement the AI judges per record (paid, Full)",
                      "type": "object",
                      "properties": {
                        "statement": {
                          "type": "string"
                        },
                        "inputs": {
                          "minItems": 1,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Column names the AI reads"
                        }
                      },
                      "required": [
                        "statement",
                        "inputs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "label",
                    "points"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "kind",
              "title",
              "criteria"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "label"
              },
              "title": {
                "type": "string"
              },
              "values": {
                "minItems": 1,
                "maxItems": 10,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string"
                    },
                    "when": {
                      "description": "Absent = every other record",
                      "type": "object",
                      "properties": {
                        "groups": {
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "maxItems": 12,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "field": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "kind"
                                  ],
                                  "additionalProperties": {},
                                  "description": "A field exactly as describe_setup names it, e.g. { \"kind\": \"contentType\", \"key\": \"job_title\" }, { \"kind\": \"column\", \"name\": \"score\" }, { \"kind\": \"status\" }, { \"kind\": \"tags\" }"
                                },
                                "op": {
                                  "type": "string",
                                  "description": "An operator describe_setup offers for that field"
                                },
                                "values": {
                                  "maxItems": 100,
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              },
                              "required": [
                                "field",
                                "op"
                              ],
                              "additionalProperties": false
                            }
                          }
                        }
                      },
                      "required": [
                        "groups"
                      ],
                      "additionalProperties": false
                    },
                    "color": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "value"
                  ],
                  "additionalProperties": false
                },
                "description": "The first value whose rule is met wins"
              }
            },
            "required": [
              "kind",
              "title",
              "values"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "lookup"
              },
              "title": {
                "type": "string"
              },
              "from_list_id": {
                "type": "string",
                "description": "The list's id (describe_list shows the lists shared with you)"
              },
              "by": {
                "type": "string",
                "enum": [
                  "domain",
                  "email",
                  "linkedin"
                ]
              },
              "column": {
                "description": "The other list's column (absent with count)",
                "type": "string"
              },
              "count": {
                "type": "boolean",
                "const": true
              }
            },
            "required": [
              "kind",
              "title",
              "from_list_id",
              "by"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "in_list"
              },
              "title": {
                "type": "string"
              },
              "reference_list_id": {
                "type": "string",
                "description": "Another list of the workspace"
              }
            },
            "required": [
              "kind",
              "title",
              "reference_list_id"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "hubspot"
              },
              "title": {
                "type": "string"
              },
              "object": {
                "type": "string",
                "enum": [
                  "contacts",
                  "companies"
                ]
              },
              "account_id": {
                "type": "string",
                "description": "A HubSpot account of the workspace (describe_setup)"
              }
            },
            "required": [
              "kind",
              "title",
              "object",
              "account_id"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "job_change"
              },
              "title": {
                "type": "string"
              },
              "with_hints": {
                "description": "A third value \"Check\" for weaker signs",
                "type": "boolean"
              }
            },
            "required": [
              "kind",
              "title"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "ai_text"
              },
              "title": {
                "type": "string"
              },
              "prompt": {
                "type": "string",
                "description": "What the AI writes per record; columns as {Column title}"
              }
            },
            "required": [
              "kind",
              "title",
              "prompt"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "columns"
  ],
  "additionalProperties": false
}
πŸ”΄remove_column(list_id, column, language)

FREE (key, Set up, Full on the list) β€” Use when a column should go from a list. remove a column from a list (by name or title). Records are never deleted; ask your user before you remove a column a person made.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list shows the lists shared with you)"
    },
    "column": {
      "type": "string",
      "description": "The column's name or title"
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "column"
  ],
  "additionalProperties": false
}
🟑create_trigger(list_id, name, on, conditions, actions, ...)

FREE (key, Set up) to set up β€” Use when something should happen by itself whenever a record arrives, changes or meets a condition. a rule (trigger) of a list: when a record is new / changed / meets the conditions, set a status (a new name is created), add a tag, hide it (it leaves the normal flow: no checks, rules, enrichment or sync β€” restorable), hand it to an EXISTING pipeline (pipelines are made by a person in the app), or ENRICH it β€” PAID per hit, at most budget_per_record credits per record, on THIS connection's day budget (an empty day makes the rule wait, never overspend). Active at once unless activate: false β€” set an enrich rule up paused until your user agreed to the budget. include_existing runs it once for the records already in the list. Status, tag and hide need Edit on the list; a pipeline the pipeline's share; enrich Full. Call describe_setup first for the fields and operators.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list shows the lists shared with you)"
    },
    "name": {
      "type": "string"
    },
    "on": {
      "type": "string",
      "enum": [
        "new",
        "changed",
        "match"
      ],
      "description": "new: new records Β· changed: changed ones Β· match: new or changed, once they meet the conditions"
    },
    "conditions": {
      "type": "object",
      "properties": {
        "groups": {
          "maxItems": 5,
          "type": "array",
          "items": {
            "maxItems": 12,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind"
                  ],
                  "additionalProperties": {},
                  "description": "A field exactly as describe_setup names it, e.g. { \"kind\": \"contentType\", \"key\": \"job_title\" }, { \"kind\": \"column\", \"name\": \"score\" }, { \"kind\": \"status\" }, { \"kind\": \"tags\" }"
                },
                "op": {
                  "type": "string",
                  "description": "An operator describe_setup offers for that field"
                },
                "values": {
                  "maxItems": 100,
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "field",
                "op"
              ],
              "additionalProperties": false
            }
          }
        }
      },
      "required": [
        "groups"
      ],
      "additionalProperties": false,
      "description": "Groups are OR-ed, the conditions inside a group AND-ed: { groups: [[cond, cond], [cond]] }"
    },
    "actions": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "status"
              },
              "status": {
                "type": "string",
                "description": "A status NAME; a new one is created. \"hidden\" hides the record"
              }
            },
            "required": [
              "kind",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "tag"
              },
              "tag": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "tag"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "hide"
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "pipeline"
              },
              "pipeline": {
                "type": "string",
                "description": "An EXISTING pipeline's id or name (describe_setup)"
              }
            },
            "required": [
              "kind",
              "pipeline"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "enrich"
              },
              "fields": {
                "minItems": 1,
                "maxItems": 8,
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Fields to fill: email, phone, job_title, linkedin_profile_url, company_name, domain, industry, city, country"
              },
              "budget_per_record": {
                "description": "The most credits per record (default 10)",
                "type": "string",
                "enum": [
                  "5",
                  "10",
                  "25",
                  "50"
                ]
              },
              "fill": {
                "description": "empty_only (default), empty_or_invalid, replace_all",
                "type": "string",
                "enum": [
                  "empty_only",
                  "empty_or_invalid",
                  "replace_all"
                ]
              }
            },
            "required": [
              "kind",
              "fields"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "activate": {
      "description": "Default true",
      "type": "boolean"
    },
    "include_existing": {
      "description": "Also run once for the records already in the list",
      "type": "boolean"
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "name",
    "on",
    "actions"
  ],
  "additionalProperties": false
}
πŸ”΄update_trigger(list_id, trigger_id, status, name, on, ...)

FREE (key, Set up) β€” Use to pause, change or remove a rule of a list. pause, activate, change or remove (remove: true) a rule of a list. Your own rules with the rights of their actions; a rule a person or another connection set up only with the list shared in Full β€” ask your user first. `actions` replaces the rule's actions (an enrich action named again keeps its settings' place; one left out goes). Enrichment only on your own rules.

Input Schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list's id (describe_list shows the lists shared with you)"
    },
    "trigger_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused"
      ]
    },
    "name": {
      "type": "string"
    },
    "on": {
      "type": "string",
      "enum": [
        "new",
        "changed",
        "match"
      ]
    },
    "conditions": {
      "type": "object",
      "properties": {
        "groups": {
          "maxItems": 5,
          "type": "array",
          "items": {
            "maxItems": 12,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind"
                  ],
                  "additionalProperties": {},
                  "description": "A field exactly as describe_setup names it, e.g. { \"kind\": \"contentType\", \"key\": \"job_title\" }, { \"kind\": \"column\", \"name\": \"score\" }, { \"kind\": \"status\" }, { \"kind\": \"tags\" }"
                },
                "op": {
                  "type": "string",
                  "description": "An operator describe_setup offers for that field"
                },
                "values": {
                  "maxItems": 100,
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "field",
                "op"
              ],
              "additionalProperties": false
            }
          }
        }
      },
      "required": [
        "groups"
      ],
      "additionalProperties": false,
      "description": "Groups are OR-ed, the conditions inside a group AND-ed: { groups: [[cond, cond], [cond]] }"
    },
    "actions": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "status"
              },
              "status": {
                "type": "string",
                "description": "A status NAME; a new one is created. \"hidden\" hides the record"
              }
            },
            "required": [
              "kind",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "tag"
              },
              "tag": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "tag"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "hide"
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "pipeline"
              },
              "pipeline": {
                "type": "string",
                "description": "An EXISTING pipeline's id or name (describe_setup)"
              }
            },
            "required": [
              "kind",
              "pipeline"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "enrich"
              },
              "fields": {
                "minItems": 1,
                "maxItems": 8,
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Fields to fill: email, phone, job_title, linkedin_profile_url, company_name, domain, industry, city, country"
              },
              "budget_per_record": {
                "description": "The most credits per record (default 10)",
                "type": "string",
                "enum": [
                  "5",
                  "10",
                  "25",
                  "50"
                ]
              },
              "fill": {
                "description": "empty_only (default), empty_or_invalid, replace_all",
                "type": "string",
                "enum": [
                  "empty_only",
                  "empty_or_invalid",
                  "replace_all"
                ]
              }
            },
            "required": [
              "kind",
              "fields"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "include_existing": {
      "type": "boolean"
    },
    "remove": {
      "type": "boolean",
      "const": true
    },
    "language": {
      "description": "Language of `tell_your_user` and of Yes/No words in new columns (default en)",
      "type": "string",
      "enum": [
        "en",
        "de"
      ]
    }
  },
  "required": [
    "list_id",
    "trigger_id"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded26 tools