Iqair airvisual MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Iqair airvisual MCP or direct API to fetch real-time AQI, check historical air pollution, get air quality alerts, and monitor specific locations through natural language.

Iqair airvisual logoIqair airvisual
Api Key

Iqair airvisual is an API service providing real-time and historical global air quality data. It helps users monitor pollution levels for healthier decision-making.

10 Tools

Try Iqair airvisual now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Iqair airvisual
Try asking
TOOLS

Supported Tools

Every Iqair airvisual action and event your agent gets out of the box.

Get Air Quality Forecast Data

Tool to retrieve air quality forecast data for a specified city, state, and country.

Get Cities

Tool to list supported cities in a specified state and country.

Get City Air Quality

Tool to retrieve air quality data for a specific city.

Get supported countries

Tool to list all supported countries.

Get Historical AQI Data

Tool to retrieve historical air quality data for a city.

Get Nearest City Air Quality

Tool to retrieve air quality data for the nearest city based on latitude/longitude or IP.

Get Nearest Station Air Quality

Tool to get nearest station air quality.

Get States

Tool to list supported states in a specified country.

Get Station by ID

Fetches current air quality and weather data for a specific location by station/city/state/country names.

Get World AQI Rankings

Retrieves air quality ranking data.

SETUP GUIDE

Connect Iqair airvisual MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["iqair_airvisual"],
  mcp: true,
});
Create a session scoped to Iqair airvisual and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Show me today’s air quality forecast for Los Angeles, CA, USA",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Iqair airvisual request
SETUP GUIDE

Connect Iqair airvisual API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["iqair_airvisual"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Iqair airvisual
3

Run Iqair airvisual tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Show me today’s air quality forecast for Los Angeles, CA, USA" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Iqair airvisual tool calls through the session, and print the final answer

Why Use Composio?

AI Native Iqair airvisual Integration

  • Supports both Iqair airvisual MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Iqair airvisual data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Iqair airvisual access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Iqair airvisual
  • Scoped, least privilege access to Iqair airvisual resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Iqair airvisual requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Iqair airvisual.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Iqair airvisual tool your agent needs.Free to start.

Start building