DEV Community

Khairul Muhtadin
Khairul Muhtadin

Posted on Originally published at khmuhtadin.com

API Indonesia Is Now a Hermes Agent Plugin

#ai #api #mcp #opensource

I build and run API Indonesia, a REST API and MCP server for Indonesian public data. Its plugin is now listed on the Hermes Marketplace, the plugin catalog for Nous Research's Hermes Agent. If you run Hermes, one command gives your agent Indonesian data from official sources.

Install 

hermes plugins install api-indonesia
Enter fullscreen mode Exit fullscreen mode

You need Hermes 0.21.6 or newer and an API Indonesia key in API_INDONESIA_KEY. Put it in your profile .env or the plugin's settings form.

What your agent can look up

  • Administrative regions down to village level, with Kemendagri codes and region boundaries
  • Postal codes
  • Public holidays and cuti bersama
  • Prayer times and the Hijri calendar
  • Schools, universities and hospitals
  • BMKG earthquakes, weather and warnings
  • Bank Indonesia exchange rates and provincial minimum wage (UMP)
  • NIK and NPWP format checks, QRIS parsing and rupiah terbilang
  • Halal and BPOM lookups, and OJK investment lists
  • KBBI, Al-Quran and Alkitab

The plugin also bundles the api-indonesia skill, so the agent knows when to call which tool.

How it works

The plugin is configuration only: an Agent Plugins v1 package with plugin.json, mcp.json and a skills/ folder. There is no local code. Every tool call goes to the hosted MCP server at https://mcp.apiindonesia.id/mcp over Streamable HTTP, with your key sent as a bearer header. The tool set comes from the server at runtime, so new tools show up without a plugin update. All tools are read-only lookups and calculators.

What it costs

Each successful call costs Rp2 in API Indonesia credits. Failed calls are free. New accounts get a one-time bonus of 3,000 credits. There is no monthly free tier.

Try it

Top comments (0)