Tool

add_contacts

Bulk-add contacts

Idempotent

SurfacesChat agentMCP

Add many contacts in ONE batch (e.g. results of a research task). FLOW: find companies/people via web_search, THEN call add_contacts with each row's `sourceUrl` + `confidence` (the research provenance) and any `labels`. Returns a batch summary you can later filter the directory by. Auto-commits.

Parameters

Name	Type	Required	Description
`contacts`	object[]	yes	The contacts to add.
▸expand contacts array items — object `email` stringrequired The contact's email. ▸`name` one of option 1string option 2null `attribs` object Arbitrary structured attributes. `labels` string[] Per-row label names. ▸`sourceUrl` one of Where this row came from (web-research URL). option 1string option 2null `confidence` integer 0–100 confidence in the row.
`defaultLabels`	string[]	no	Labels applied to EVERY contact in the batch.
`query`	one of	no	The prompt/criteria that produced this batch (e.g. 'YC fintech companies').
▸expand query option 1string option 2null

Example

json

{
  "contacts": [
    {
      "email": "ada@example.com"
    }
  ]
}