AI Assistant Integration

MCP Server Setup Guide

Connect BMKG Indonesia weather, earthquake, and region data to your favorite AI assistants

Two Ways to Connect

Choose Your Connection Method

We support both local installation via stdio transport and cloud-based HTTP transport. Pick what works best for you!

RECOMMENDED

HTTP Transport

Cloud-based, no install

  • No installation required
  • Works in Claude Desktop, Cursor, VS Code
  • Smithery one-click install
  • Always up-to-date

Endpoint URL:

https://mcp-bmkg.dhanypedia.it.com/mcp

Local (Stdio)

Install on your machine

  • Full offline capability
  • No internet required after install
  • Debug mode available
  • pipx/pip install

Install command:

pipx install bmkg-api-mcp
Copied to clipboard!
★

Quick Setup via Smithery

The easiest way to get started! Smithery provides one-click installation for MCP servers. No manual configuration needed.

View on Smithery

One-line Install

npx -y @smithery/cli install dhanyyudi/bmkg-id --client claude

Supported clients: --client claude, --client cursor, --client vscode

1

HTTP Transport Setup

Why HTTP Transport?

HTTP Transport allows you to connect to the MCP server remotely without installing anything locally. Perfect for cloud environments, shared workspaces, or when you want zero setup.

Configure your IDE to use the HTTP endpoint:

Claude Desktop with HTTP Transport

  1. 1 Open Claude Desktop
  2. 2 Go to Settings (Cmd/Ctrl + ,)
  3. 3 Click "Edit Config" to open the configuration file
  4. 4 Add the following configuration: 
{
  "mcpServers": {
    "bmkg-api": {
      "url": "https://mcp-bmkg.dhanypedia.it.com/mcp"
    }
  }
}

Restart Claude Desktop after adding the configuration.

Cursor with HTTP Transport

  1. 1 Open Cursor
  2. 2 Go to Settings (Cmd/Ctrl + ,)
  3. 3 Navigate to Features → MCP Servers
  4. 4 Click Add New MCP Server
  5. 5 Fill in the details:
  • Name: bmkg-api
  • Type: url
  • URL: https://mcp-bmkg.dhanypedia.it.com/mcp

VS Code with HTTP Transport

Requires Cline or Roo Code extension installed.

  1. 1 Open VS Code with Cline/Roo Code extension
  2. 2 Open the Cline/Roo Code panel
  3. 3 Click Settings (gear icon) → MCP Servers
  4. 4 Add the following configuration: 
{
  "mcpServers": {
    "bmkg-api": {
      "url": "https://mcp-bmkg.dhanypedia.it.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
2

Local Installation (Stdio)

Install the BMKG API MCP Server locally using pipx (recommended) or pip:

Via pipx (recommended):

pipx install bmkg-api-mcp

Via pip:

pip install bmkg-api-mcp

Verify installation:

bmkg-api-mcp --version # Should output: bmkg-api-mcp 1.0.2
3

Configure Local IDE (Stdio)

Claude Desktop Setup

  1. 1 Open Claude Desktop
  2. 2 Go to Settings (Cmd/Ctrl + ,)
  3. 3 Click "Edit Config" to open the configuration file
  4. 4 Add the following configuration: 
{
  "mcpServers": {
    "bmkg-api": {
      "command": "bmkg-api-mcp"
    }
  }
}

Restart Claude Desktop after adding the configuration.

Cursor Setup

  1. 1 Open Cursor
  2. 2 Go to Settings (Cmd/Ctrl + ,)
  3. 3 Navigate to Features → MCP Servers
  4. 4 Click Add New MCP Server
  5. 5 Fill in the details:
  • Name: bmkg-api
  • Type: command
  • Command: bmkg-api-mcp

Click Add and the tools will be available in Cursor chat.

VS Code Setup (with Cline/Roo Code)

Requires Cline or Roo Code extension installed.

  1. 1 Open VS Code with Cline/Roo Code extension
  2. 2 Open the Cline/Roo Code panel
  3. 3 Click Settings (gear icon) → MCP Servers
  4. 4 Add the following configuration: 
{
  "mcpServers": {
    "bmkg-api": {
      "command": "bmkg-api-mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windsurf Setup

  1. 1 Open Windsurf
  2. 2 Go to Settings → Cascade → MCP Servers
  3. 3 Click Add Server
  4. 4 Fill in the details:
  • Name: bmkg-api
  • Type: command
  • Command: bmkg-api-mcp
4

Available Tools

These tools are available through both HTTP and Local (stdio) connection methods.

Earthquake

  • • get_latest_earthquake
  • • get_recent_earthquakes
  • • get_felt_earthquakes
  • • get_nearby_earthquakes

Weather

  • • get_weather_forecast
  • • get_current_weather

Nowcast

  • • get_weather_warnings
  • • check_location_warnings

Region

  • • search_regions
  • • get_provinces
  • • get_districts
  • • get_subdistricts
  • • get_villages

Utility

  • • get_cache_stats
  • • debug_ping

Prompts (7)

  • • earthquake_assistant
  • • weather_assistant
  • • region_lookup_assistant
  • • +4 more...

Try These Example Prompts

"Gempa terbaru di Indonesia?"

"Cuaca 3 hari ke depan di Jakarta?"

"Cari kode wilayah untuk Tebet"

"Ada peringatan cuaca di Yogyakarta?"

"Gempa magnitude di atas 5 minggu ini?"

"Bandung ada gempa dekat-dekat sini?"

Troubleshooting

Cannot connect to HTTP Transport

Solution: Check your internet connection and verify the endpoint URL

curl https://mcp-bmkg.dhanypedia.it.com/mcp

Should return JSON response with server info

"command not found: bmkg-api-mcp"

Solution: Ensure pipx is in your PATH

pipx ensurepath

Tools not appearing in AI assistant

Solution: Restart your AI assistant application after configuration changes.

Debug mode (Local only)

Run with debug logging for troubleshooting:

bmkg-api-mcp --debug