# Moderation API — how to use (mcp.ai)

Connect your Moderation API account and use 11 tools for AI safety and compliance straight from your AI agent. Connect with your own API key. Moderation API provides content detection, human review workflows, author management, and moderation actions for online platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_moderationapi?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `moderationapi_evaluate_content`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/moderationapi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/moderationapi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/moderationapi/evaluate/content` — Evaluate content without retaining it or adding it to a review queue, and return policy findings and the recommended moderation action.
  - body: { channel?: string, content: object, metadata?: object, author_id?: string, meta_type?: string, timestamp?: number, content_id?: string, client_action?: object, conversation_id?: string }
- `POST https://api.mcp.ai/api/moderationapi/execute/action` — Apply a discovered moderation action to content items or authors. Actions can reject content or block or suspend authors and may be irreversible; inspect LIST_ACTIONS before calling.
  - body: { value?: string, queue_id?: string, action_key: string, author_ids?: string[], content_ids?: string[], duration_ms?: number }
- `POST https://api.mcp.ai/api/moderationapi/get/account` — Return the connected Moderation API account, plan, current project, and current quota values.
- `POST https://api.mcp.ai/api/moderationapi/get/review/queue` — Return metadata and item counts for a review queue by ID. Requires the paid review-queue add-on; contact Moderation API sales if review queues are not enabled for the connected organization.
  - body: { queue_id: string }
- `POST https://api.mcp.ai/api/moderationapi/get/wordlist` — Return one wordlist and its current words by ID.
  - body: { wordlist_id: string }
- `POST https://api.mcp.ai/api/moderationapi/list/actions` — List moderation actions available to the organization, optionally restricted to a review queue.
  - body: { queue_id?: string }
- `POST https://api.mcp.ai/api/moderationapi/list/review/queue/items` — List and filter one page of moderation items in a review queue. Requires the paid Moderation API review-queue add-on.
  - body: { cursor?: string, queue_id: string, author_id?: string, page_size?: integer, sort_field?: string, sort_direction?: string, include_resolved?: boolean }
- `POST https://api.mcp.ai/api/moderationapi/list/wordlists` — List the organization's wordlists and their identifiers.
- `POST https://api.mcp.ai/api/moderationapi/modify/wordlist/words` — Add words to or remove words from an existing wordlist.
  - body: { words: string[], operation: string, wordlist_id: string }
- `POST https://api.mcp.ai/api/moderationapi/set/review/queue/item/status` — Mark a review queue item resolved or return it to pending. Requires the paid review-queue add-on.
  - body: { status: string, comment?: string, item_id: string, queue_id: string }
- `POST https://api.mcp.ai/api/moderationapi/submit/content/for/moderation` — Evaluate content and allow Moderation API to retain it and add it to a review queue according to the project's configuration.
  - body: { channel?: string, content: object, metadata?: object, author_id?: string, meta_type?: string, timestamp?: number, content_id?: string, client_action?: object, conversation_id?: string }

## Example prompts
- "What can I do in Moderation API?"
- "Show me a summary of my Moderation API account"

## More
- Page: https://mcp.ai/moderationapi
- Agent spec (llms.txt): https://mcp.ai/moderationapi/llms.txt
- Postman collection: https://mcp.ai/moderationapi/postman.json