> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plungeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plungeai_chat

> Persistent chat with the PlungeAI assistant (platform tools + web search). action send|new|list_sessions|history. Conversations appear in Studio and the CLI.


Persistent chat with the PlungeAI assistant (platform tools and web search): `action` `send`, `new`, `list_sessions` or `history`. Conversations appear in Studio and the CLI.

**Returns.** `send`: the assistant's reply and ``_(conversation: `<id>`)_``. `new`: ``Created conversation `<id>`. …``. `list_sessions`: `# Your conversations (N)` (Title, ID, Messages) for the 20 most recent, or `No conversations yet.`. `history`: `# <title>` and every turn. Details: [10.1](https://mcp.plungeai.com/docs#101-chat-plungeai_chat).

```bash
# verify
# expect: conversations
curl -s https://mcp.plungeai.com/v1 \
  -H "Authorization: Bearer $PLUNGE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plungeai_chat","arguments":{"user_request":"list my conversations","action":"list_sessions"}}}'
```

<Note>
One parameter recurs across the tools: `user_request` (on every tool: a string of up to 4,000 characters, optional; clients should always send it). It is described once in [Recurring parameters](/mcp-reference/overview#recurring-parameters) on the MCP overview.
</Note>

## Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "user_request": {
      "description": "The user's original request, verbatim and in their own words, before you translated it into this call. Always include it — the platform uses it for request context, routing and support diagnostics.",
      "type": "string",
      "maxLength": 4000
    },
    "action": {
      "type": "string",
      "enum": [
        "send",
        "list_sessions",
        "history",
        "new"
      ]
    },
    "message": {
      "type": "string",
      "maxLength": 65536
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 256
    }
  },
  "required": [
    "action"
  ]
}
```