Search vector store MCP response
MCP tool response returned by the Search vector store MCP tool.
- Returned by: Search vector store MCP tool
- Response type: Structured vector-store search result
Response Shape
The tool returns a text report plus structured content. It does not return a reusable GovTribe record row.
The structured content uses these fields:
| Field | Type | Notes |
|---|---|---|
query | string | Original semantic search query. |
status | string | Vector store readiness status for the response, such as completed or in_progress. |
message | string | Human-readable summary of readiness or result count. |
result_count | integer | Number of returned vector-store search results. |
results | object array | Ranked result objects. Each result includes rank, file_id, filename, score, attributes, and content. |
has_more | boolean | Whether additional vector-store results are available. |
next_page | string or null | Cursor for the next vector-store search page when available. |
The text content preserves a readable report for clients and logs. Successful searches use this pattern:
| Part | Text pattern | Notes |
|---|---|---|
| Header | Found {count} result(s) for: "{query}" | Returned when the vector store has at least one match. |
| Result heading | ### Result {rank} — {filename} (relevance: {score}%) | Returned once for each matching file. |
| Attributes | Attributes: {key}: {value}, ... | Included only when the matched file has attributes. |
| Content | Matched text chunks | One or more extracted text chunks from the matching file. |
| More results | Additional results available. | Included when the vector store reports additional available results. |
If the completed vector store has no matches, message and the text content say No results found for: "{query}", result_count is 0, and results is empty.
If the vector store is not ready, status is the current vector-store status, result_count is 0, results is empty, and message contains the retry guidance.
Follow-up Behavior
When status is not completed, retry Search_Vector_Store later or call Add_To_Vector_Store again with identical arguments to check readiness.
Example
{
"query": "pricing assumptions",
"status": "completed",
"message": "Found 1 result(s) for: \"pricing assumptions\"",
"result_count": 1,
"results": [
{
"rank": 1,
"file_id": "FILE_ID",
"filename": "pricing-summary.pdf",
"score": 0.875,
"attributes": {
"govtribe_id": "USER_FILE_ID",
"govtribe_type": "user_file"
},
"content": [
{
"type": "text",
"text": "The pricing assumptions include labor escalation and option-year rates."
}
]
}
],
"has_more": false,
"next_page": null
}