Load data table MCP response
MCP tool response returned by the Load data table MCP tool.
- Returned by: Load data table MCP tool
- Response type: Structured app payload
Response Shape
The advertised output schema contains all six fields below for every successful current bounded source page, including view_search_results_url when null. A successfully fetched page with no rows has rows: []; failed, expired, unsupported or unauthorized references return errors instead of a successful hydration payload.
| Field | Type | Notes |
|---|---|---|
rows | object[] | Current typed-search rows, restricted to selected fields and current access. |
total_count | integer | Non-negative total underlying matches, not the number loaded into the table. |
source_page | integer | Current underlying search page, starting at 1. |
source_last_page | integer | Last underlying page reported by the typed search, starting at 1. |
view_search_results_url | string or null | Full GovTribe search URL when provided by the typed search. |
operations_scope | string | Always loaded_rows; local controls affect only these rows. |
A successful empty search still returns the complete paging and scope envelope:
{
"rows": [],
"total_count": 0,
"source_page": 1,
"source_last_page": 1,
"view_search_results_url": null,
"operations_scope": "loaded_rows"
}Follow-up Behavior
A new source page replaces loaded rows and resets local sort, search and pagination. Fetching another source page preserves the stored query shape, rechecks access and uses normal search usage metering. It fetches current data rather than a stored snapshot; totals and page contents can change between fetches. Full-search sorting/filtering requires a new typed search.
Example
{
"rows": [{"name":"Illustrative opportunity"}],
"total_count": 40,
"source_page": 2,
"source_last_page": 4,
"view_search_results_url": null,
"operations_scope": "loaded_rows"
}