From 37327616fe736d30b5ceb5e1df29200e399c97cc Mon Sep 17 00:00:00 2001 From: adityamparikh Date: Thu, 16 Jul 2026 14:36:20 -0400 Subject: [PATCH] feat(mcp): declare tool-surface boundaries in MCP server instructions The MCP initialize response carries server-level instructions that every client receives. Use them to state what this surface does NOT include (delete, field drops/alters, debugQuery, vector/KNN, non-field facets) and that schema modification is additive only, so LLM clients stop guessing at tools that don't exist and route around the gaps instead. Co-Authored-By: Claude Fable 5 Signed-off-by: adityamparikh --- src/main/resources/application.properties | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties index c2038f5c..089d7d3f 100644 --- a/src/main/resources/application.properties +++ b/src/main/resources/application.properties @@ -16,7 +16,12 @@ # spring.application.name=solr-mcp spring.profiles.active=${PROFILES:stdio} -spring.ai.mcp.server.instructions=This server provides tools to interact with Apache Solr using Model Context Protocol (MCP) over STDIO and/or HTTP. +spring.ai.mcp.server.instructions=This server provides tools to search, index, and manage Apache Solr collections. \ +Discover before acting: use list-collections and get-schema to see what exists before searching or indexing. \ +Surface boundaries: there are no tools to delete documents or collections, drop or alter existing fields, \ +or debug relevance scoring (debugQuery); vector/KNN search is not exposed; search facets are simple field \ +facets only (no range, pivot, or JSON facets). Schema modification is additive only via add-fields and \ +add-field-types; changing an existing field's type requires reindexing and is not supported by this server. spring.ai.mcp.server.name=${spring.application.name} spring.ai.mcp.server.version=1.0.0 # Solr configuration