{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_g25ybnb767c7","handle":"bmkg-api-mcp","url":"https://wellknown.network/agents/bmkg-api-mcp","links":{"self":"https://wellknown.network/agents/bmkg-api-mcp/record.json","html":"https://wellknown.network/agents/bmkg-api-mcp","markdown":"https://wellknown.network/agents/bmkg-api-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bmkg-api-mcp","status":"https://wellknown.network/api/v1/agents/bmkg-api-mcp/status","claim":"https://wellknown.network/agents/bmkg-api-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bmkg-api-mcp/claim.json","badge":"https://wellknown.network/agents/bmkg-api-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/bmkg-api-mcp/history","tools":"https://wellknown.network/api/v1/agents/bmkg-api-mcp/tools"},"ard":{"identifier":"urn:air::server:bmkg-api-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bmkg-api-mcp","summary":"MCP Server for BMKG Indonesia - Weather, Earthquake, and Region Data for AI Assistants","description":"# BMKG API\n\n<!-- mcp-name: io.github.dhanyyudi/bmkg-api -->\n\n[![Docker](https://github.com/dhanyyudi/bmkg-api/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/dhanyyudi/bmkg-api/actions/workflows/docker-publish.yml)\n[![PyPI](https://img.shields.io/pypi/v/bmkg-api-mcp.svg)](https://pypi.org/project/bmkg-api-mcp/)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.109+-green.svg)](https://fastapi.tiangolo.com/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)\n\n---\n\n<a name=\"english\"></a>\n## 🇬🇧 English\n\nFree REST API for Indonesian weather forecasts, earthquake data, weather warnings, and region lookup from BMKG.\n\n**🌐 Demo:** [https://bmkg-api.dhanypedia.com](https://bmkg-api.dhanypedia.com)\n\n### ⚠️ Important Notice\n\nThis is a **demo/public instance** with rate limits (30 requests/minute) to ensure fair usage.\n\n**For production use with unlimited requests, please [self-host](#self-hosting).**\n\n### Features\n\n- 🌍 **Earthquake Data** — Latest, recent (M 5.0+), felt earthquakes, nearby search by coordinates\n- 🌤️ **Weather Forecast** — 3-day forecasts & current weather for any kelurahan/desa in Indonesia\n- ⚠️ **Weather Warnings (Nowcast)** — Real-time severe weather alerts with affected area polygons\n- 📍 **Region Lookup** — Indonesian provinces, districts, subdistricts, villages, plus search\n- 📊 **Auto-generated Docs** — Interactive API documentation at `/docs`\n- ⚡ **Caching** — Fast responses with in-memory cache (configurable TTL)\n- 🌐 **CORS Enabled** — Use from any frontend\n- 🔓 **No API Key Required** — Simple, anonymous access\n- 📈 **Rate Limit Headers** — `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` on every response\n- 🐳 **Docker & GHCR** — Automated multi-arch Docker images published to GitHub Con…","publisher":null,"homepage":"https://bmkg-api.dhanypedia.com/docs","repository":"https://github.com/dhanyyudi/bmkg-api","version":"2.0.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bmkg-api-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.weather","name":"Weather","confidence":0.814,"provenance":"derived"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bmkg-api-mcp","registry":"pypi","observedAt":"2026-11-09T00:27:27.116Z","publishedAt":"2026-10-11T09:16:13.379614Z","latestVersion":"2.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bmkg-api-mcp","url":"https://pypi.org/project/bmkg-api-mcp/","firstSeenAt":"2026-09-09T10:27:32.504Z","fetchedAt":"2026-11-09T00:26:21.387Z","normalizedAt":"2026-11-09T00:26:21.387Z"}]},"firstSeenAt":"2026-09-09T10:27:32.504Z","updatedAt":"2026-11-09T00:27:27.116Z"}