How to Use the Google Air Quality MCP in OpenAI Agents SDK

Give your OpenAI Agents SDK systems real-time Google Air Quality data to make safety-first decisions based on live pollution metrics.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Air Quality MCP to OpenAI Agents SDK

Create your Vinkius account to connect Google Air Quality to OpenAI Agents 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 Google Air Quality with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build air-aware agents with OpenAI Agents SDK

The `get_current_air_quality` tool lets your OpenAI Agents SDK inspect current pollutants and AQI values via Google's API to protect users from high-risk environments. Your agent uses this tool to grab real-time data on PM2.5, PM10, and ozone before recommending outdoor activities or sending health alerts. By connecting this tool to your agent loop, the OpenAI Agents SDK handles the discovery and execution flow automatically to fetch live Google Air Quality metrics. You get immediate access to raw pollution numbers without writing custom HTTP wrappers or parsing complex JSON payloads manually.

Analyze historical trends in OpenAI Agents SDK

The `get_air_quality_history` tool pulls historical atmospheric data directly into your OpenAI Agents SDK pipeline to analyze seasonal pollution patterns. This allows your agent to compare today's readings with past trends to detect recurring pollution spikes in specific urban zones. With the OpenAI safety guardrails in place, you enforce validation rules on this historical Google Air Quality data before passing it to downstream agents. You don't have to worry about your agent misinterpreting the dates or making up trend lines.

Run Google Air Quality checks using OpenAI Agents SDK

This Google Air Quality MCP Server exposes both `get_current_air_quality` and `get_air_quality_history` directly to the OpenAI Agents SDK streamable HTTP transport to keep your agent's context window clean. The server exposes the exact tools your agent needs to fetch current air metrics without exposing unnecessary backend logic. Your python code initializes the connection with a simple HTTP stream, allowing OpenAI Agents SDK to auto-discover both atmospheric tools instantly. This setup keeps your agent focused on making decisions rather than managing API handshakes.

Setup guide

Set up Google Air Quality MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Google Air Quality tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Google Air Quality tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Google Air Quality tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Google Air Quality Agent",
            instructions="You have access to Google Air Quality tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Google Air Quality. 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 Google Air Quality 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 Google Air Quality MCP in OpenAI Agents SDK

Install the SDK and register the Google Air Quality MCP Server using the `MCPServerStreamableHttp` client in your OpenAI Agents SDK project to fetch AQI metrics. The SDK automatically discovers `get_current_air_quality` and `get_air_quality_history` for immediate use in your agent loops.

Yes, the server exposes its tools directly to the OpenAI Agents SDK when you initialize the connection. Your agent gets instant access to `get_current_air_quality` and calls it during a conversation without manual tool registration.

You control access by passing specific tool lists or routing logic within your OpenAI Agents SDK configuration. This restricts whether an agent calls `get_air_quality_history` or keeps it limited to current readings over MCP.

The server passes Google's rate limit headers back to the OpenAI Agents SDK so your application can handle atmospheric query throttling gracefully. This prevents your agent from hitting API blocks during high-frequency lookups.

Your latitude and longitude coordinates are sent directly through an encrypted V8 sandbox connection to fetch the Google Air Quality metrics for OpenAI Agents SDK over MCP. Vinkius does not store these coordinates, and they are destroyed as soon as the API call completes.

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