# IPQualityScore (IPQS) MCP > IPQualityScore (IPQS) delivers real-time security checks for IPs, emails, URLs, and phone numbers. Use this MCP to immediately vet user input against known fraud patterns, proxies, or malicious activity. It helps developers build robust sign-up flows and automates risk assessment across your entire platform. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** fraud-detection, risk-management, bot-detection, email-verification, identity-verification ## Description Running a modern application means handling bad data—fraudulent accounts, bot traffic, suspicious links. This connector gives your AI agent the ability to vet user inputs before they impact your system. You can check an IP address for proxy usage or fraud scores; verify if an email is deliverable and legitimate; or analyze a URL to see if it's linked to malware. These checks happen instantly, letting you block bad traffic at the source. When integrating this into your existing agent workflows through Vinkius, you get immediate access to industry-leading security intelligence. This lets developers build trust and keep user bases clean automatically. ## Tools ### email_lookup Analyzes an email address and returns a fraud risk score, helping prevent fraudulent accounts during registration. ### get_account Retrieves current usage details about your IPQS account plan and configuration status. ### get_credits Provides the remaining credit balance, ensuring the service stays active within your allocated quota. ### ip_lookup Returns fraud scores, proxy/VPN detection results, and geographical data. Essential for identifying malicious users or automated bots during sign-up or transaction processes. Analyzes an IP address for fraud and proxy detection ### list_conversions Lists records of tracked conversions, useful for auditing e-commerce or affiliate marketing activity. ### list_fraud Gathers recent logs detailing fraud events and security triggers for high-level threat monitoring. ### list_reports Provides a list of recent security reports and audit findings related to platform usage. ### list_stats Lists overall account usage statistics, helping you monitor the health and volume of your integration. ### phone_lookup Analyzes a phone number to return its line type and an indicator of potential fraud risk for identity verification. ### url_lookup Returns a comprehensive risk score and classification for any URL, useful when auditing suspicious links. ## Prompt Examples **Prompt:** ``` Analyze the IP address 8.8.8.8 for fraud risk. ``` **Response:** ``` I'll perform an IP lookup using IPQS to check for any malicious indicators. ``` **Prompt:** ``` Verify if the email address 'fraudster@test.com' is risky. ``` **Response:** ``` I'll use IPQS email validation to check the risk score for that address. ``` **Prompt:** ``` Check this URL for potential malware: http://malicious-site.com ``` **Response:** ``` I'll perform a malicious URL lookup with IPQS for you. ``` ## Capabilities ### Vet User Emails Checks an email address for fraud risk and determines if it's safe for new account registrations. ### Analyze IP Addresses Provides detailed scores on an IP, flagging potential proxies, VPN use, or signs of automated bot activity. ### Scan URLs Returns a risk score and classification for any website link provided by users, catching malicious sites. ### Check Phone Numbers Analyzes phone numbers to determine line type and overall risk level for identity verification. ## Use Cases ### Onboarding a New Enterprise Client A developer needs to ensure that all incoming API requests from a new client are legitimate. Instead of manually checking IPs, the agent first calls ip_lookup on every source IP and then uses email_lookup on all associated contacts, guaranteeing high quality leads before they enter the pipeline. ### Moderating User-Generated Content A content moderator finds a suspicious link posted in a forum thread. The agent intercepts the URL and runs url_lookup immediately. If the score is high, the system blocks the post and alerts a human reviewer. ### Preventing Account Takeover A user attempts to reset their password using an old or suspicious phone number. The agent uses phone_lookup on the provided number; if the risk score is too high, it forces the user through manual identity verification instead of proceeding with the password reset. ### E-commerce Fraud Investigation An analyst needs to check a batch of conversion data. They use list_conversions combined with calling list_fraud logs to correlate suspicious purchase patterns with known fraud events, speeding up manual investigations. ## Benefits - Stop fraud at the door. When a new user signs up, use email_lookup and ip_lookup to immediately score their credentials against known bot or fraudulent patterns. - Manage high-risk links automatically. Any time a user submits an external URL—maybe in a profile bio or a message—run url_lookup before letting them post it. - Audit account health with built-in tools. You can call get_credits and list_stats to keep track of your service usage without needing custom dashboards. - Verify identity using phone number data. Use phone_lookup on incoming contact data to confirm if the number is a standard line or potentially spoofed. - Build compliance reports easily. Calling list_fraud and list_reports lets your agent gather necessary security logs for quick auditing purposes. ## How It Works The bottom line is your AI client gets instant security intelligence on any user-provided data point, letting you make smart decisions immediately. 1. Your AI client sends the data—like an IP address or a user's email—to this MCP. 2. The connector performs a real-time lookup against global fraud and reputation databases. 3. You receive structured risk scores, flags, and detailed findings that tell you if the input is safe to use. ## Frequently Asked Questions **How often do I need to call the IPQualityScore (IPQS) MCP?** You should use this MCP anytime user-provided input is critical, such as during sign-up flows or when processing external links. Calling it proactively prevents fraud before it happens. **Does IPQualityScore (IPQS) help with bot detection?** Yes. The ip_lookup tool specifically analyzes IPs for signs of automated activity, detecting if a user is connecting through known proxies or VPNs used by bots. **Can I use this MCP for e-commerce auditing?** Absolutely. You can call list_conversions and list_fraud to audit purchase patterns and identify potential fraudulent transactions on your platform. **What is the difference between ip_lookup and url_lookup?** ip_lookup checks the source of a connection (the IP address) for fraud or proxy detection. url_lookup analyzes the content of a link itself to score its malicious potential. **How do I check if an email is spam using IPQualityScore (IPQS)?** Use the email_lookup tool. It doesn't just check for syntax; it analyzes the domain and history against global fraud databases to give you a proper risk score.