Explore Córdoba

Explore Córdoba — MCP server for AI agents

A read-only Model Context Protocol server. No authentication, no API key, nothing that changes state. This is the agent-facing side of Explore Córdoba, the website for people.

Connect

Point any MCP client at the endpoint below. Pick your client for the exact setup.

Endpoint
https://agents.explorecordoba.com/mcp
Discovery document
https://agents.explorecordoba.com/.well-known/mcp/server.json

Claude Code

claude mcp add --transport http cordoba https://agents.explorecordoba.com/mcp

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "cordoba": { "url": "https://agents.explorecordoba.com/mcp" }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "cordoba": { "type": "http", "url": "https://agents.explorecordoba.com/mcp" }
  }
}

Any MCP client that takes a JSON config

{
  "mcpServers": {
    "cordoba": { "type": "http", "url": "https://agents.explorecordoba.com/mcp" }
  }
}

Raw HTTP, listing the tools

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Protocol

Transport
Streamable HTTP: JSON-RPC 2.0 over POST, stateless.
Protocol revision
2026-07-28. The legacy initialize handshake is also accepted.
Required headers
Content-Type: application/json, MCP-Protocol-Version, and Mcp-Method (plus Mcp-Name when calling a tool).
Results
Every tool returns native structuredContent and the same JSON in the first text block, for clients that ignore structured output.

Tools

5 tools. Parameter tables are generated from each tool's input schema, the same one tools/list returns.

itinerary#

itinerary serves the site's self-guided walking routes. Without slug it lists them (filter by theme or difficulty); with a slug it returns the full route with ordered stops, best time to go and accessibility notes. Distances and durations are free text as published. Each result has last_updated and source_url; the data is the site's build-time export, imported hourly.

{"slug":"jewish-quarter-walk"}

Parameters

NameRequiredTypeDefaultDescription
slug optional string — Walk slug for the full route with ordered stops, e.g. jewish-quarter-walk.
theme optional string — List filter, e.g. heritage, food, nature.
difficulty optional string — List filter, e.g. easy, moderate.
limit optional integer — Maximum walks listed, 1–25, default 10.

Example request

Arguments:

{
    "slug": "jewish-quarter-walk"
}

As a raw call:

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: itinerary' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"itinerary","arguments":{"slug":"jewish-quarter-walk"}}}'
Example response (structuredContent, abridged) 
{
    "schema_version": 1,
    "status": "ok",
    "site": "cordoba",
    "dataset": {
        "source": "https://www.explorecordoba.com/agents-data/v1.json",
        "imported_at": "2026-10-14T12:00:00+00:00"
    },
    "count": 1,
    "results": [
        {
            "slug": "jewish-quarter-walk",
            "name": "Jewish Quarter Heritage Walk",
            "description": "Self-guided 1.8km walk through Córdoba's Jewish Quarter: medieval synagogue, Casa de Sefarad, Calleja de las Flores, Alcázar gardens. Free route, 2 hours.",
            "distance": "1.8 km",
            "duration": "2–3 hours",
            "difficulty": "easy",
            "startPoint": "Mezquita-Cathedral west entrance, Calle Torijos, Córdoba",
            "endPoint": "Alcázar de los Reyes Cristianos, Campo Santo de los Mártires, Córdoba",
            "circular": true,
            "theme": "heritage",
            "neighborhoods": [
                "juderia"
            ],
            "bestTime": "April to June for flowers in full bloom. September to November for cooler temperatures and smaller crowds. Avoid July and August midday — the alleys trap heat above 35°C. Start at 9:00am to reach Calleja de las Flores before the first tour buses arrive.",
            "accessibility": "Fully flat route on cobblestone streets. Wider parallel streets available for pushchairs or wheelchairs on most sections. The synagogue interior has one small step at the entrance. The Alcázar tower is not accessible. The gardens and ground-floor halls are fully accessible.",
            "dateModified": "2026-09-15",
            "stops": [
                {
                    "order": 1,
                    "name": "Mezquita-Cathedral",
                    "description": "Start at the western façade on Calle Torijos. You don't need to go inside at this point — the exterior walls alone, with their blind arcades and Roman stone blocks at the base, are worth five minutes. The bell tower rising from the original minaret stays visible throughout the walk."
                },
                {
                    "order": 2,
                    "name": "Puerta de Almodóvar",
                    "description": "A 14th-century gate built over Roman foundations at the northwest corner of the old city walls. The arch frames a view back toward the Mezquita tower and north toward open countryside. The statue just outside the gate is Averroes (Ibn Rushd), the 12th-century philosopher born two streets away."
                },
                {
                    "order": 3,
                    "name": "Synagogue",
                    "description": "Built in 1315, this is one of three medieval synagogues still standing in Spain. The prayer hall is small — you could cross it in eight steps — but the Mudejar stucco work on the upper gallery is detailed and largely original. A Hebrew inscription runs along the upper walls. Entry costs 0.30€ for EU citizens and is free for residents of Córdoba."
                },
                {
                    "order": 4,
                    "name": "Casa de Sefarad",
                    "description": "A private cultural centre in a restored 14th-century house directly across from the synagogue. Five rooms cover Sephardic history, music, women's roles, and the Inquisition period, with artefacts and context that the synagogue itself lacks. Live Sephardic music performances run most weekday evenings."
                },
                {
                    "order": 5,
                    "name": "Calleja de las Flores",
                    "description": "A dead-end alley off Calle Blanco Belmonte, famous for the geranium-pot walls and the framed view of the Mezquita tower at the far end. The composition works because the alley bends slightly, placing the spire dead-centre. Early morning, the pots are freshly watered and the light is soft."
                },
                {
                    "order": 6,
                    "name": "Caliphal Baths",
                    "description": "Tenth-century Arab thermal baths, part of the palace complex that once extended from the Alcázar to the river. Excavated from under a 16th-century house, the star-shaped vaulted ceiling with filtered light is the best-preserved element. Context panels explain the hot, warm, and cold room sequence."
                },
                {
                    "order": 7,
                    "name": "Capilla de San Bartolomé",
                    "description": "A 15th-century chapel with one of the finest Mudejar tile interiors in the city — geometric azulejo panels covering the lower walls, star-vaulted ceiling painted in gold and blue. It sits on a side street that most visitors walk straight past. Free entry, almost always empty."
                },
                {
                    "order": 8,
                    "name": "Maimonides Square and Statue",
                    "description": "A small plaza on Calle Judíos with a bronze statue of Moses Maimonides (1138–1204), the philosopher and physician born in this quarter. The square is a natural rest point before the final stretch to the Alcázar. The tourist information office nearby has free walking maps if you want them."
                },
                {
                    "order": 9,
                    "name": "Alcázar de los Reyes Cristianos",
                    "description": "The walk ends at the fortress built by Alfonso XI in 1328 on the ruins of earlier Visigothic and Moorish palaces. The Roman mosaics inside the lower halls are worth slowing down for — one, from the 2nd century, shows a feast scene in fine detail. But the terraced gardens along the city wall, with their long water channels and cypress hedges, are the real reason to allow 30 minutes here rather than 10."
                }
            ],
            "url": "https://www.explorecordoba.com/walk/jewish-quarter-walk",
            "last_updated": "2026-09-15",
            "source_url": "https://www.explorecordoba.com/walk/jewish-quarter-walk"
        }
    ],
    "note": "Data comes from the site's published build-time export and is refreshed hourly; it can lag the live site and is not real-time."
}

monuments#

monuments looks up this city's heritage sites by exact slug or by a free-text query over name, type, tags and description, optionally within a neighborhood. Each result carries the site's own description, address, coordinates, free-text hours and fees, last_updated (the record's own modification date) and a source_url. The data is the site's published build-time export, imported hourly, so confirm hours and prices before travelling.

{"query":"gardens","neighborhood":"juderia","limit":3}

Parameters

NameRequiredTypeDefaultDescription
slug optional string — Exact monument slug, e.g. mezquita-cathedral. Takes precedence over query.
query optional string — Free text matched against name, type, tags and description; every word must match.
neighborhood optional string — Neighborhood slug or name, e.g. juderia.
limit optional integer — Maximum results, 1–25, default 10.

Example request

Arguments:

{
    "query": "gardens",
    "neighborhood": "juderia",
    "limit": 3
}

As a raw call:

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: monuments' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"monuments","arguments":{"query":"gardens","neighborhood":"juderia","limit":3}}}'
Example response (structuredContent, abridged) 
{
    "schema_version": 1,
    "status": "ok",
    "site": "cordoba",
    "dataset": {
        "source": "https://www.explorecordoba.com/agents-data/v1.json",
        "imported_at": "2026-10-14T12:00:00+00:00"
    },
    "count": 1,
    "results": [
        {
            "slug": "alcazar-de-los-reyes-cristianos",
            "name": "Alcázar de los Reyes Cristianos",
            "description": "Alcázar de los Reyes Cristianos, Córdoba: free entry on Tuesdays. A 14th-century fortress-palace with terraced Moorish-inspired gardens and Roman mosaics.",
            "type": "palace",
            "neighborhood": "juderia",
            "address": "C. Caballerizas Reales, s/n, Centro, 14004 Córdoba, Spain",
            "coordinates": {
                "lat": 37.875623499999996,
                "lng": -4.781822099999999
            },
            "hours": "Tue–Sat: 8:30am–8:45pm, Sun: 8:30am–2:30pm",
            "fees": "€7 adult, €3.50 reduced",
            "tags": [
                "unesco",
                "fortress",
                "gardens",
                "history",
                "catholic-monarchs",
                "must-see",
                "palace",
                "medieval",
                "roman",
                "historic-centre"
            ],
            "themes": [
                "history",
                "architecture",
                "nature",
                "cultural"
            ],
            "audiences": [
                "history-buffs",
                "architecture",
                "photographers",
                "outdoor",
                "accessible"
            ],
            "dateModified": "2026-09-11",
            "url": "https://www.explorecordoba.com/monument/alcazar-de-los-reyes-cristianos",
            "last_updated": "2026-09-11",
            "source_url": "https://www.explorecordoba.com/monument/alcazar-de-los-reyes-cristianos"
        }
    ],
    "note": "Data comes from the site's published build-time export and is refreshed hourly; it can lag the live site and is not real-time.",
    "total_matches": 1
}

events#

events lists festivals and events overlapping a date range (from and to, default today through 90 days), sorted by start date. Events published without a start date are returned only with include_undated, after the dated ones, and only their free-text dates field says when they happen. Some dates are projected for annual events; confirm them on the official website. Every result has last_updated and source_url.

{"from":"2026-10-14","to":"2026-12-31","include_undated":false}

Parameters

NameRequiredTypeDefaultDescription
from optional string — First day, YYYY-MM-DD. Default today (Europe/Madrid).
to optional string — Last day, YYYY-MM-DD, not before from. Default 90 days after from.
include_undated optional boolean false Also return events with no start date, after the dated ones.
limit optional integer — Maximum results, 1–50, default 25.

Example request

Arguments:

{
    "from": "2026-10-14",
    "to": "2026-12-31",
    "include_undated": false
}

As a raw call:

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: events' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"events","arguments":{"from":"2026-10-14","to":"2026-12-31","include_undated":false}}}'
Example response (structuredContent, abridged) 
{
    "schema_version": 1,
    "status": "ok",
    "site": "cordoba",
    "dataset": {
        "source": "https://www.explorecordoba.com/agents-data/v1.json",
        "imported_at": "2026-10-14T12:00:00+00:00"
    },
    "count": 4,
    "results": [
        {
            "slug": "cabalcor-horse-fair",
            "name": "Cabalcor Horse Fair",
            "description": "Cabalcor, Córdoba's annual horse fair, fills the 1570 Royal Stables from 8 Sept to 14 Oct 2026 with purebred Spanish horse contests and daily art exhibits.",
            "period": "September – October",
            "dates": "8 September – 14 October 2026",
            "startDate": "2026-09-08",
            "endDate": "2026-10-14",
            "duration": "5 weeks",
            "type": "feria",
            "category": "Equestrian fair and competition",
            "location": "Caballerizas Reales (Royal Stables), Córdoba",
            "coordinates": {
                "lat": 37.8767,
                "lng": -4.7832
            },
            "officialWebsite": "https://www.turismodecordoba.org/cabalcor-cordoba-horse-fair",
            "tags": [
                "cabalcor",
                "horse-fair",
                "equestrian",
                "royal-stables",
                "annual",
                "pure-spanish-horse",
                "doma-vaquera",
                "autumn"
            ],
            "dateModified": "2026-09-09",
            "url": "https://www.explorecordoba.com/event/cabalcor-horse-fair",
            "last_updated": "2026-09-09",
            "source_url": "https://www.explorecordoba.com/event/cabalcor-horse-fair"
        },
        {
            "slug": "festival-flora",
            "name": "FLORA - International Floral Art Festival",
            "description": "Five installations in Córdoba's palaces and patios, 12–22 October 2026. Free exhibition 16–21 Oct, 11:00–20:00. Venues, artists and the Martirio concert.",
            "period": "October",
            "dates": "12-22 October 2026",
            "startDate": "2026-10-12",
            "endDate": "2026-10-22",
            "duration": "11 days",
            "type": "culturel",
            "category": "Contemporary floral and botanical art",
            "location": "Historic patios and palaces (Palacio de Viana, Patio de los Naranjos, Palacio de la Merced, Archaeological Museum, Palacio de Orive)",
            "price": "Free",
            "neighborhoods": [
                "centro",
                "juderia"
            ],
            "coordinates": {
                "lat": 37.8844,
                "lng": -4.7758
            },
            "officialWebsite": "https://festivalflora.com/en/",
            "tags": [
                "contemporary-art",
                "flowers",
                "free",
                "autumn",
                "patios",
                "culture",
                "installations",
                "accessible",
                "annual",
                "international",
                "botanical"
            ],
            "dateModified": "2026-10-07",
            "url": "https://www.explorecordoba.com/event/festival-flora",
            "last_updated": "2026-10-07",
            "source_url": "https://www.explorecordoba.com/event/festival-flora"
        },
        {
            "slug": "world-cheese-awards-cordoba-2026",
            "name": "World Cheese Awards Córdoba 2026",
            "description": "Visiting the World Cheese Awards in Córdoba, 12–15 November 2026: public Cheese Market, tastings and a dairy forum. Over 5,000 cheeses are judged on day one.",
            "period": "November",
            "dates": "12-15 November 2026 (awards judging 12 November)",
            "startDate": "2026-11-12",
            "endDate": "2026-11-15",
            "duration": "4 days (judging on day one)",
            "type": "gastronomie",
            "category": "International cheese competition",
            "location": "Centro de Exposiciones, Ferias y Convenciones de Córdoba (Córdoba Exhibition, Trade Fair and Convention Center)",
            "officialWebsite": "https://internationalcheesefestival.com/?lang=en",
            "tags": [
                "cheese",
                "gastronomy",
                "international",
                "competition",
                "dairy",
                "food-festival",
                "annual"
            ],
            "dateModified": "2026-09-24",
            "url": "https://www.explorecordoba.com/event/world-cheese-awards-cordoba-2026",
            "last_updated": "2026-09-24",
            "source_url": "https://www.explorecordoba.com/event/world-cheese-awards-cordoba-2026"
        },
        {
            "slug": "christmas-cordoba",
            "name": "Christmas in Córdoba",
            "description": "Five weeks of free festivities: artisan market, flamenco zambombas in the peñas, 20,000 people sharing grapes at midnight on 31 December. Plan your visit.",
            "period": "December-January",
            "dates": "1 December 2026 - 6 January 2027",
            "startDate": "2026-12-01",
            "endDate": "2027-01-06",
            "duration": "5 weeks",
            "type": "festival",
            "category": "Traditional festive season",
            "location": "Plaza de las Tendillas, historic centre",
            "price": "Free",
            "coordinates": {
                "lat": 37.8845,
                "lng": -4.779
            },
            "officialWebsite": "https://www.cordobaesnavidad.es/",
            "tags": [
                "christmas",
                "winter",
                "free",
                "market",
                "tradition",
                "family",
                "illuminations",
                "flamenco",
                "annual",
                "music",
                "gastronomy"
            ],
            "dateModified": "2026-09-24",
            "url": "https://www.explorecordoba.com/event/christmas-cordoba",
            "last_updated": "2026-09-24",
            "source_url": "https://www.explorecordoba.com/event/christmas-cordoba"
        }
    ],
    "note": "Events are sorted by start date; those without a usable start date come last and only when include_undated is true. Their free-text \"dates\" field is the only timing the site publishes. Data comes from the site's published build-time export and is refreshed hourly; it can lag the live site and is not real-time.",
    "total_matches": 4,
    "date_range": {
        "from": "2026-10-14",
        "to": "2026-12-31"
    },
    "undated_included": false
}

restaurants#

restaurants finds places to eat by neighborhood and/or a dish, cuisine or specialty in query, ranked by match and then rating. Results include cuisine, average price, specialties, free-text opening hours, phone and website when published, last_updated and source_url. The data is the site's published build-time export, imported hourly; confirm prices and hours with the venue.

{"query":"vegan","neighborhood":"ribera","limit":3}

Parameters

NameRequiredTypeDefaultDescription
query optional string — Dish, cuisine or specialty, e.g. salmorejo, vegan, seafood.
neighborhood optional string — Neighborhood slug or name, e.g. juderia.
limit optional integer — Maximum results, 1–25, default 10.

Example request

Arguments:

{
    "query": "vegan",
    "neighborhood": "ribera",
    "limit": 3
}

As a raw call:

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: restaurants' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"restaurants","arguments":{"query":"vegan","neighborhood":"ribera","limit":3}}}'
Example response (structuredContent, abridged) 
{
    "schema_version": 1,
    "status": "ok",
    "site": "cordoba",
    "dataset": {
        "source": "https://www.explorecordoba.com/agents-data/v1.json",
        "imported_at": "2026-10-14T12:00:00+00:00"
    },
    "count": 2,
    "results": [
        {
            "slug": "la-bicicleta",
            "name": "La Bicicleta",
            "description": "Vegetarian bar near Miraflores Bridge. Avocado tostas, vegan salmorejo, fresh-pressed juices and homemade orange cake. Open all afternoon without a break.",
            "cuisine": "Vegetarian, vegan, creative tapas",
            "cuisineCategory": "tapas",
            "averagePrice": "20-30 euros",
            "address": "C. Cardenal Gonzalez, 1, Centro, 14003 Córdoba, Spain",
            "neighborhood": "ribera",
            "specialties": [
                "Tostas de aguacate y tomate",
                "Calabacines tibios al queso de cabra",
                "Hummus casero",
                "Salmorejo vegano",
                "Fresh organic juices",
                "Artisan cocktails",
                "Homemade cakes"
            ],
            "openingHours": {
                "weekdays": "14:00-1:00",
                "weekends": "14:00-0:00, 14:00-1:00"
            },
            "coordinates": {
                "lat": 37.879965299999995,
                "lng": -4.7756614
            },
            "rating": 4.6,
            "dateModified": "2026-04-05",
            "url": "https://www.explorecordoba.com/restaurant/la-bicicleta",
            "last_updated": "2026-04-05",
            "source_url": "https://www.explorecordoba.com/restaurant/la-bicicleta"
        },
        {
            "slug": "amaltea",
            "name": "Restaurante Amaltea",
            "description": "Vegetarian and vegan on the Guadalquivir riverbank, steps from the Roman Bridge. Organic ingredients, gluten-free kitchen, river views from the terrace.",
            "cuisine": "Vegetarian, vegan, sustainable Mediterranean",
            "cuisineCategory": "specialty",
            "averagePrice": "15-20 euros",
            "address": "Rda. de Isasa, 10, Centro, 14003 Córdoba, Spain",
            "neighborhood": "ribera",
            "specialties": [
                "Vegetarian tasting menu",
                "Full vegan menu",
                "Tataki de atún (tuna tataki)",
                "Hummus with salmorejo",
                "Mediterranean couscous",
                "Gluten-free bread and pasta",
                "Gluten-free beer"
            ],
            "openingHours": {
                "weekdays": "20:00-23:00, 20:00-0:00",
                "weekends": "13:00-16:00, 20:00-0:00"
            },
            "phone": "+34 657 75 75 98",
            "website": "https://www.amaltea.es/",
            "coordinates": {
                "lat": 37.87881,
                "lng": -4.77721
            },
            "rating": 4.6,
            "dateModified": "2026-04-05",
            "url": "https://www.explorecordoba.com/restaurant/amaltea",
            "last_updated": "2026-04-05",
            "source_url": "https://www.explorecordoba.com/restaurant/amaltea"
        }
    ],
    "note": "Data comes from the site's published build-time export and is refreshed hourly; it can lag the live site and is not real-time.",
    "total_matches": 2
}

opening_hours#

opening_hours returns the published hours of one monument or restaurant by slug, verbatim as free text (restaurants: an object of free-text fields such as weekdays and weekends). Nothing is parsed, so it never answers "open now", and holidays or one-off closures may be missing. Pass type (monument or restaurant) only when a slug exists as both. The result carries last_updated and source_url.

{"slug":"mezquita-cathedral"}

Parameters

NameRequiredTypeDefaultDescription
slug required string — Monument or restaurant slug, e.g. mezquita-cathedral.
type optional string: monument, restaurant — Only needed if the slug is ambiguous.

Example request

Arguments:

{
    "slug": "mezquita-cathedral"
}

As a raw call:

curl -X POST https://agents.explorecordoba.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: opening_hours' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"opening_hours","arguments":{"slug":"mezquita-cathedral"}}}'
Example response (structuredContent, abridged) 
{
    "schema_version": 1,
    "status": "ok",
    "site": "cordoba",
    "dataset": {
        "source": "https://www.explorecordoba.com/agents-data/v1.json",
        "imported_at": "2026-10-14T12:00:00+00:00"
    },
    "count": 1,
    "results": [
        {
            "type": "monument",
            "slug": "mezquita-cathedral",
            "name": "Mezquita-Catedral de Córdoba",
            "hours": "Mon–Sat: 10am–7pm, Sun: 8:30–11:30am, 3–7pm",
            "hours_as_published": "Free text exactly as the site publishes it; not parsed, and it may omit holidays, seasonal changes or closures. Confirm with the venue.",
            "last_updated": "2026-10-06",
            "source_url": "https://www.explorecordoba.com/monument/mezquita-cathedral"
        }
    ],
    "note": "Data comes from the site's published build-time export and is refreshed hourly; it can lag the live site and is not real-time."
}

Errors and limits

SituationWhat you get
Invalid argumentsA tool result with isError: true and a message naming the field.
Ambiguous or unknown place nameHTTP 200 with status set to ambiguous_location (with candidates) or location_not_found. Call again with a candidate's coordinates.
Data unavailable or stalestatus set to unavailable with a reason.
Rate limit exceededHTTP 429. Wait the number of seconds in Retry-After.

Forecast confidence and missing data are explicit. Check source timestamps and recheck conditions before travel. Requests are rate-limited per network address.

Privacy