How to Use the IPQualityScore (IPQS) MCP in Pydantic AI

Catch bad actors with type-safe fraud detection using Pydantic AI and real-time IPQS intelligence.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IPQualityScore (IPQS) MCP to Pydantic AI

Create your Vinkius account to connect IPQualityScore (IPQS) to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup IPQualityScore (IPQS) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enforce type-safe lookups in Pydantic AI

`email_lookup` analyzes an email address for fraud and deliverability, returning structured data that your agent validates at runtime. Pydantic AI guarantees that every risk score and domain flag matches your exact schemas. If your agent needs to check phone details, `phone_lookup` analyzes a phone number for fraud and risk. If the API returns unexpected fields, your agent fails loudly instead of letting corrupted data slip through your registration flow.

Audit network traffic with an MCP Server

`ip_lookup` analyzes an IP address for fraud and proxy detection to identify high-risk VPNs or residential proxies. This tool ensures your agent has clean, structured network data to make routing decisions using the MCP Server. For link safety, `url_lookup` analyzes the URL for malicious activity to block phishing campaigns. Your agent parses the structured response to instantly quarantine dangerous links before they get saved.

Manage API health and billing limits

`get_credits` retrieves credit usage and balance information to keep your system within its monthly budget. Your agent can run this check on a schedule to ensure you never run out of API credits. To verify plan configurations, `get_account` retrieves details about your IPQS account. This lets your agent confirm that your subscription tier has the correct permissions before executing high-volume audits.

Setup guide

Set up IPQualityScore (IPQS) MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "ipqualityscore-ipqs-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to IPQualityScore (IPQS) tools.",
)

result = await agent.run("List recent IPQualityScore (IPQS) transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IPQualityScore. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect IPQualityScore (IPQS) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about IPQualityScore (IPQS) MCP in Pydantic AI

Install the Pydantic AI MCP package and import the toolset class. Define your server URL using the HTTP transport, then pass the toolset instance directly into your Agent constructor. The agent will auto-discover the tools.

It enforces strict runtime validation on every response. If the IP lookup data structure changes or fails, the framework catches the validation error immediately. This prevents silent failures in your security pipeline.

Yes, your agent can call the stats tool to fetch integration health metrics. The response is parsed directly into a type-safe model, allowing your agent to safely log or display the data without parsing raw JSON strings.

The framework catches standard HTTP errors and exposes them to your agent. You can write error-handling blocks to retry the request or fall back to a default risk score. This keeps your application resilient.

All lookup requests are processed in memory within an ephemeral MCP sandbox on Vinkius. No email addresses or phone numbers are stored on disk. The data is securely transmitted to the API endpoint and discarded immediately after validation.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript