MCP server

The Moderation API MCP server lets an AI agent work with your account: go through review queues, look up authors, change policies and wordlists, read analytics and more. It is hosted at:

https://mcp.moderationapi.com/mcp

The server has one tool for each endpoint of the REST API. To add moderation to the code of your app, use the setup skill instead.

Connect your agent

Claude Code
Claude and Claude Desktop
Cursor
Other clients

claude mcp add --transport http moderation-api https://mcp.moderationapi.com/mcp

Or install the plugin, which adds the MCP server and the setup skill together.

Open Settings → Connectors → Add custom connector, and enter https://mcp.moderationapi.com/mcp.

Add the server to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for all projects:

{
  "mcpServers": {
    "moderation-api": {
      "url": "https://mcp.moderationapi.com/mcp"
    }
  }
}

Add a remote MCP server with the URL https://mcp.moderationapi.com/mcp and the Streamable HTTP transport.

The first time the agent uses the server, your browser opens:

Sign in with your Moderation API account.
Pick the organization the agent can use.
Approve the connection.

You need the Owner, Admin or Developer role in the organization. The agent can reach the projects that you can reach. Each connection gets its own API key. It shows on the API keys page, named after the app and your email. Delete the key to end the connection. When the agent resolves queue items or runs actions, the review queue shows you as the reviewer.

Without a browser

Agents that cannot open a browser, for example in CI, can send an API key instead:

claude mcp add --transport http moderation-api https://mcp.moderationapi.com/mcp \
  --header "Authorization: Bearer $MODAPI_SECRET_KEY"

A project key reaches one project. An organization key reaches the projects you allow it to. See Authentication.

Projects

Tools that work on content in a project take an optional projectId. You can give the project ID or its name. When the agent leaves it out and the key reaches more than one project, the tool returns the projects to choose from.

What the tools can do

Area	Tools
Content	Submit content and read the result, with or without storing it
Review queues	List queues, list items, resolve and unresolve items, one by one or up to 100 at a time, queue statistics
Authors	List, look up, create and update authors
Actions	List and run moderation actions on content and authors, create and change actions
Policies	Read and change channels and their policies, create and change wordlists
Analytics	Summary, most flagged policies and authors, numbers per channel, volumes over time, automation
Projects	List, create, change and duplicate projects
Webhooks	List, create and change webhooks
Feedback	Send a feature request to the Moderation API team

Tools that only read data are marked as read-only, so your agent can run them without asking you. Tools that change or delete data are marked as such, and most agents ask you before they run them. See What your agent can do for prompts to start with.

Limits

The MCP server calls the same API as your code. Rate limits, quotas and request logs work the same way.

Documentation

AI agents

Learn

Migrations

Resources

Connect your agent

Without a browser

Projects

What the tools can do

Limits

​Connect your agent

​Sign in

​Without a browser

​Projects

​What the tools can do

​Limits

Connect your agent

Sign in

Without a browser

Projects

What the tools can do

Limits