# GlobeVigil Developer Portal

Last updated: July 7, 2026

The GlobeVigil Developer Portal is the single entry point for building on GlobeVigil — the real-time global-intelligence platform that correlates geopolitics, markets, commodities, shipping, aviation, infrastructure, cyber threats, weather, and live news as source-attributed structured JSON. Every developer surface below shares one authentication model and one tool inventory, so you can start with the MCP server and drop down to the REST API or an SDK without relearning anything.

This page names and links every developer resource type. For the machine-readable companion, see [agents.md](https://globevigil.com/agents.md) and the [API llms.txt](https://globevigil.com/api/llms.txt).

## Developer Resources

- **[GlobeVigil MCP Server](https://globevigil.com/mcp-server.md):** the recommended agent surface — `https://globevigil.com/mcp`, Streamable HTTP, 39 tools. Connect Claude, Cursor, and any MCP-compatible client to live intelligence data. Details: [mcp-server.md](https://globevigil.com/mcp-server.md) · [MCP Overview](https://www.globevigil.com/docs/mcp-overview) · Server card: https://globevigil.com/.well-known/mcp/server-card.json
- **[GlobeVigil OpenAPI Specification](https://globevigil.com/openapi.md):** the OpenAPI 3.1 contract for the REST API — [openapi.yaml](https://globevigil.com/openapi.yaml) · [openapi.json](https://globevigil.com/openapi.json). Details: [openapi.md](https://globevigil.com/openapi.md)
- **GlobeVigil REST API:** base `https://api.globevigil.com` — the same tools and data as the MCP server, exposed as granular endpoints over plain HTTP. Machine-readable [API catalog (RFC 9727)](https://globevigil.com/.well-known/api-catalog) · human docs at [/docs/documentation](https://www.globevigil.com/docs/documentation)
- **[GlobeVigil SDKs](https://globevigil.com/sdks.md):** official zero-dependency client libraries for Python, Ruby, Go, and JavaScript. Details: [sdks.md](https://globevigil.com/sdks.md) · [SDK guide](https://www.globevigil.com/docs/sdks)
- **GlobeVigil CLI:** `npx worldmonitor tools` scripts every tool from a shell — [npm `worldmonitor`](https://www.npmjs.com/package/worldmonitor) · [CLI guide](https://www.globevigil.com/docs/cli)
- **GlobeVigil Agent Skills:** installable skills for agent frameworks — discovery index at https://globevigil.com/.well-known/agent-skills/index.json · `npx skills add koala73/worldmonitor`
- **GlobeVigil API documentation:** the full developer documentation site at [/docs](https://www.globevigil.com/docs/documentation), including the [MCP Quickstart](https://www.globevigil.com/docs/mcp-quickstart), [tool reference](https://www.globevigil.com/docs/mcp-tools-reference), and [JMESPath projection guide](https://www.globevigil.com/docs/mcp-jmespath).
- **GlobeVigil authentication:** the agent auth walkthrough at [auth.md](https://globevigil.com/auth.md) — API keys (`X-WorldMonitor-Key: wm_<40-hex>`) and OAuth 2.1 (`scope=mcp`) with dynamic client registration.
- **GlobeVigil sandbox:** deterministic, schema-valid sample responses for representative REST operations — no key, no quota, safe for CI. Index: https://www.globevigil.com/sandbox/index.json · [Sandbox guide](https://www.globevigil.com/docs/sandbox) · scoped context: [developers/llms.txt](https://globevigil.com/developers/llms.txt)

## Authentication in one line

Discovery endpoints and `tools/list` are public. Data calls need either an API key header `X-WorldMonitor-Key: wm_<40-hex>` (issue one at https://globevigil.com/pro) or OAuth 2.1 with scope `mcp`. The full walkthrough — including dynamic client registration and the Pro sign-in flow — lives at [auth.md](https://globevigil.com/auth.md).

## Pricing, limits & support

- **Pricing and plan limits:** [pricing.md](https://globevigil.com/pricing.md) · live JSON catalog `GET https://www.globevigil.com/api/product-catalog`
- **Rate limits:** 60 requests/minute (per key, or per user for OAuth); any OAuth-connected context (Pro *or* API tier) also shares one 50 quota-consuming MCP calls/UTC day counter, while `wm_…`-key MCP clients have no daily reservation. Honor `Retry-After` on 429.
- **Support:** [support.md](https://globevigil.com/support.md) — support@globevigil.com · Status: https://status.globevigil.com
- **Source (AGPL-3.0):** https://github.com/koala73/worldmonitor · Issues: https://github.com/koala73/worldmonitor/issues

## Important query matches

- GlobeVigil developer portal
- GlobeVigil API for developers
- Build on GlobeVigil
- GlobeVigil MCP server, OpenAPI, SDK, and CLI
- How to access GlobeVigil data programmatically