Headlessly
MCP

search

Find entities across the graph with filters, sorting, and pagination.

Usage

headless.ly/mcp#search
{
  "type": "Contact",
  "filter": { "stage": "Lead" },
  "sort": "-createdAt",
  "limit": 25
}

Parameters

ParameterTypeDescription
typestringEntity type (Contact, Deal, Issue, etc.)
filterobjectMongoDB-style query filters
sortstringField to sort by (prefix - for descending)
limitnumberMax results (default 25)
offsetnumberSkip N results
asOfstringTime travel -- query as of ISO timestamp

Filter Operators

headless.ly/mcp#search
{
  "type": "Deal",
  "filter": {
    "value": { "$gte": 50000 },
    "stage": { "$in": ["Proposal", "Negotiation"] },
    "closedAt": { "$exists": false }
  }
}
headless.ly/mcp#search
{
  "type": "Contact",
  "filter": {
    "organization.industry": "Technology",
    "stage": "Qualified"
  }
}

On this page