# `refine_content`

_Scripts_

`write` `30/day`

Refine or discuss a script with Dalea's shared brand voice, memory, restrictions, source text and chat history. Default returns and saves a preview without changing script/settings; apply=true applies explicitly requested edits. Unsolicited settings remain proposals. searchWeb=true researches the question and returns citations. Uses AI quota. Questions and web-search offers do not rewrite the script. Review saved previews with review_content_refinement.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brandId` | `string` | no |  |
| `contentId` | `string` | yes |  |
| `message` | `string` | yes |  |
| `apply` | `boolean` | no |  |
| `searchWeb` | `boolean` | no |  |
| `objective` | `"reach" \| "followers" \| "engagement" \| "sales" \| "leads" \| "authority"` | no |  |
| `intentSection` | `"hook" \| "body" \| "cta" \| "caption"` | no |  |
| `escalationOf` | `string` | no |  |

## Example

### Prompt

```text
Shorten this script while keeping my voice and the source facts.
```

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "refine_content",
    "arguments": {
      "contentId": "3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f",
      "message": "Shorten this script to 30 seconds, keeping the facts and my voice",
      "apply": false
    }
  }
}
```

### curl

```bash
curl -X POST https://app.usedalea.ai/api/mcp/mcp \
  -H "Authorization: Bearer dalea_mcp_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"refine_content","arguments":{"contentId":"3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f","message":"Shorten this script to 30 seconds, keeping the facts and my voice","apply":false}}}'
```