Search companies
Companies that match a search term, with their ID, status and main contact details.
MCP tool teamleader_read → search_companies
read
Searches companies by name, VAT number, email or phone number. Returns one page of companies, 20 by default. The company ID from here is what list_deals and list_invoices take as customer_id. Deactivated companies are only returned if you ask for them.
Parameters
| Name | Type | Description |
|---|---|---|
| term string required | string | Name, VAT number, email or phone number to search for. |
| status enum | enum | active or deactivated. Default: active. |
| page integer | integer | Page number, starting at 1. Default: 1. |
| page_size integer | integer | Items per page. Default: 20. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "teamleader_read",
"arguments": {
"operation": "search_companies",
"arguments": {
"term": "term"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"companies": [
{
"company_id": "c4a7e2d1-5b36-4f08-a9c3-7e1d2f4b6a80",
"name": "Northwind Studio",
"vat_number": "BE0123456749",
"email": "accounts@northwind.example",
"status": "active"
}
],
"page": 1,
"total_matches": 1
},
"isError": false
}