Groundbase

contacts_list

Read-onlyIdempotent

Search and filter contacts (tag, company, unsubscribed, sort), or id for one in full (tags, addresses, custom fields, recent activity). deleted: the recently deleted ones (to restore). duplicates: groups sharing an email or phone (to merge).

Input Schema

TableJSON Schema

Name	Required	Description
`id`	No	Contact id. Returns that one contact; other filters ignored.
`tag`	No	Only contacts with this tag (name or id).
`sort`	No	recent = last contacted. Default name.
`limit`	No	Default 50.
`offset`	No
`search`	No	Matches name, email, phone.
`deleted`	No	List recently deleted contacts instead.
`companyId`	No	Only contacts at this company.
`duplicates`	No	List groups of live contacts sharing an email or phone instead.
`unsubscribed`	No	Opted out of any channel / email / texts, or none (for an audience).

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 9, 2026

addedInput schema / properties / companyId

Added value: +{
+  "description": "Only contacts at this company.",
+  "type": "string"
+}

addedInput schema / properties / deleted

Added value: +{
+  "description": "List recently deleted contacts instead.",
+  "type": "boolean"
+}

addedInput schema / properties / duplicates

Added value: +{
+  "description": "List groups of live contacts sharing an email or phone instead.",
+  "type": "boolean"
+}

addedInput schema / properties / sort

Added value: +{
+  "description": "recent = last contacted. Default name.",
+  "enum": [
+    "name",
+    "created",
+    "updated",
+    "recent"
+  ],
+  "type": "string"
+}

addedInput schema / properties / tag

Added value: +{
+  "description": "Only contacts with this tag (name or id).",
+  "type": "string"
+}

addedInput schema / properties / unsubscribed

Added value: +{
+  "description": "Opted out of any channel / email / texts, or none (for an audience).",
+  "enum": [
+    "any",
+    "email",
+    "sms",
+    "none"
+  ],
+  "type": "string"
+}

Changed4 schema fields changedOct 1, 2026

addedInput schema / properties / id

Added value: +{
+  "description": "Contact id. Returns that one contact; other filters ignored.",
+  "type": "string"
+}

changedInput schema / properties / limit / description

Previous value: -"Max results (1-1000, default 50)."New value: +"Default 50."

removedInput schema / properties / offset / description
```
Removed value: -"Pagination offset, default 0."
```

changedInput schema / properties / search / description

Previous value: -"Free-text search across name, email, phone."New value: +"Matches name, email, phone."

First observedSep 23, 2026

TDQS

Score is being calculated.

All Groundbase tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?