(superset) 05/17: docs(mcp): document that list_rls_filters and list_plugins have inline column docs

[mi...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

aminghadersohi pushed a commit to branch mcp-rls-plugins-99978
in repository https://gitbox.apache.org/repos/asf/superset.git

commit ab69e3dbcc46e420fa1dc145dae3f986421a5819
Author: Amin Ghadersohi <am...@gmail.com>
AuthorDate: Thu May 21 08:13:49 2026 +0000

    docs(mcp): document that list_rls_filters and list_plugins have inline column docs
---
 superset/mcp_service/app.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/superset/mcp_service/app.py b/superset/mcp_service/app.py
index 3e276147856..8589a51d156 100644
--- a/superset/mcp_service/app.py
+++ b/superset/mcp_service/app.py
@@ -350,7 +350,10 @@ IMPORTANT - Tool-Only Interaction:
 
 General usage tips:
 - All listing tools use 1-based pagination (first page is 1)
-- Use get_schema to discover filterable columns, sortable columns, and default columns
+- Use get_schema (chart/dataset/dashboard/database) to discover filterable columns,
+  sortable columns, and default columns for those resource types
+- For list_rls_filters and list_plugins, filterable/sortable columns are listed
+  inline in each tool's docstring — get_schema does not cover these tools
 - Use 'filters' parameter for advanced queries with filter columns from get_schema
 - IDs can be integer or UUID format where supported
 - All tools return structured, Pydantic-typed responses