How to Use the EPA AirNow MCP in VS Code Copilot

Equip your entire engineering team with live EPA AirNow data inside VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect EPA AirNow to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query federal sensors via VS Code Copilot

The `get_current_aqi_by_zip` tool pulls live air quality metrics directly into your editor's chat panel. You just drop a 5-digit US ZIP code into the prompt, and the agent fetches the current PM2.5 and ozone levels. It stops you from context-switching to browser tabs when you need quick environmental data. If you need exact spatial precision, `get_current_aqi_by_latlon` handles geographic coordinates. The MCP Server routes the request to the closest federal monitoring station and hands the raw observation data back to your workspace.

Feed forecasts into your test data

The `get_forecast_aqi_by_zip` tool retrieves official EPA predictions for any US region. When your team builds automated alert systems, they can use this tool to pull real upcoming hazard categories. It beats writing mock data scripts from scratch. Your AI client reads the forecast and can instantly format it into whatever schema your application requires. You ask for a JSON array of tomorrow's AQI values, and it generates the exact payload you need for your test environment.

Standardize team access

You can commit the configuration for these tools directly into your repository. By adding the settings to `.vscode/mcp.json`, every developer on your team gets instant access to the EPA endpoints the moment they pull the repo. Nobody has to manually configure API headers or read the federal documentation. The tools sit right in the chat panel, ready to execute whenever someone needs to verify how the application handles poor air quality conditions.

Setup guide

Set up EPA AirNow MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the EPA AirNow MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the EPA AirNow tools listed. Try asking: "List my recent EPA AirNow transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "epa-airnow-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 VS Code Copilot

Create a .vscode/mcp.json file in your project root and commit it to Git. Anyone who pulls the repository will automatically load the tools in their editor.

You likely need to update your editor. This integration requires VS Code version 1.96 or higher and an active Copilot subscription with Agent mode enabled.

No. The current tools only support real-time observations and future forecasts. The federal API handles historical data through different endpoints not exposed here.

No. The tools work on individual Copilot accounts as long as you configure the local JSON file correctly and provide a valid API key.

The ZIP codes and coordinate pairs you query are sent to the federal API to fetch the AQI metrics. Vinkius routes this through an ephemeral, stateless sandbox, guaranteeing your geographic targets are never stored or analyzed.

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