superset_tag_create
Create new tags in Apache Superset to organize and categorize charts and dashboards for better content management.
Instructions
Create a new tag in Superset
Makes a request to the /api/v1/tag/ POST endpoint to create a new tag that can be applied to objects like charts and dashboards.
Args: name: Name for the tag
Returns: A dictionary with the created tag information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes |
Implementation Reference
- main.py:1520-1537 (handler)The handler function for the 'superset_tag_create' tool. It is registered via @mcp.tool(), requires authentication, handles errors, and creates a new Superset tag by making a POST request to /api/v1/tag/ with the given name.@mcp.tool() @requires_auth @handle_api_errors async def superset_tag_create(ctx: Context, name: str) -> Dict[str, Any]: """ Create a new tag in Superset Makes a request to the /api/v1/tag/ POST endpoint to create a new tag that can be applied to objects like charts and dashboards. Args: name: Name for the tag Returns: A dictionary with the created tag information """ payload = {"name": name} return await make_api_request(ctx, "post", "/api/v1/tag/", data=payload)
- main.py:1520-1520 (registration)The @mcp.tool() decorator registers the superset_tag_create function as an MCP tool.@mcp.tool()
- main.py:271-330 (helper)General helper function used by superset_tag_create to make authenticated API requests to Superset with automatic token refresh and CSRF handling.async def make_api_request( ctx: Context, method: str, endpoint: str, data: Dict[str, Any] = None, params: Dict[str, Any] = None, auto_refresh: bool = True, ) -> Dict[str, Any]: """ Helper function to make API requests to Superset Args: ctx: MCP context method: HTTP method (get, post, put, delete) endpoint: API endpoint (without base URL) data: Optional JSON payload for POST/PUT requests params: Optional query parameters auto_refresh: Whether to auto-refresh token on 401 """ superset_ctx: SupersetContext = ctx.request_context.lifespan_context client = superset_ctx.client # For non-GET requests, make sure we have a CSRF token if method.lower() != "get" and not superset_ctx.csrf_token: await get_csrf_token(ctx) async def make_request() -> httpx.Response: headers = {} # Add CSRF token for non-GET requests if method.lower() != "get" and superset_ctx.csrf_token: headers["X-CSRFToken"] = superset_ctx.csrf_token if method.lower() == "get": return await client.get(endpoint, params=params) elif method.lower() == "post": return await client.post( endpoint, json=data, params=params, headers=headers ) elif method.lower() == "put": return await client.put(endpoint, json=data, headers=headers) elif method.lower() == "delete": return await client.delete(endpoint, headers=headers) else: raise ValueError(f"Unsupported HTTP method: {method}") # Use auto_refresh if requested response = ( await with_auto_refresh(ctx, make_request) if auto_refresh else await make_request() ) if response.status_code not in [200, 201]: return { "error": f"API request failed: {response.status_code} - {response.text}" } return response.json()