---
id: gk-block-mcp-agent-caps
title: "Filter - gk/block-mcp/agent/caps"
sidebar_label: "gk/block-mcp/agent/caps"
tags:
  - "2.0.0"
---

# Filter: gk/block-mcp/agent/caps

Tune exactly what the Block MCP agent account is allowed to do.

The dedicated agent ships locked down — it writes content but can't delete, change settings, or be used to log in. Reach for this filter when your workflow needs a tighter or looser fit: hand the agent permission to clean up its own drafts, or strip publishing so everything it touches stays a draft for human review.

## Parameters

| Name | Type | Description |
|------|------|-------------|
| $caps | `array<string,bool>` | Map of capability name => granted, for the agent role. |

## Example

// Let the assistant permanently delete the posts it created.

```php
add_filter( 'gk/block-mcp/agent/caps', function ( $caps ) {
    $caps['delete_posts'] = true;
    return $caps;
} );
```

### Since

- [2.0.0](../../since/2-0-0/)

### Source

Defined in `wordpress-plugin/gk-block-api/includes/class-agent-provisioner.php` at line 95