List first-time guests
People whose check-in to an event was their first, in a date range.
MCP tool planning_center_read → list_first_timers
read
Returns the check-ins marked as a first time for the event, one row per person with the date. Visitors checked in by label only are not saved in People and are not returned. Use person_id with get_person.
Parameters
| Name | Type | Description |
|---|---|---|
| event string required | string | Check-Ins event name, for example Sunday Gathering. |
| from date | date | First day to include. |
| to date | date | Last day to include. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "planning_center_read",
"arguments": {
"operation": "list_first_timers",
"arguments": {
"event": "event"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"first_timers": [
{
"person_id": "51207",
"name": "Hannah Cole",
"checked_in": "2026-10-18"
},
{
"person_id": "51330",
"name": "Ben Ortiz",
"checked_in": "2026-10-18"
},
{
"person_id": "51402",
"name": "Maya Singh",
"checked_in": "2026-10-18"
}
]
},
"isError": false
}