@vettly/mcp

MCP (Model Context Protocol) server for Vettly content moderation API. Enables AI assistants like Claude to moderate content, validate policies, and review moderation decisions.

Installation

npm install @vettly/mcp
# or
npx @vettly/mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "vettly": {
      "command": "npx",
      "args": ["-y", "@vettly/mcp"],
      "env": {
        "VETTLY_API_KEY": "vettly_live_xxx"
      }
    }
  }
}

Environment Variables

• VETTLY_API_KEY (required) - Your Vettly API key
• VETTLY_API_URL (optional) - API URL (defaults to https://api.vettly.dev)

Available Tools

moderate_content

Check content against a Vettly moderation policy.

Parameters:

• content (required) - The content to moderate
• policyId (required) - The policy ID to use
• contentType (optional) - text, image, or video (default: text)

Example:

Moderate this text: "Hello world" using policy "default-policy"

validate_policy

Validate a policy YAML without saving it.

Parameters:

• yamlContent (required) - The YAML policy content to validate

Example:

Validate this policy YAML:
name: my-policy
rules:
  - category: hate_speech
    threshold: 0.7
    action: block

list_policies

List all available moderation policies in your account.

Parameters: None

get_usage_stats

Get usage statistics including request counts, costs, and moderation outcomes.

Parameters:

• days (optional) - Number of days to include (1-365, default: 30)

get_recent_decisions

Get recent moderation decisions with optional filtering.

Parameters:

• limit (optional) - Number of decisions to return (1-50, default: 10)
• flagged (optional) - Filter by flagged status
• policyId (optional) - Filter by policy ID
• contentType (optional) - Filter by content type

Resources

vettly://policies

Read-only list of all available moderation policies.

vettly://policies/{policyId}

Read-only access to a specific policy's YAML configuration.

Programmatic Usage

import { createVettlyMcpServer } from '@vettly/mcp';

const server = createVettlyMcpServer({
  apiKey: process.env.VETTLY_API_KEY!,
  apiUrl: 'https://api.vettly.dev', // optional
});

// Connect to your transport
server.connect(transport);

Links

• Vettly Documentation
• Get an API Key
• MCP Specification