---
title: "MCP Quickstart"
description: "Connect Claude, ChatGPT, Codex or Cursor to World Monitor in about a minute: paste one address, sign in with your World Monitor account, and ask a question. No API key needed."
---

World Monitor plugs into your AI assistant as a connector. You paste one address, sign in with your World Monitor account, and the assistant can answer from live data covering {/* mcp-domains:start */}markets, commodities and macro; energy; conflicts, country risk, sanctions, cyber threats and chokepoints; maritime, aviation and supply chains; climate and natural disasters; health signals; displacement and humanitarian crises; AI briefs, forecasts and intel history; tariffs and trade policy{/* mcp-domains:end */}.

<Info>
**The address to paste:** `https://worldmonitor.app/mcp`

There is no API key to copy and nothing to install. You sign in with the same email you use on worldmonitor.app.
</Info>

## Connect in one click

Each button opens the app with World Monitor already filled in. You confirm, then sign in with your World Monitor account.

<CardGroup cols={3}>
  <Card title="Add to Claude" icon="plug" href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=World%20Monitor&connectorUrl=https%3A%2F%2Fworldmonitor.app%2Fmcp">
    Desktop, web and mobile. Click **Continue**, then **Add**.
  </Card>
  <Card title="Add to Cursor" icon="plug" href="https://cursor.com/install-mcp?name=worldmonitor&config=eyJ1cmwiOiJodHRwczovL3dvcmxkbW9uaXRvci5hcHAvbWNwIn0%3D">
    Installs the server. Click **Needs login** to sign in.
  </Card>
  <Card title="Add to VS Code" icon="plug" href="https://vscode.dev/redirect/mcp/install?name=worldmonitor&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fworldmonitor.app%2Fmcp%22%7D">
    Installs for GitHub Copilot. Sign in when asked.
  </Card>
</CardGroup>

Terminal agents take one command:

<CodeGroup>
```bash Claude Code
claude mcp add --transport http worldmonitor https://worldmonitor.app/mcp
```

```bash Codex
codex mcp add worldmonitor --url https://worldmonitor.app/mcp && codex mcp login worldmonitor
```

```bash Gemini CLI
gemini mcp add --scope user --transport http worldmonitor https://worldmonitor.app/mcp
```
</CodeGroup>

ChatGPT, Grok, Perplexity and other apps take the address `https://worldmonitor.app/mcp` as a custom connector; per-app steps are below.

<Tip>
Signed in on the [dashboard](https://www.worldmonitor.app/dashboard)? **Settings → AI Agents** has the same buttons and commands, and lists the agents you have connected.
</Tip>

## Claude

Works in the Claude desktop app, on claude.ai and in the mobile apps. You add the connector once and every Claude app on your account can use it.

<Steps>
  <Step title="Open Claude with World Monitor filled in">
    Click **[Add World Monitor to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=World%20Monitor&connectorUrl=https%3A%2F%2Fworldmonitor.app%2Fmcp)**. Claude opens the **Add custom connector** dialog with the name and address already in place. Claude notes that the link came from outside; check that the address reads `https://worldmonitor.app/mcp`, click **Continue**, then **Add**.

    <Frame>
      <img width="520" src="/images/mcp/claude-add-dialog.webp" alt="Add custom connector dialog with the name World Monitor and the URL https://worldmonitor.app/mcp filled in" />
    </Frame>

    <Accordion title="Add it by hand instead">
      In Claude, open **Customize → Connectors**, click **+ Add**, then **Add custom connector**. Name it `World Monitor`, paste `https://worldmonitor.app/mcp`, click **Continue**, then **Add**.

      <Frame>
        <img src="/images/mcp/claude-add-menu.webp" alt="Claude Customize page, Connectors tab, with the + Add menu open on Add custom connector" />
      </Frame>
    </Accordion>
  </Step>
  <Step title="Sign in with World Monitor">
    A World Monitor window opens. Click **Sign in to World Monitor**, sign in with your email code or passkey, then click **Authorize**. A free account works.

    <Columns cols={2}>
      <Frame>
        <img src="/images/mcp/consent.webp" alt="World Monitor window: Claude wants access, with a sign-in button" />
      </Frame>
      <Frame>
        <img src="/images/mcp/authorize.webp" alt="World Monitor window after sign-in, showing the signed-in account and an Authorize button" />
      </Frame>
    </Columns>
  </Step>
  <Step title="Turn it on in a chat">
    In a new chat, click **+**, open **Connectors**, and check that World Monitor is switched on.

    <Frame>
      <img width="474" src="/images/mcp/claude-enable-in-chat.webp" alt="Claude chat + menu with Connectors open and the World Monitor toggle switched on" />
    </Frame>
  </Step>
  <Step title="Ask a question">
    Ask in plain language. The first time Claude uses each World Monitor tool it asks permission. Choose **Always allow** so it stops asking.

    <Frame>
      <img src="/images/mcp/claude-approve-tool.webp" alt="Claude asking permission to use get_market_data from World Monitor, with Deny, Always allow and Allow once buttons" />
    </Frame>
    <Frame>
      <img src="/images/mcp/claude-answer.webp" alt="Claude's answer summarising oil, gold, US and Asian index moves from World Monitor data" />
    </Frame>
  </Step>
</Steps>

<Note>
On Claude Team and Enterprise, an owner first adds the connector under **Organization settings → Connectors**. Members then click **Connect** next to it in **Customize → Connectors**. Claude's Free plan allows one custom connector.
</Note>

## ChatGPT

<Steps>
  <Step title="Add the server">
    Open **Plugins**, click **+**, and choose **Add custom MCP server**. Name it `World Monitor`, paste `https://worldmonitor.app/mcp`, choose **OAuth** for authentication, and confirm.
  </Step>
  <Step title="Sign in and ask">
    Sign in with your World Monitor account in the window that opens, then pick World Monitor from the **+** menu in a chat.
  </Step>
</Steps>

ChatGPT moves this menu between releases and some plans or workspaces turn custom servers off. If you don't see it, follow [OpenAI's guide to custom MCP servers](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).

## Codex

Run two commands. The second opens your browser to sign in.

```bash
codex mcp add worldmonitor --url https://worldmonitor.app/mcp
codex mcp login worldmonitor
```

The Codex app, the CLI and the IDE extension share this setup.

## Claude Code

```bash
claude mcp add --transport http worldmonitor https://worldmonitor.app/mcp
```

Then type `/mcp` in Claude Code, pick `worldmonitor`, and choose **Authenticate**.

## Cursor

[Add World Monitor to Cursor](https://cursor.com/install-mcp?name=worldmonitor&config=eyJ1cmwiOiJodHRwczovL3dvcmxkbW9uaXRvci5hcHAvbWNwIn0%3D) with one click, or put this in `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "worldmonitor": { "url": "https://worldmonitor.app/mcp" }
  }
}
```

Cursor shows **Needs login** next to the server under **Settings → MCP**. Click it to sign in.

## VS Code

[Add World Monitor to VS Code](https://vscode.dev/redirect/mcp/install?name=worldmonitor&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fworldmonitor.app%2Fmcp%22%7D) with one click. VS Code opens, installs the server for GitHub Copilot, and asks you to sign in.

## Gemini CLI

```bash
gemini mcp add --scope user --transport http worldmonitor https://worldmonitor.app/mcp
```

Then start `gemini`, trust the folder when asked, and run `/mcp auth worldmonitor` to sign in.

## Other apps

Perplexity, Mistral Le Chat, Grok, Microsoft 365 Copilot and most other assistants that support MCP take the same address as a custom connector or remote server. See [client setup](/mcp-overview#client-setup) for per-app notes.

## Questions to try

- _Draft a duty-of-care brief for our staff in Riyadh using today's World Monitor data._
- _Compare the US, UK and Australian travel advisories for the Gulf states. Which changed most recently?_
- _Is anything disrupting flights or shipping through the Strait of Hormuz right now?_
- _Give me a country brief on Venezuela with the main risks for the next two weeks._
- _How are oil, gold and the main equity indices moving today, and why?_

The assistant picks the right World Monitor tools on its own. Answers carry timestamps, so you can see how fresh the data is.

## What your plan includes

| Plan | What the assistant can use | Daily allowance |
| --- | --- | --- |
| Free account | Source listing and a small set of cached datasets | 5 calls |
| Pro | Every tool | 50 calls |
| Pro Business | Every tool | 250 calls |
| API Starter, API Business | Every tool, shared with your REST budget | 1,000 or 10,000 units (most calls cost 1–2) |
| Enterprise | Every tool, shared with your REST budget | 10,000 units by default, more by contract |

A call is one request from the assistant to World Monitor. Allowances reset at 00:00 UTC. Upgrade at [worldmonitor.app/pro](https://www.worldmonitor.app/pro). Full limits are in [plans and limits](/mcp-overview#plans-&-limits).

## If something goes wrong

- **The sign-in window never opened.** Remove the connector and add it again, then click **Connect**. Pop-up blockers can stop the window.
- **Claude says "Connection has expired".** The sign-in lapses after 30 days without use. Open **Customize → Connectors → World Monitor** and click **Reconnect**.
- **The World Monitor window says sign-in was cancelled after a passkey prompt.** The passkey step was cancelled, timed out, or was closed by a password manager. Click **Sign in** to try again, or use the email code.
- **The code email didn't arrive.** Check spam or quarantine. Corporate filters sometimes hold it.
- **The assistant says it needs a subscription.** Your account is on the free plan. Upgrade, then ask again; there's no need to reconnect. The new plan usually applies within a minute, and at most 15 minutes later.
- **The assistant doesn't use World Monitor.** Make sure the connector is switched on for that chat, and mention World Monitor in your question.

## For developers: scripts and API keys

Scripts and servers can call the same endpoint with a `wm_…` key from an API Starter or higher plan. Create one in the [dashboard](https://www.worldmonitor.app/dashboard) under **Settings → API Keys**.

```bash
export WM_KEY="wm_0123456789abcdef0123456789abcdef01234567"  # Replace with your API key

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_data","arguments":{}}}'
```

Send the key in `X-WorldMonitor-Key`, not as a bearer token; a key sent as a bearer returns `401 invalid_token`. If you hold an OAuth access token from `/api/oauth/token`, send `Authorization: Bearer $TOKEN` instead.

Next steps for builders:

- **[MCP Server reference](/mcp-overview)**: authentication, the `mcp-remote` bridge, protocol details, response fields and errors.
- **[MCP Tools Reference](/mcp-tools-reference)**: every tool's parameters, freshness and examples.
- **[JMESPath guide](/mcp-jmespath)**: trim large responses server-side before they reach the model.
- **[Command-line client](/cli)** and **[SDKs](/sdks)**: the same tools from a terminal, Python, Ruby or Go.