How to Use the USGS Earthquakes MCP in Vercel AI SDK

Q: How do I search global earthquakes using USGS Earthquakes with the Vercel AI SDK?

Call queryearthquakes and pass in your parameters like starttime or minmagnitude. Because you're using the Vercel AI SDK, these results stream directly to the user interface, giving them instant feedback.

Q: Is the countearthquakes function compatible with Vercel AI SDK?

Absolutely. You can call countearthquakes and stream that single numerical result directly into your UI element, making it look like a live counter.

Show live seismic data streams in React, Next.js, Svelte, or Vue using 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 USGS Earthquakes MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time USGS Earthquakes Data Streaming

When your agent calls `query_earthquakes`, the data streams directly into the UI. You don't show a loading spinner; users see earthquake events appear live as the results stream from the MCP Server. The Vercel AI SDK handles this streaming perfectly, letting you build user-facing tools where the seismic data updates in real time. This makes monitoring global activity feel instant and immediate.

Quick Global Earthquake Counts via MCP Server

Need a simple metric? Use `count_earthquakes` to get the total count matching specific criteria instantly. It’s perfect for dashboards where you just need one number—say, 'Total events in this radius.' This fast function avoids complex queries and gives you an immediate snapshot of activity. You'll stream that count directly into your React component using `streamText`.

Getting Major Earthquakes from the Last 30 Days

The `get_significant_30_days` tool pulls highly significant global earthquake data right off the USGS network. It requires zero parameters, making it a reliable default view for monitoring general activity. You pass this function result to your agent, and the Vercel AI SDK ensures that even large datasets stream smoothly into the user's browser.

Setup guide

Set up USGS Earthquakes 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 USGS Earthquakes 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 USGS Earthquakes 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 USGS. 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 USGS Earthquakes 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 USGS Earthquakes MCP in Vercel AI SDK

Call `query_earthquakes` and pass in your parameters like starttime or minmagnitude. Because you're using the Vercel AI SDK, these results stream directly to the user interface, giving them instant feedback.

Yes. The entire point is that tool results stream live into your frontend. You'll see the seismic data appearing in real time, which is far better than waiting for a single JSON blob.

You can narrow the search using latitude/longitude boundaries and setting a maxradiuskm. The tool supports querying specific time windows, so you control exactly what data gets streamed.

Absolutely. You can call `count_earthquakes` and stream that single numerical result directly into your UI element, making it look like a live counter.

The server handles real-time seismic event data. This includes magnitude, time stamps, and geographic coordinates (latitude/longitude) of recorded earthquakes.

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