# Ambee — how to use (mcp.ai)

Connect your Ambee account and use 27 tools for developer tools straight from your AI agent. Connect with your own API key. Ambee provides real-time, hyperlocal environmental data through APIs, offering insights into air quality, weather, pollen, and more.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ambee?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `ambee_geocode_by_place`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ambee`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/ambee/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ambee/geocode/by/place` — Tool to transform a place name or address into geographic coordinates. Use after confirming the location name to get precise latitude and longitude.
  - body: { place: string }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/by/city` — Tool to retrieve real-time air quality data for a specific city. Use after obtaining a valid city name when current AQI and pollutant levels are needed.
  - body: { city: string, limit?: integer }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/by/country/code` — Tool to retrieve real-time air quality data for a specific country using a 3-letter ISO code. Use after acquiring the country code and when you want a national overview of air quality.
  - body: { limit?: integer, countryCode: string }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/by/lat/lng` — Tool to retrieve real-time air quality data for a specific latitude and longitude. Use when you need hyper-local air quality readings for given coordinates.
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/by/postal/code` — Retrieve real-time air quality data for a specific postal code and country. Returns comprehensive air quality metrics including pollutant concentrations (PM2.5, PM10, CO, NO2, O3, SO2), Air Quality In
  - body: { postalCode: string, countryCode: string }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/forecast/by/lat/lng` — Tool to retrieve air quality forecast for a specific latitude and longitude. Use when you need predicted air quality data up to 48 hours in advance based on geographic coordinates.
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/air/quality/history/by/lat/lng` — Tool to retrieve historical air quality data for a specific latitude and longitude. Use when you need past air quality readings for given coordinates within the last 2 days.
  - body: { to?: string, lat: number, lng: number, from: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/by/continent/latest` — Tool to retrieve latest natural disaster data for a specific continent. Use when you need up-to-date disaster information by continent code.
  - body: { page?: integer, limit?: integer, continent: string, eventType?: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/history` — Tool to retrieve global historical natural disaster data with date range filtering. Use when you need to search disaster events from a specific starting date onwards.
  - body: { from: string, page?: integer, limit?: integer, eventType?: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/history/by/country/code` — Tool to retrieve historical natural disaster data for a country by ISO country code. Use when you need past disaster information for a specific country within a given date range.
  - body: { to: string, from: string, page?: integer, limit?: integer, eventType?: string, countryCode: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/history/by/lat/lng` — Tool to retrieve historical natural disaster data for a specific location by coordinates with date range. Use when you need historical disaster information for a geographic point within the past month
  - body: { to: string, lat: number, lng: number, from: string, page?: integer, limit?: integer, eventType?: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/latest/by/country/code` — Tool to retrieve latest natural disaster data for a specific country using ISO country code. Use when you need up-to-date disaster information for a particular country.
  - body: { page?: integer, limit?: integer, eventType?: string, countryCode: string }
- `POST https://api.mcp.ai/api/ambee/get/disasters/latest/by/lat/lng` — Tool to retrieve latest natural disaster data (earthquakes, floods, droughts, volcanic eruptions) for a specific location using geographic coordinates. Use when you need up-to-date disaster informatio
  - body: { lat: number, lng: number, page?: integer, limit?: integer, eventType?: string }
- `POST https://api.mcp.ai/api/ambee/get/elevation/by/lat/lng` — Tool to retrieve elevation statistics (min, max, mean) for a specific latitude and longitude. Use when you need geospatial elevation data for a location within North America.
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/elevation/by/place` — Retrieve elevation statistics (minimum, maximum, and mean) for a location by place name. Returns elevation data in meters above sea level. This endpoint has global coverage and is updated every 6 mont
  - body: { place: string }
- `POST https://api.mcp.ai/api/ambee/get/fire/risk/by/lat/lng` — Tool to retrieve fire risk forecast and Fire Weather Index (FWI) data for specific geographic coordinates. Use when you need weekly fire risk predictions for a location over the next four weeks based 
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/ili/forecast/by/lat/lng` — Tool to retrieve up to 28-day forecast of Influenza-like Illness (ILI) risk using latitude and longitude. Use when you need daily ILI risk levels for a specific location, optionally including pollen a
  - body: { lat: number, lng: number, details?: boolean }
- `POST https://api.mcp.ai/api/ambee/get/pollen/forecast/by/place` — Tool to retrieve 48-hour pollen forecast for a specific location by place name. Use when you need hourly pollen count predictions including grass, tree, and weed pollen levels with risk assessments.
  - body: { place: string, speciesRisk?: boolean }
- `POST https://api.mcp.ai/api/ambee/get/pollen/history/by/place` — Tool to retrieve historical pollen data for a specific place name. Use after obtaining a valid place name and time range when historical pollen counts and risk levels are needed.
  - body: { to: string, from: string, place: string }
- `POST https://api.mcp.ai/api/ambee/get/pollen/latest/by/lat/lng` — Tool to retrieve latest pollen data for a specific geographic location using latitude and longitude coordinates. Use when you need current pollen concentration levels and risk assessments for grass, t
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/pollen/latest/by/place` — Tool to retrieve latest pollen data for a specific place by name. Use when current pollen count and risk levels are needed for allergy awareness.
  - body: { place: string }
- `POST https://api.mcp.ai/api/ambee/get/weather/forecast/by/lat/lng` — Tool to retrieve weather forecast for a specific latitude and longitude (up to 72 hours). Use when you need predicted weather data based on geographic coordinates with customizable time intervals.
  - body: { lat: number, lng: number, filter?: string }
- `POST https://api.mcp.ai/api/ambee/get/weather/latest/by/lat/lng` — Tool to retrieve current weather data for a specific latitude and longitude, including temperature, pressure, humidity, and wind conditions. Use when you need real-time weather information for given c
  - body: { lat: number, lng: number }
- `POST https://api.mcp.ai/api/ambee/get/wildfire/by/lat/lng` — Retrieves real-time wildfire data for a specific geographic location using latitude and longitude coordinates. Returns nearby wildfire incidents including both detected fires (from satellite imagery) 
  - body: { lat: number, lng: number, type?: string }
- `POST https://api.mcp.ai/api/ambee/get/wildfire/by/place` — Retrieves real-time wildfire data for a specific location by place name. Returns wildfire incidents from the last 7 days including both satellite-detected fires and officially reported fires. Each rec
  - body: { type?: string, place: string }
- `POST https://api.mcp.ai/api/ambee/get/wildfire/risk/forecast/by/place` — Tool to retrieve wildfire risk forecast for a specific place. Use when you need weekly wildfire risk predictions for a location over the next four weeks.
  - body: { place: string }
- `POST https://api.mcp.ai/api/ambee/reverse/geocode/by/lat/lng` — Tool to convert geographic coordinates into human-readable location data (address, place name, postal code). Use when you have latitude and longitude and need to get the corresponding address or locat
  - body: { lat: number, lng: number }

## Example prompts
- "What can I do in Ambee?"
- "Show me a summary of my Ambee account"

## More
- Page: https://mcp.ai/ambee
- Agent spec (llms.txt): https://mcp.ai/ambee/llms.txt
- Postman collection: https://mcp.ai/ambee/postman.json