Official SDKs

​

Find and verify the official packages

• Search pkg.go.dev for worldmonitor.
• Read the Go module proxy’s latest release metadata.
• Install with go get github.com/koala73/worldmonitor/sdk/go from your Go project.

​

Rust

use worldmonitor::{Client, Config};

fn main() -> Result<(), worldmonitor::Error> {
    let client = Client::new(Config::default())?;
    let tools = client.list_tools()?;
    println!("{tools}");
    Ok(())
}

​

Shared design

• Any MCP tool — call_tool / CallTool with named arguments; the result is the unwrapped JSON-RPC result.
• Curated helpers vary by SDK. Rust includes country_risk; use call_tool for other tools and optional arguments.
• Public listings — list_tools, list_prompts, list_resources need no key.
• REST escape hatch — get("/api/…") and health() against api.worldmonitor.app.
• Configuration via constructor arguments or the WORLDMONITOR_API_KEY (alias WM_API_KEY), WORLDMONITOR_BASE_URL, and WORLDMONITOR_MCP_URL environment variables.
• Errors split into an MCP error (JSON-RPC error object, auth failures carry a key hint) and an API error (non-2xx transport).
• A descriptive User-Agent (worldmonitor-<lang>/<version>) — the API edge challenges generic library agents, so keep it if you fork.

​

Python

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.conflict_events(country="IR", limit=5)
client.call_tool("get_market_data", asset_class="crypto")

​

Ruby

require "worldmonitor"

client = WorldMonitor::Client.new(api_key: "wm_...")
client.list_tools
client.country_risk("IR")
client.call_tool("get_market_data", asset_class: "crypto")

​

Go

client := worldmonitor.New("wm_...") // "" reads WORLDMONITOR_API_KEY
tools, _ := client.ListTools(ctx)
risk, _ := client.CountryRisk(ctx, "IR", nil)
quotes, _ := client.CallTool(ctx, "get_market_data", worldmonitor.Args{"asset_class": "crypto"})

​

JavaScript

import { parseArgs, planRequest } from 'worldmonitor';
import run from 'worldmonitor/run';

​

Get a key

​

Releasing (maintainers)

• Python: bump version in sdk/python/pyproject.toml and __version__ in sdk/python/src/worldmonitor_sdk/__init__.py, then tag py-vX.Y.Z (workflow publish-python.yml).
• Ruby: bump WorldMonitor::VERSION in sdk/ruby/lib/worldmonitor/version.rb, then tag gem-vX.Y.Z (workflow publish-ruby.yml).
• Go: bump Version in sdk/go/worldmonitor.go, then tag sdk/go/vX.Y.Z (workflow publish-go.yml validates and warms the module proxy).
• Rust: follow the Rust release runbook. Later releases use OIDC after the crates.io trusted publisher is configured. Run publish-rust.yml from main with a verified rust-vX.Y.Z tag and dry_run=true, then publish with dry_run=false after owner approval.