Search

Search tools provide full-text search across entities and comprehensive dossier views that aggregate data from multiple tables.

search

Full-text search across outlets, contacts, coverage, and notes.

Parameters

Parameter	Type	Required	Description
query	string	Yes	Search query
types	string[]	No	Which entity types to search. Options: outlets, contacts, coverage, notes. Default: all four.
limit	number	No	Max results per type (default: 20)

Example

{
  "name": "search",
  "arguments": {
    "query": "AI agents",
    "types": ["outlets", "contacts"],
    "limit": 10
  }
}

Response Shape

{
  "outlets": [
    { "id": "...", "name": "TechCrunch", "description": "...", "tier": 1, "website": "...", "industry_focus": [...] }
  ],
  "contacts": [
    { "id": "...", "first_name": "Sarah", "last_name": "Chen", "email": "...", "title": "..." }
  ]
}

contact_background

Full dossier on a contact: outlets, opportunities, coverage, recent email threads, and notes. Use this to prepare before reaching out to a contact.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Contact ID

Example

{
  "name": "contact_background",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Response Shape

{
  "contact": { "id": "...", "first_name": "...", "..." : "..." },
  "outlets": [...],
  "opportunities": [...],
  "coverage": [...],
  "recent_emails": [...],
  "notes": [...]
}

outlet_background

Full dossier on an outlet: channels, contacts, opportunities, coverage, and notes.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Outlet ID

Example

{
  "name": "outlet_background",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Response Shape

{
  "outlet": { "id": "...", "name": "...", "..." : "..." },
  "channels": [...],
  "contacts": [...],
  "opportunities": [...],
  "coverage": [...],
  "notes": [...]
}

opportunity_status

Detailed status of an opportunity with all linked entities including contacts, coverage, email threads, and notes.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Opportunity ID

Example

{
  "name": "opportunity_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Response Shape

{
  "opportunity": { "id": "...", "title": "...", "stage": "pitched", "campaign": {...}, "channel": {...}, "outlet": {...}, "..." : "..." },
  "contacts": [...],
  "coverage": [...],
  "email_threads": [...],
  "notes": [...]
}