# IPQualityScore MCP for AI Agents AI Agent Connect

> IPQualityScore (IPQS) MCP lets your AI agents perform real-time fraud detection and risk analysis. It checks IPs, emails, URLs, and phone numbers to block bots, proxies, and malicious actors. Use it to secure your sign-up flows and transaction processes by identifying high-risk activity instantly.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SOdbmZyaqTjAOKoZN2rq6u17UbrHXADrZ25Rej8D/ai-agent-connect
- **Tags:** fraud-detection, risk-management, bot-detection, email-verification, identity-verification

## Description

This Connector lets your AI agent act as a security gatekeeper for your platform. Instead of just accepting every sign-up, your agent can now verify the identity behind each request. It checks if an IP belongs to a known proxy or a malicious bot, looks for burner emails, and scans URLs for threats before they reach your users. It's a proactive way to handle risk management without adding friction to the user experience. By connecting this through the Vinkius catalog, you give your AI the data it needs to make smart decisions about who gets into your system. You stop worrying about fake accounts and start focusing on real users.

## Tools

### email_lookup
Validates an email address for fraud risk and deliverability. Use this to vet new registrations and block fake accounts.

### get_account
Retrieves your IPQS account details and current plan status. Use this to verify your configuration.

### list_conversions
Lists tracked conversions for auditing e-commerce or affiliate data. Use this to audit your marketing performance.

### list_fraud
Retrieves recent fraud event logs for high-level security auditing. It helps you monitor ongoing threats to your platform.

### list_reports
Lists recent fraud reports to see what's triggering security alerts. Use this for regular security health checks.

### list_stats
Shows usage statistics for your account to monitor integration health. It helps ensure you stay within your limits.

### phone_lookup
Analyzes a phone number for risk indicators and line types. Use this for identity verification and fraud prevention.

### get_credits
Checks your remaining credit balance and usage information. It ensures your service stays active.

### ip_lookup
Gets fraud scores, proxy/VPN detection, and geo-data for an IP address. It helps identify malicious users or bots during sign-up.

### url_lookup
Checks a URL for malicious activity and provides a risk classification. This helps audit links provided by users.

## Prompt Examples

**Prompt:** 
```
Is this IP 8.8.8.8 risky?
```

**Response:** 
```
I'll check that IP for you using IPQualityScore.

| Metric | Result |
| :--- | :--- |
| **Fraud Score** | Low Risk |
| **Proxy/VPN** | No |
| **Country** | United States |

This IP appears to be a standard consumer connection with no major red flags.
```

**Prompt:** 
```
Check if the email 'scammer123@tempmail.com' is a burner.
```

**Response:** 
```
I've checked that email address.

**Risk Score:** 88/100 (High Risk)
**Reason:** This address is associated with a known temporary mail provider. I recommend blocking this registration to prevent a burner account.
```

**Prompt:** 
```
Are there any recent fraud alerts?
```

**Response:** 
```
I've pulled the latest fraud reports for you:

* **Event 1:** High-risk IP detected from [Country] - *2 minutes ago*
* **Event 2:** Multiple failed phone verifications - *15 minutes ago*
* **Event 3:** Blocked URL for phishing - *1 hour ago*

Your security filters are actively catching these attempts.
```

## Capabilities

### Check IP risk scores
Get immediate fraud data and proxy detection for any IP address.

### Validate email addresses
Verify deliverability and risk for new user registrations.

### Scan URLs for threats
Identify malicious links and suspicious websites in real-time.

### Verify phone numbers
Check line types and risk indicators for identity verification.

### Monitor fraud logs
Review recent security triggers and fraud event history.

### Track account usage
View your current credit balance and integration stats.

## Use Cases

### Automated Sign-up Vetting
A new user signs up and your agent runs email_lookup and ip_lookup to decide if the account is worth creating or if it's a bot.

### Transaction Risk Check
A customer places a high-value order and the agent checks the IP and phone number for high-risk indicators before the payment goes through.

### Malicious Link Filtering
A community member posts a link and your agent scans it with url_lookup to ensure it's not a phishing site before it goes live.

### Fraud Audit Report
A manager asks for a summary of recent attacks and the agent pulls data from list_fraud and list_reports to summarize the activity.

## Benefits

- Stop bots instantly: Use ip_lookup to identify and block automated traffic before it hits your database.
- Reduce chargebacks: Leverage phone_lookup and email_lookup to verify identities and prevent fraudulent transactions.
- Clean your user base: Use email_lookup to weed out burner accounts during the registration process.
- Audit security history: Quickly review list_fraud and list_reports to see where your platform is being targeted.
- Monitor system health: Keep track of your API limits and status using get_credits and list_stats.
- Secure external links: Use url_lookup to automatically flag or block dangerous links shared by users.

## How It Works

The bottom line is that your AI agent handles the heavy lifting of security vetting so you don't have to manually screen every user.

1. Connect your AI client to the IPQS MCP through Vinkius.
2. Provide the agent with the specific data point to check, like an IP or email.
3. Receive a structured risk score and classification to decide whether to allow or block the action.

## Frequently Asked Questions

**How does IPQualityScore help stop bots?**
It identifies IP addresses associated with automated traffic and proxies. Your AI agent can use this to block bots before they interact with your site.

**Can I use IPQualityScore for my e-commerce store?**
Yes. It helps reduce chargebacks by verifying phone numbers and checking IP risk scores during the checkout process.

**How does this tool verify phone numbers?**
It checks the line type and risk indicators of a phone number. This helps ensure users are providing real numbers rather than VOIP or high-risk lines.

**Does IPQualityScore check for malicious URLs?**
Yes. It scans URLs for malicious activity and provides a risk score, which helps protect your users from phishing and malware.

**Can I see my fraud history with this Connector?**
You can. Your agent can pull recent fraud event logs and reports to show you exactly what threats your system has blocked.

**Is IPQualityScore good for email verification?**
It's excellent for fraud prevention. It checks for deliverability and risk scores to help you weed out burner accounts during signup.

**How do I get IPQS API credentials?**
Log in to your IPQS account and navigate to Account Settings to find your Private API Key.

**Which lookups are supported?**
This Connector supports real-time lookups for IP addresses, email addresses, URLs, and phone numbers.

**Can I see my credit balance?**
Yes, the get_credits tool provides details about your remaining credits and usage statistics.