> ## 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.

# prompts/get

> Get a prompt by name; an unknown name answers -32602.


Returns the prompt's message. Support: **supported**. It runs nothing, so it is free.

## Params

| Param | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes | `plungeai` |
| `arguments.request` | string | no | What the user wants; without it the message tells the model to ask |

## Result

| Field | Value |
|---|---|
| `description` | `PlungeAI MCP` |
| `messages[]` | One `user` message of type `text`, ending with `Now handle this request: <request>` or `Ask the user what they want to accomplish.` |

## Example

```bash Request
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":8,"method":"prompts/get","params":{"name":"plungeai","arguments":{"request":"summarise my last run"}}}'
```

```json Response
{"jsonrpc":"2.0","id":8,"result":{"description":"PlungeAI MCP","messages":[{"role":"user","content":{"type":"text","text":"…Now handle this request: summarise my last run"}}]}}
```

The response above is abridged: the start of the prompt text is shortened to `…`; only its last sentence is shown.

## Errors

Protocol errors mean the request never reached a tool; the body is `{"jsonrpc":"2.0","error":{"code":…,"message":"…"},"id":…}`.

| HTTP | Code | When |
|---|---|---|
| 200 | `-32602` | `MCP error -32602: Prompt not found: <name>` |
| 401 | `-32001` | No key, or a wrong, revoked or expired key, or a bearer that does not start with `ozk_` |

The full table is on the [MCP Reference overview](/mcp-reference/overview#errors).