content-moderation

# Content Moderation

Moderate user-generated content using Vettly's AI-powered content moderation API. This skill uses the `@vettly/mcp` MCP server to check text, images, and video against configurable moderation policies with auditable decisions.

## Setup

Add the `@vettly/mcp` MCP server to your configuration:

```json
{
  "mcpServers": {
    "vettly": {
      "command": "npx",
      "args": ["-y", "@vettly/mcp"],
      "env": {
        "VETTLY_API_KEY": "your-api-key"
      }
    }
  }
}
```

Get an API key at [vettly.dev](https://vettly.dev).

## Available Tools

### `moderate_content`

Check text, image, or video content against a Vettly moderation policy. Returns a safety assessment with category scores, the action taken, provider used, latency, and cost.

**Parameters:**
- `content` (required) - The content to moderate (text string, or URL for images/video)
- `policyId` (required) - The policy ID to use for moderation
- `contentType` (optional, default: `text`) - Type of content: `text`, `image`, or `video`

### `validate_policy`

Validate a Vettly policy YAML without saving it. Returns validation results with any syntax or configuration errors. Use this to test policy changes before deploying them.

**Parameters:**
- `yamlContent` (required) - The YAML policy content to validate

### `list_policies`

List all moderation policies available in your Vettly account. Takes no parameters. Use this to discover available policy IDs before moderating content.

### `get_usage_stats`

Get usage statistics for your Vettly account including request counts, costs, and moderation outcomes.

**Parameters:**
- `days` (optional, default: `30`) - Number of days to include in statistics (1-365)

### `get_recent_decisions`

Get recent moderation decisions with optional filtering by outcome, content type, or policy.

**Parameters:**
- `limit` (optional, default: `10`) - Number of decisions to return (1-50)
- `flagged` (optional) - Filter to only flagged content (`true`) or safe content (`false`)
- `policyId` (optional) - Filter by specific policy ID
- `contentType` (optional) - Filter by content type: `text`, `image`, or `video`

## When to Use

- Moderate user-generated content (comments, posts, uploads) before publishing
- Test and validate moderation policy YAML configs during development
- Audit recent moderation decisions to review flagged content
- Monitor moderation costs and usage across your account
- Compare moderation results across different policies

## Examples

### Moderate a user comment

```
Moderate this user comment for my community forum policy:
"I hate this product, it's the worst thing I've ever used and the developers should be ashamed"
```

Call `list_policies` to find available policies, then `moderate_content` with the appropriate policy ID and return the safety assessment.

### Validate a policy before deploying

```
Validate this moderation policy YAML:

categories:
  - name: toxicity
    threshold: 0.8
    action: flag
  - name: spam
    threshold: 0.6
    action: block
```

Call `validate_policy` and report any syntax or configuration errors.

### Review recent flagged content

```
Show me all flagged content from the last week
```

Call `get_recent_decisions` with `flagged: true` to retrieve recent moderation decisions that were flagged.

## Tips

- Always call `list_policies` first if you don't know which policy ID to use
- Use `validate_policy` to test policy changes before deploying to production
- Use `get_usage_stats` to monitor costs and catch unexpected spikes
- Filter `get_recent_decisions` by `contentType` or `policyId` to narrow results
- For image and video moderation, pass the content URL rather than raw data