# OOPSpam MCP > OOPSpam connects your AI client to an anti-spam API that protects forms and comments. It lets your agent check text, emails, or IPs for spam scores, block bad actors, and track usage—all without you opening a separate moderation dashboard. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** oopspam, anti-spam-api, content-moderation, bot-detection, privacy-first, spam-filter, security-automation, text-analysis, mcp ## Description You connect this server to your AI client, and it gives you total control over spam moderation without forcing you into some clunky dashboard. Your agent handles everything—from checking text content to blocking bad IPs—all right within the chat window. It's a dedicated security analyst for your platform. **Content Spam Scoring.** You can run **`check_spam`** on any piece of submitted text, like a comment or a form entry. This gives you a detailed spam score and tells you exactly why it flagged. If you got a big batch of submissions to look at, you can use **`check_bulk`** to run the same risk assessment across multiple entries at once. **IP Address Reputation.** Need to know if an IP is clean? Use **`check_ip`**. It analyzes a single address for known threats, checks its blocklist status, and tells you if it's tied up with bot activity. You can verify your connection first by running **`check_oopspam_status`** to make sure the service is online. **Email Validation.** When someone drops an email address, don't trust it blindly. Run **`check_email`**. It tells you if that format belongs to a disposable provider or if it has high spam potential. You get instant feedback on its legitimacy. **Blocking and Reporting Abuse.** If your agent confirms a bad IP, use **`add_blocked_ip`** right away; this programmatically adds the address to your block list, stopping any future traffic from that source. You can view every blocked address ever using **`list_blocked_ips`**. For suspicious content, you don't have time for manual workarounds—you just use **`submit_report`** to send a new report about what's wrong and help improve the system’s detection model. Want to see if someone else has reported something similar? You can pull up old records using **`list_reports`**. **Monitoring Usage and Trends.** To keep tabs on how much abuse you're seeing, your agent pulls stats for you. Use **`get_daily_stats`** for a quick snapshot of all the anti-spam activity that went down in the last 24 hours. For a deeper dive into platform health over time, run **`get_analytics`**. That fetches detailed reports on overall usage and historical spam trends. You can also check your account's current budget status and remaining credits with **`get_stats`**. It's all about making sure bad actors get stopped fast, without you having to jump between different moderation tools. ## Tools ### add_blocked_ip Adds an IP address to your block list, preventing any traffic from that source. ### check_bulk Runs a single check against a list of multiple submissions or entries for spam risk. ### check_email Checks an email address to determine if it is disposable, fake, or has high spam potential. ### check_ip Analyzes a single IP address for known threats, blocklist status, and association with bot activity. ### check_spam Checks a piece of text content, like a comment or form submission, for immediate spam indicators. ### check_oopspam_status Verifies that your connection to the OOPSpam service is active and working correctly. ### get_analytics Retrieves detailed reports on overall platform usage and historical spam trends. ### get_daily_stats Gets a snapshot of the anti-spam activity that happened in the last 24 hours. ### get_stats Fetches your account's current usage statistics and remaining credits. ### list_blocked_ips Shows you a list of all the IP addresses that are currently blocked by your system. ### list_reports Retrieves records of previously submitted spam reports for manual review and pattern spotting. ### submit_report Programmatically sends a new report about suspicious content or activity to improve your detection model. ## Prompt Examples **Prompt:** ``` Check this message for spam: 'Win a free iPhone now!' ``` **Response:** ``` I've analyzed the message. The Spam Score is 5/6, indicating a very high probability of spam. Would you like me to submit a report for this content? ``` **Prompt:** ``` Check if the email address test@tempmail.xyz is likely spam or disposable. ``` **Response:** ``` The email test@tempmail.xyz has a spam score of 94/100. It was flagged as a disposable email provider. The domain tempmail.xyz is on 3 major blocklists and was registered only 12 days ago. Recommendation: block this email from registration forms to protect your data quality. ``` **Prompt:** ``` Analyze whether the IP address 185.220.101.45 is associated with spam or bot activity. ``` **Response:** ``` IP 185.220.101.45 has a threat score of 87/100. It is associated with a known Tor exit node in Germany. This IP has been reported 142 times in the last 30 days for automated abuse. It appears on 5 major threat intelligence databases. Recommendation: block or challenge requests from this IP. ``` ## Capabilities ### Analyze Content Spam Score Your agent checks any submitted text (like comments or form entries) and returns a detailed spam score, telling you exactly why it flagged. ### Check IP Reputation You provide an IP address, and the server tells you if it's associated with bot activity, Tor nodes, or known threats. ### Validate Email Addresses The agent checks an email format to see if it belongs to a disposable provider or has a high probability of being spam. ### Block Malicious IPs If the AI confirms a bad IP, you use this tool to programmatically add it to your block list, stopping further abuse. ### Manage Reports and Blocks The agent lets you view past spam reports or submit new ones by simply describing what's wrong in the chat. ## Use Cases ### Reviewing a suspicious comment batch A community manager notices 30 new comments that look spammy. They ask their agent to run `check_bulk` on the whole list. The agent returns individual spam scores for each entry, allowing the manager to approve or block them in bulk without manual copy-pasting. ### Handling a suspicious form submission A developer sees a sign-up form filled out with an IP address. They ask their agent to run `check_ip` on the provided address. The result shows it's linked to a known Tor node, so they follow up by running `add_blocked_ip` immediately. ### Investigating bot activity A security analyst receives an alert about unusual traffic. They ask the agent to run `get_analytics` and look at historical data. This helps them spot a trend—like a spike in email submissions from disposable domains, which they then check using `check_email`. ### Responding to recurring spam issues After manually reviewing several reports via the chat interface (using `list_reports`), the agent helps identify that a specific pattern of phishing content keeps slipping through. The analyst then uses `submit_report` with this new context, hardening the system. ## Benefits - Block bad actors immediately. If your agent runs `check_ip` and finds a threat, you can follow up with `add_blocked_ip` to stop it right then. No dashboard switching needed. - Get full usage visibility. Use `get_stats` or `get_analytics` to see how much spam activity happened last month vs. this week. You track the trends, not just the current score. - Analyze varied inputs. It doesn't just check text. You can run `check_email` on an address or `check_bulk` on a list of comments—it handles multiple data types. - Improve your filters over time. When you find novel spam, use `submit_report` via the chat to feed that intelligence back into the system's detection logic. - Manage everything in one place. Your AI client becomes the security console. Instead of opening 5 tabs (content, IPs, reports, usage), it runs all those checks from a single conversation. ## How It Works The bottom line is: you use a simple conversation with your AI client, and it runs complex security checks against the OOPSpam service. 1. Subscribe to this server on Vinkius and grab your unique OOPSpam API Key from the dashboard. 2. Enter that API Key into your AI client settings. Now, your agent can talk to the spam filtering service. 3. Ask anything about content moderation—'Check this comment for spam,' or 'What IPs should I block?'—and get actionable data back. ## Frequently Asked Questions **How do I check if an IP address is spam using the `check_ip` tool?** You provide the agent with the IP address. The server returns a threat score, telling you if it's linked to bot activity or major blocklists. It’s fast and gives specific reasons why it flagged. **What is the difference between `check_spam` and `check_bulk`?** `check_spam` analyzes a single piece of text, giving you one score. `check_bulk` takes a list (like 10 comments) and runs the spam check on all of them in one go. **Can I use OOPSpam to block IPs directly?** Yes, if your agent confirms an IP is bad using `check_ip`, you can follow up with `add_blocked_ip` right away. This makes the mitigation part of your workflow immediate. **How do I get usage data for my anti-spam account?** Run the `get_stats` tool. It gives you a current view of your usage, which is critical before running any major batch checks like `check_bulk`. **When should I use the `check_email` tool?** Use `check_email` when you need to assess if an email address is spam or disposable. It provides a specific spam score and flags if the domain is known to be temporary. **What's the first step I take when connecting with `check_oopspam_status`?** You run `check_oopspam_status` immediately after setup. This confirms your API key works and that the connection to OOPSpam is active before you use any other tools. **How do I view my moderation history using `list_reports`?** `list_reports` returns a record of all spam reports submitted through the server. This lets you review historical content and track which reports were successful. **What data does `get_daily_stats` provide compared to general stats?** `get_daily_stats` gives you usage metrics broken down by specific dates, letting you see day-to-day trends. General stats show overall cumulative totals. **Can my AI automatically find the spam score for a specific message text?** Yes! Use the `check_spam` tool. Provide the text content, and your agent will respond with a Spam Score (0-6) and technical detection reasons in seconds. **How do I find my OOPSpam API Key?** Log in to your OOPSpam dashboard at oopspam.com, and you will find your unique secret API key displayed in the top right corner of the main page. **What does a Spam Score of 3 or higher mean?** A score of 3 or higher generally indicates a high probability that the content is spam. OOPSpam recommends flagging or rejecting content with these scores.