How to Use the EPA AirNow MCP in Mastra AI

Build reliable environmental alert workflows in Mastra AI with verified EPA data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EPA AirNow MCP to Mastra AI

Create your Vinkius account to connect EPA AirNow to Mastra AI 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 EPA AirNow with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Coordinate-based AQI checks for Mastra AI

Trigger automated alerts when air quality shifts by using `get_current_aqi_by_latlon`. Mastra AI executes this tool as part of a larger workflow, ensuring your logic reacts to real environmental changes. You define the thresholds for when an alert should fire. If the data hits a limit, the agent executes your next workflow step without human oversight.

ZIP code monitoring for Mastra AI agents

Use `get_current_aqi_by_zip` to keep regional data updated in your agent's memory. It’s perfect for workflows that need to manage air quality across multiple distinct regions. When the agent runs, it checks the latest reading. If the conditions change, the agent can trigger a notification or update your database automatically.

Predictive forecasting in Mastra AI

Fetch future air quality trends with `get_forecast_aqi_by_zip` to plan operations in advance. Mastra AI can branch your workflow based on the forecast returned. If the forecast predicts bad air, your agent can pause outdoor operations. This allows for automated scheduling changes before the pollution actually arrives.

Setup guide

Set up EPA AirNow MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All EPA AirNow tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "epa-airnow-mcp-client",
  servers: {
    "epa-airnow-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "EPA AirNow Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to EPA AirNow tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent EPA AirNow transactions"
);
console.log(result.text);

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 EPA. 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 EPA AirNow 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 EPA AirNow MCP in Mastra AI

Add the server URL to your MCP configuration. The agent will auto-detect the tools and make them available for your workflows.

Yes, you can configure Mastra AI to retry tool calls if the API request fails due to temporary network issues.

Absolutely. You can write rules in your agent that trigger different actions based on the specific AQI value returned by the tool.

The data is processed only within your defined workflow environment. Vinkius ensures the transport layer is secure and transient.

No. The server only processes the coordinates or ZIP codes you send during the request. It does not persist your location information.

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

Mastra AI sdk-typescript

Start using the EPA AirNow MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started