docs/mcp-quickstart.mdx
Rama main · réplica de lectura del repositorio original.
---
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.