CrowdSec MCP Server for Mastra AIGive Mastra AI instant access to 3 tools to Get Cti Smoke, Get Decisions, Get Decisions Stream
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect CrowdSec through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The CrowdSec MCP Server for Mastra AI is a standout in the Fort Knox category — giving your AI agent 3 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"crowdsec": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "CrowdSec Agent",
instructions:
"You help users interact with CrowdSec " +
"using 3 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with CrowdSec?"
);
console.log(result.text);
}
main();
* 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
About 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.
Mastra's agent abstraction provides a clean separation between LLM logic and CrowdSec tool infrastructure. Connect 3 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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.
The CrowdSec MCP Server exposes 3 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 3 CrowdSec tools available for Mastra AI
When Mastra AI connects to CrowdSec through Vinkius, your AI agent gets direct access to every tool listed below — spanning threat-intelligence, firewall-management, ip-reputation, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Get cti smoke on CrowdSec
Get CTI reputation for an IP
Get decisions on CrowdSec
Query CrowdSec LAPI for decisions
Get decisions stream on CrowdSec
Poll for new and deleted decisions from LAPI
Connect CrowdSec to Mastra AI via MCP
Follow these steps to wire CrowdSec into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the CrowdSec MCP Server
Mastra AI provides unique advantages when paired with CrowdSec through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add CrowdSec without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every CrowdSec tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
CrowdSec + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the CrowdSec MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query CrowdSec, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed CrowdSec as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query CrowdSec on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using CrowdSec tools alongside other MCP servers
Example Prompts for CrowdSec in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with CrowdSec immediately.
"Check if there are any active decisions for IP 1.2.3.4 in our local CrowdSec database."
"Get the latest stream of decisions from CrowdSec to see recent blocks."
"What is the global reputation of IP 185.220.101.101 according to CrowdSec CTI?"
Troubleshooting CrowdSec MCP Server with Mastra AI
Common issues when connecting CrowdSec to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpCrowdSec + Mastra AI FAQ
Common questions about integrating CrowdSec MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
SendGrid Email Sender
1 toolsThis MCP does exactly one thing: it sends transactional emails using Twilio SendGrid. That's its only function, and nothing else. Incredible for giving your AI agents the ability to dispatch email reports.
WhatsApp Business Alternative
8 toolsAutomate your customer communication — send templates and manage profiles via AI.
Prometheus
14 toolsMonitor your infrastructure with Prometheus — run PromQL queries, analyze metrics, and manage time-series data directly from your AI agent.
Namsor
6 toolsAutomate name analytics via Namsor — predict gender, origin, and ethnicity directly from any AI agent.