delete_stateful_response
Remove stored conversational responses from the Grok MCP server to manage memory and maintain privacy during AI interactions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| response_id | Yes |
Implementation Reference
- src/server.py:431-436 (handler)The main handler function for delete_stateful_response tool. It accepts a response_id parameter, creates an XAI client, calls delete_stored_completion(), and returns a confirmation message.@mcp.tool() async def delete_stateful_response(response_id: str): client = Client(api_key=XAI_API_KEY) client.chat.delete_stored_completion(response_id) client.close() return f"Deleted response `{response_id}`"
- src/server.py:396-417 (handler)Related handler: stateful_chat creates stored responses that can later be deleted using delete_stateful_response. Returns a response_id that is used for deletion.@mcp.tool() async def stateful_chat( prompt: str, model: str = "grok-4", response_id: Optional[str] = None, system_prompt: Optional[str] = None ): client = Client(api_key=XAI_API_KEY) chat_params = {"model": model, "store_messages": True} if response_id: chat_params["previous_response_id"] = response_id chat = client.chat.create(**chat_params) if system_prompt and not response_id: chat.append(system(system_prompt)) chat.append(user(prompt)) response = chat.sample() client.close() return f"{response.content}\n\n**Response ID:** `{response.id}`"
- src/server.py:420-428 (handler)Related handler: retrieve_stateful_response retrieves a previously stored response by response_id. Complements the delete operation.@mcp.tool() async def retrieve_stateful_response(response_id: str): client = Client(api_key=XAI_API_KEY) responses = client.chat.get_stored_completion(response_id) client.close() if not responses: return f"No response found for id {response_id}" response = responses[0] if isinstance(responses, list) else responses return f"{response.content}\n\n**Response ID:** `{response.id}`"