public/sdks.md
Last updated: July 7, 2026
World Monitor ships official client libraries in four language ecosystems so you can script country briefs, risk scores, market data, and every one of the 63 MCP tools without writing an HTTP integration. All of them are zero-dependency, MCP-first mirrors of the worldmonitor npm CLI, with a small REST escape hatch for host-relative and self-hosted use.
| Language | Package | Install | Source |
|---|---|---|---|
| Python | worldmonitor-sdk on PyPI | pip install worldmonitor-sdk | sdk/python/ |
| Ruby | worldmonitor on RubyGems | gem install worldmonitor | sdk/ruby/ |
| Go | github.com/koala73/worldmonitor/sdk/go on pkg.go.dev | go get github.com/koala73/worldmonitor/sdk/go | sdk/go/ |
| JavaScript / CLI | worldmonitor on npm | npm install worldmonitor | cli/ |
Every package sets its homepage to worldmonitor.app — that is how you (or your agent) verify it is the official SDK and not a look-alike.
All four clients expose the same surface with language-native naming:
call_tool / CallTool with named arguments; the result is the unwrapped JSON-RPC result.list_tools, list_prompts, list_resources — need no key.get("/api/…") and health() against https://api.worldmonitor.app.WORLDMONITOR_API_KEY (alias WM_API_KEY), WORLDMONITOR_BASE_URL, and WORLDMONITOR_MCP_URL environment variables.jmespath argument for server-side projection — typically an 80–95% response-size cut.from worldmonitor_sdk import Client
client = Client(api_key="wm_...") # or set WORLDMONITOR_API_KEY
client.list_tools() # public — no key needed
client.country_risk("IR")
client.call_tool("get_market_data", asset_class="crypto")
Get an API key at https://worldmonitor.app/pro. The full per-language guide — Ruby, Go, and JavaScript examples included — is at https://www.worldmonitor.app/docs/sdks.