How to Use the Censys MCP in Vercel AI SDK

Q: How do I connect the Censys MCP Server to my Vercel AI SDK project?

Install the @ai-sdk/mcp package and initialize the client using the Vinkius HTTP transport URL. Pass the tools object directly to streamText to let your LLM query internet hosts. Remember to call the close method on the client when the stream finishes.

Q: Can my agent search for specific vulnerabilities using Censys?

Yes, searchhosts lets your agent query for specific service banners or outdated software versions. It returns IP addresses and open ports that match your query parameters.

Feed live Censys attack surface data directly into your React components with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Censys MCP to Vercel AI SDK

Create your Vinkius account to connect Censys to Vercel AI SDK 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 Censys with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Host Audits inside Vercel AI SDK UI

`get_host` retrieves open ports, service banners, and operating system details for any IP address on the internet. Your application pulls this infrastructure data live, bypassing loading spinners by streaming the raw JSON payload straight to the user's browser. You can also run `view_host_diff` to instantly show changes between two target servers. This lets your users see configuration drift or unauthorized port openings right as the agent runs the comparison.

Map Domain Networks with Censys MCP Server

`get_certificate_hosts` finds every single domain and IP address sharing an SSL/TLS certificate. It extracts Subject Alternative Names (SANs) so your agent can map out an organization's entire external footprint in one run. Use `search_certificates` alongside it to filter by certificate issuer or validity dates. This setup gives your frontend immediate visibility into expired or misconfigured certificates across thousands of endpoints.

Group Global Host Data on the Edge

`aggregate_hosts` groups internet-wide search results by ports, geographic locations, or autonomous system names. It returns bucket counts so your application can render visual charts of service distributions without heavy backend processing. If you need to keep tabs on your API usage, `get_account_info` returns your remaining quota in the same stream. Running this MCP Server on Vercel Edge Functions keeps your threat-hunting tools fast and responsive.

Setup guide

Set up Censys MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Censys tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Censys transactions",
});

console.log(text);
await mcpClient.close();

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 Censys. 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 Censys 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 Censys MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package and initialize the client using the Vinkius HTTP transport URL. Pass the tools object directly to `streamText` to let your LLM query internet hosts. Remember to call the close method on the client when the stream finishes.

Yes, this setup is fully compatible with Edge runtimes. Because Vinkius hosts the actual server, your edge code only needs to make lightweight HTTP requests to query IP addresses.

You can monitor your remaining search quota directly by calling `get_account_info`. If you hit limits, your application code can catch the error or display the remaining quota directly in the UI.

Yes, `search_hosts` lets your agent query for specific service banners or outdated software versions. It returns IP addresses and open ports that match your query parameters.

Vinkius runs the server in an isolated, zero-trust sandbox where your API keys and queried IP addresses are never logged or stored. All requests to Censys travel over encrypted connections and expire instantly after execution.

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