Moderation API MCP server
Commit Nov 10, 2026Lets AI agents manage moderation accounts by triaging review queues, investigating authors, tuning policies, and responding to incidents.
Also known as moderation-api/moderation-api-mcp, moderation-api-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Nov 10, 2026
- License
- MIT
What is Moderation API MCP?
Moderation API lets AI agents manage moderation accounts by triaging review queues, investigating authors, tuning policies, and responding to incidents.
Summary generated from the project's README
About Moderation API MCP server
Managing moderation accounts through AI agents is what this remote MCP server enables for developers and community managers. By connecting clients like Claude, ChatGPT, or Cursor to the hosted endpoint, you allow an agent to interact directly with your Moderation API account. The server provides a tool for every REST API endpoint, meaning your agent can perform the same actions as your custom code while adhering to your existing rate limits and quotas.
Users with Owner, Admin, or Developer roles can use the server to triage review queues, investigate author histories, and tune wordlists or policies based on real examples. The system includes specialized prompts for tasks like incident response and moderation reporting. Because it is a hosted service, there is nothing to install locally, and you can connect via a browser-based sign-in or by providing an API key for headless environments like CI.
What you can do with it
- 1Triage review queuesAsk an agent to process unresolved items and identify specific posts that require human judgment.
- 2Investigate problematic authorsHave an agent check a user's history to determine if they are a bad actor and take appropriate action.
- 3Tune moderation policiesUse specific examples of flagged or missed content to adjust thresholds and wordlist entries.
- 4Respond to content raidsDirect an agent to find scam posts during an incident and block the involved authors and domains.
Written from the project's README. Every use case is checked against a quote from it.
How to install Moderation API MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Moderation API MCP in Claude Code
$ claude mcp add --transport http moderation-api-mcp https://mcp.moderationapi.com/mcpInstall Moderation API MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"moderation-api-mcp": {
"url": "https://mcp.moderationapi.com/mcp"
}
}
}Install Moderation API MCP in VS Code
.vscode/mcp.json
{
"servers": {
"moderation-api-mcp": {
"type": "http",
"url": "https://mcp.moderationapi.com/mcp"
}
}
}Install Moderation API MCP in VS Code CLI
$ code --add-mcp '{"name":"moderation-api-mcp","type":"http","url":"https://mcp.moderationapi.com/mcp"}'Install Moderation API MCP in Codex
$ codex mcp add moderation-api-mcp --url https://mcp.moderationapi.com/mcpInstall Moderation API MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.moderation-api-mcp] url = "https://mcp.moderationapi.com/mcp"
Install Moderation API MCP in Gemini CLI
$ gemini mcp add -s user --transport http moderation-api-mcp https://mcp.moderationapi.com/mcpInstall Moderation API MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"moderation-api-mcp": {
"url": "https://mcp.moderationapi.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemoderation-api/moderation-api-mcp is public and reachablegithub.com/moderation-api/moderation-api-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/moderation-api/moderation-api-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubModeration API MCP Server
Let AI agents run your Moderation API account: work through review queues, investigate authors, tune policies and wordlists, respond to incidents and report on how moderation is going.
This is a hosted (remote) Model Context Protocol server. Connect Claude, ChatGPT, Cursor or any other MCP client to:
https://mcp.moderationapi.com/mcp
There is nothing to install. The server has one tool for each endpoint of the REST API, and it calls the same API as your code, so rate limits, quotas and request logs work the same way.
What your agent can do
- Triage the review queue. "Go through today's unresolved items, reject the obvious spam, and show me the 5 you're unsure about." The agent does the first pass; you make the judgment calls.
- Investigate an author. "Is user 8812 a bad actor? Check their history and suspend them if it's a pattern."
- Tune policies from real examples. "These 10 comments got flagged but are fine, and these 3 got through. Fix it." The agent tests the examples without storing them, finds the thresholds or wordlist entries that separate them, and updates the channel.
- Respond to incidents. "There's a raid of crypto scam posts in the last hour. Find them, block the authors, and add the domains to the blocklist."
- Set up moderation without the dashboard. "Set up moderation for our new marketplace: a channel for listings, one for messages, and a webhook to our endpoint." Then send test content to check it.
- Report and audit. "How did moderation go this month?" Queue stats, actions and author trends turned into a summary.
- Combine with your other tools. A daily queue digest in Slack, an issue when a policy keeps misfiring, a draft reply to the user whose post was removed.
The server also ships prompts (recipes) for these jobs: triage-queue, check-author, tune-policy, incident-response and moderation-report. More example prompts: What your agent can do.
Tools
| Area | What the tools do |
|---|---|
| Content | Submit content and read the result, with or without storing it; allow or reject content |
| Review queues | List queues and 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; block, suspend and unblock them |
| 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 and their words |
| Analytics | Summary, most flagged policies and authors, numbers per channel, volumes over time, automation |
| Projects | List, create, change and duplicate projects; create API keys |
| Webhooks | List, create and change webhooks |
| Feedback | Send a feature request to the Moderation API team |
Read-only tools are marked as read-only, so your agent can run them without asking. Tools that change or delete data are marked as such, and most agents ask you before they run them.
Setup
You need a Moderation API account with the Owner, Admin or Developer role. Sign up free.
Claude Code
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.
Claude and Claude Desktop
Open the Moderation API connector in the Claude directory and click Connect.
Or open Settings → Connectors → Add custom connector, and enter https://mcp.moderationapi.com/mcp.
ChatGPT and Codex
Open the Moderation API plugin in the ChatGPT directory and click Install plugin. The plugin adds the MCP server and the setup skill together. In Codex, the setup skill can also add moderation to your app's code.
Cursor
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"
}
}
}
Other clients
Add a remote MCP server with the URL https://mcp.moderationapi.com/mcp and the Streamable HTTP transport.
Sign in
The first time your agent uses the server, your browser opens:
- Sign in with your Moderation API account.
- Pick the organization the agent can use.
- Approve the connection.
The agent can reach the projects that you can reach. Each connection gets its own API key, shown on the API keys page and 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.
Projects
Tools that work on content in a project take an optional projectId. You can give the project ID or its name. When it's left out and the key reaches more than one project, the tool returns the projects to choose from.
Other tools for agents
- Setup skill: lets a coding agent add Moderation API to your app's code.
npx skills add moderation-api/skills - CLI: sign in, create a project and write API keys from the terminal.
modapi init
See Build with AI agents.
Links
- Documentation
- Moderation API
- Claude connector
- ChatGPT plugin
- MCP Registry listing:
com.moderationapi/moderation-api
License
MIT
Moderation API MCP questions
How do I add Moderation API MCP to Claude Code?
Run claude mcp add --transport http moderation-api-mcp https://mcp.moderationapi.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Moderation API MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I set up the server with Claude?
You can add it via Claude Code using the HTTP transport or by using the official connector in the Claude directory.
Can I use this in environments without a browser?
Yes, agents in environments like CI can use an API key passed via an Authorization header.
Does the agent have access to all my data?
The agent can reach the same projects that you can reach based on the organization or project key used.