Bring Threat Intelligence
to Pydantic AI
Learn how to connect CrowdSec to Pydantic AI and start using 3 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the CrowdSec MCP Server?
Connect your CrowdSec security engine to any AI agent to take full control of your threat intelligence and network defense through natural conversation.
What you can do
- Local Decisions — Query your Local API (LAPI) for active blocks or decisions on specific IPs, ranges, or scopes to understand current local threats.
- Decision Streaming — Poll for real-time updates on new and deleted decisions from your local database to keep your security context synchronized.
- Global CTI Reputation — Fetch global IP reputation data, behaviors, and classifications from the CrowdSec Community Threat Intelligence (CTI) network.
- Security Auditing — Inspect metadata and classifications for suspicious actors directly from your command interface or code editor.
How it works
- Subscribe to this server
- Enter your CrowdSec LAPI URL, LAPI Key, and CTI Key
- Start managing your security posture from Claude, Cursor, or any MCP-compatible client
No more manual log diving or complex CLI commands to check if an IP is malicious. Your AI acts as a dedicated security analyst.
Who is this for?
- Security Engineers — instantly retrieve local decision statuses and global reputation metrics without leaving the terminal
- DevOps Teams — monitor security streams and verify IP behaviors during incident response directly from the IDE
- System Administrators — automate the auditing of blocked ranges and suspicious network activity through natural language
Built-in capabilities (3)
Get CTI reputation for an IP
Query CrowdSec LAPI for decisions
Poll for new and deleted decisions from LAPI
Why Pydantic AI?
Pydantic AI validates every CrowdSec tool response against typed schemas, catching data inconsistencies at build time. Connect 3 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your CrowdSec integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your CrowdSec connection logic from agent behavior for testable, maintainable code
CrowdSec in Pydantic AI
CrowdSec and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect CrowdSec to Pydantic AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for CrowdSec in Pydantic AI
The CrowdSec MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 3 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Pydantic AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
CrowdSec for Pydantic AI
Every tool call from Pydantic AI to the CrowdSec MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I check if a specific IP address is currently blocked in my local CrowdSec instance?
Yes! Use the get_decisions tool providing the IP address. Your agent will query your Local API and return any active decisions, including the reason and duration of the block.
How do I see the latest security threats detected by my server in real-time?
You can use the get_decisions_stream tool. This allows your agent to poll for new and deleted decisions, giving you a clear view of recent security activity on your infrastructure.
Can I verify an IP's global reputation even if it hasn't attacked my server yet?
Absolutely. The get_cti_smoke tool queries the global CrowdSec CTI network. It provides background information, attack behaviors, and risk scores for any IP based on community data.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your CrowdSec MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
Namely
10 toolsManage HRIS data via Namely — track employee profiles, job info, and organization groups directly from your AI agent.
Lanhu
10 toolsProduct design collaboration platform — manage design files, handoffs, and team feedback via AI.
Files.com
8 toolsSync, share, and automate file workflows across teams with secure cloud storage that integrates with your existing tools.
DealHub CPQ
10 toolsManage CPQ and sales via DealHub — create quotes, track opportunity stages, manage users, and sync CRM data directly from any AI agent.