Censys Connector for AI agents.
9 live capabilities
Map attack surfaces and find exposed internet services.
Waiting for input…
Why people use Censys
Censys for Automated Attack Surface Mapping
With this Connector, you can skip the manual labor. You just ask your agent to find all servers in a specific region or identify every host using a certain certificate. It pulls the data directly from the Censys platform and gives you a summarized list in seconds, letting you focus on fixing the problems instead of finding them.
What Vinkius changes
You get instant access to global internet scanning data through natural conversation.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding regional server clusters
A researcher wants to find all Nginx servers in Brazil.
- Real-world use case 02
Monitoring infrastructure drift
A sysadmin needs to see if a server's ports have changed in the last month.
- Real-world use case 03
Identifying certificate leaks
A threat hunter wants to see every domain using a stolen certificate.
Complete set · 9capabilities
The complete Censys capability set.
These are the exact actions your AI can choose when you ask it to work with Censys.
01—03
3 capabilities in this set.
Part of 9 available through Censys.
- 01 Capability
Get host
Pull open ports, service banners, and OS info for a specific IP address. This gives you a snapshot of a host's exposure.
- 02 Capability
Get certificate
Get full parsed data for a specific certificate using its fingerprint. This provides a deep look at the certificate's metadata.
- 03 Capability
Get certificate hosts
Find all domains and IPs that share a specific SSL certificate. It's a fast way to find related assets.
04—06
3 capabilities in this set.
Part of 9 available through Censys.
- 04 Capability
Get host history
See how a host's ports and certificates have changed over time. This is great for spotting infrastructure drift.
- 05 Capability
Search hosts
Search for internet-connected hosts using service names, ports, or locations. This is your primary way to find targets.
- 06 Capability
View host diff
Compare two hosts to identify differences in their infrastructure. Use this to find discrepancies between environments.
07—09
3 capabilities in this set.
Part of 9 available through Censys.
- 07 Capability
Aggregate hosts
Group results by fields like country or port to see distribution patterns. This helps you understand the layout of a target's infrastructure.
- 08 Capability
Get account info
Check your remaining API quota and account limits quickly. This helps you stay within your plan's limits.
- 09 Capability
Search certificates
Search for SSL/TLS certificates using issuers, subjects, or validity dates. Use this to find specific certificate types.
Set up in minutes
One URL. Then ask Censys to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Censys from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Censys, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Censys for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Censys URL.
- Step 03
Save and start
Save the connection and enable Censys in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"censys": {
"url": "https://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Censys
Open Agent mode in chat and ask: "Using Censys, help me...". 9 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"censys": {
"url": "https://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Censys
Ask Copilot: "Using Censys, help me...". 9 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"censys": {
"url": "https://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Censys
Open Cascade and ask: "Using Censys, help me...". 9 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"censys": {
"url": "https://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Censys
Ask Cline: "Using Censys, help me...". 9 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add censys --transport http "https://edge.vinkius.com/vk_preview_s8bUKfbc9OS3leqa10RhKd63iRfAGn5ERJCnUH87/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Censys
Ask Claude: "Using Censys, show me...". 9 tools are ready
Where the request belongs
Work Censys can move forward.
This is for security pros who are tired of manual reconnaissance. If you spend your day hunting for exposed databases, tracking certificate leaks, or mapping out attack surfaces, this capability removes the friction of manual searching.
Security Researcher
Finds exposed services and tracks vulnerabilities across the web to build threat intelligence.
Sysadmin
Monitors their own company's external exposure to find and fix misconfigurations before someone else does.
Threat Hunter
Tracks certificate usage and identifies suspicious infrastructure links to stop attacks early.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsSecurityTrails
Uncover IT infrastructure. access DNS history, subdomains, reverse IP lookups, WHOIS data and advanced domain intelligence for ultimate OSINT.
Shodan
Search for internet-connected devices, analyze open ports, discover vulnerabilities and explore the IoT landscape.
Nmap Online
Perform network discovery and security auditing via Nmap. track port scans, DNS lookups, and traceroutes directly from your AI agent.
CrowdSec
Automate threat intelligence via CrowdSec. query local decisions, stream security updates, and check global IP reputation directly from any AI agent.
UpGuard
Monitor your attack surface and assess vendor security risks with continuous scanning that identifies vulnerabilities before attackers do.
Intruder
Automate vulnerability scanning and security monitoring via Intruder.io API.
Bring your own AI
Change the model, client or framework. Keep Censys connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Censys.
The practical details behind the request, access and result.
Can the Censys MCP find exposed databases?
Yes, it can. You can ask your agent to search for specific service ports and banners associated with common database software to find exposed instances.
How does the Censys MCP help with certificate leaks?
It allows you to find every host using a specific certificate fingerprint. This helps you identify if a certificate has been deployed on unauthorized domains.
Can I use the Censys MCP to see historical changes?
Yes, you can. It tracks how the ports, services, and certificates on a specific IP address have changed over time based on previous scans.
Does the Censys MCP support geographic searches?
Yes, it does. You can filter search results by country, region, or specific geographic locations to find internet-connected hosts in those areas.
Can the Censys MCP help with attack surface mapping?
Absolutely. It provides a way to query global internet data to see what services, ports, and certificates are publicly visible for any target.
Is the Censys MCP good for finding specific OS versions?
Yes, it returns OS detection data along with service banners for any IP you query, helping you identify the software running on a remote host.
How do I get Censys API credentials?
Sign up for a free account at censys.io, go to your account page and generate API credentials. Free tier includes limited queries per day.
What kind of hosts can I find?
Censys scans the entire IPv4 space regularly. You can find web servers, databases, SSH servers, mail servers, IoT devices, industrial control systems and any internet-facing service.
What query syntax is supported?
Censys supports powerful query syntax: service name (services.service_name: HTTP), port (services.port:443), certificate fields (parsed.subject.country: US), OS detection (metadata.os: Linux), ASN, geographic location and boolean operators (AND, OR, NOT).
One connection away
Give your agent a direct line to Censys.
Connect Censys once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available