How do I install Adona Robot Market Data?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Adona Robot Market Data need an API key?

No required environment variable is listed on this record.

What transport does Adona Robot Market Data use?

Adona Robot Market Data is reached over HTTP.

When was Adona Robot Market Data last checked?

Last checked 2026-11-08. Forex and gold data API: real-time XAUUSD and FX, 1s candles, redistribution allowed, from CHF 500.

Adona Robot Market Data MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.adona-robot.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.adona-robot-market-data https://api.adona-robot.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.adona-robot-market-data": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.adona-robot.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.2.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Adona Robot market data: examples and MCP server

Runnable examples for the Adona Robot market-data API, and the configuration to connect an AI agent to its MCP server.

Adona Robot sells one-second OHLC candles and a live bid/ask quote stream for 46 FX pairs and 5 spot metals, over REST and WebSocket. It is priced by capacity: the month's peak of simultaneous connections and slices of 1000 bars, not per seat. Redistribution is allowed on every paid plan: show the data in your product, relay it to your own clients, keep what you receive. A symbol you follow live for more than 80% of its open hours in a month adds CHF 150 to that month's invoice, on top of the plan.

Facts as of 2026-10-03. The current ones are always on adona-robot.com and, machine-readable, in spec.json and symbols.json.

Plan	CHF a month, before VAT	Sized for (simultaneous connections)	Slices of 1000 bars a month
Trial, 7 days, free	0	3	2 500 a day
Starter	500	30	750 000
Growth	1 200	100	2 500 000
Scale	2 400	300	7 500 000
Enterprise	5 000	1 000	25 000 000

The trial carries EURUSD and XAUUSD with 7 days of history; every paid plan carries all 51 symbols. A paid plan never refuses a connection: the month's reading sets the next invoice's plan. Above Enterprise: [email protected].

1. Get a key

Open an account with your company email address (one trial per company).
Confirm the address, sign in, and create the key on your account page. It is shown once: keep it on your server, never in a web page or a repository.
Export it for the examples:
```
export ADONA_API_KEY=YOUR_API_KEY
```

The quickstart walks through the same steps on the site.

2. How a call works

Your API key stays on your server. It is exchanged at POST /v1/tokens for a twelve-hour token per end user of yours (end_user_id).
History: GET /v1/candles?symbol=EURUSD&timeframe=S1, timeframes S1, M1, M5, M15, H1, H4, D1, up to 5000 bars a page, oldest first, prices as strings. next_before is the cursor to the page before (null when there is nothing older). On S1 a page covers one day, so an empty page with a cursor is an empty day (a weekend): continue with the cursor.
Live: POST /v1/ws-ticket with the token gives a single-use ticket. Open wss://api.adona-robot.com/v1/stream offering two subprotocols, adona.data.v1 and ticket.<ticket> (never in the URL), then send a subscribe frame with channels such as quote:EURUSD and candle:EURUSD:M1.
A refusal answers {"detail": "CODE"}: branch on the code. Every code and what to do about it is in the API reference, and the contract is machine-readable at openapi.json.

3. Examples

The Python and JavaScript history examples and the Python stream are the code of the quickstart's tabs, unchanged.

	History	Live stream
curl	`curl/history.sh`	`curl/stream-ticket.sh` (the ticket; a WebSocket client opens the stream)
Python 3.9+	`python/history.py`	`python/stream.py`
JavaScript	`javascript/history.mjs`, Node 18+	`javascript/stream.mjs`, Node 22+ (global `WebSocket`); the same frames as the quickstart's browser snippet

The Python examples need two packages, once: pip install requests websockets.

./curl/history.sh                   # the latest 1000 EURUSD one-minute bars
python python/history.py            # the latest 1000 EURUSD one-minute bars
python python/stream.py             # quotes and one-minute bars, until Ctrl-C
node javascript/history.mjs
node javascript/stream.mjs quote:XAUUSD candle:XAUUSD:M1

Each one prints refused: with the status and the API's answer, and stops, when the API says no (a wrong key answers INVALID_CUSTOMER_KEY). For a browser, keep the key on your server and hand the page a token: the site publishes a token server and a browser client with reconnection, and history.py keeps a local store of the bars it has fetched, so closed history is paid for once.

The guides/ folder holds the code of the guides on the site, the same files: one-minute history, paged back (guides/history_m1.py), the live stream (guides/stream.mjs) and the MCP server for an agent (guides/mcp.sh). The Python guide shows python/history.py and python/stream.py.

check/run.sh runs every example once against production and prints OK or KO for each.

Notebooks and the Python client

Three notebooks open in Google Colab, with the API key taken from Colab's secrets (ADONA_API_KEY) or typed, never written into the notebook:

Notebook	What it does
`notebooks/eurusd_1s.ipynb`	The last hour of EURUSD at one second, as a pandas DataFrame, and its price updates per minute
`notebooks/gold_live.ipynb`	Thirty seconds of XAUUSD's live bid and ask, and its one-second bars as they close
`notebooks/mcp.ipynb`	The MCP server called by hand: the offer and a month's price without a key, candles with one

The first two use adona-market-data, the Python client (pip install "adona-market-data[all]"): candles paged back into pandas, the live stream with reconnection, and refusals with their code.

4. Symbols

46 FX pairs and 5 metals (XAUUSD, XAGUSD, XAUEUR, XPTUSD, XPDUSD). The list, with each symbol's history dates, is on adona-robot.com/en/symbols and in symbols.json; every symbol has its own page, for example EURUSD.

5. Connect an AI agent (MCP)

The MCP server is at https://api.adona-robot.com/mcp (streamable HTTP, stateless). Four tools:

Tool	What it answers	Key
`get_offer`	The plans, prices, limits, trial, continuous feed and links	No
`list_symbols`	Every symbol a paid plan carries, with its name and class	No
`quote_price_for`	The plan and the CHF total, before VAT, for a month of usage	No
`get_candles`	Candle history for one symbol, one page, oldest first	Yes, billed like `GET /v1/candles`

The key, when you want get_candles, travels on every call in the Authorization: Bearer header, or in an X-API-Key header for a client or gateway that keeps Authorization for itself (X-API-Key: YOUR_API_KEY, no Bearer). Send one key: two different keys in the two headers, or two different X-API-Key values, are refused as CONFLICTING_API_KEYS. Keep the key in an environment variable, not in a file you commit.

Claude Code: put mcp/claude-code.mcp.json in your project as .mcp.json (it reads ADONA_API_KEY from your environment; unset, the keyless tools still work), or add it from the command line:

claude mcp add --transport http adona-robot https://api.adona-robot.com/mcp \
  --header "Authorization: Bearer $ADONA_API_KEY"

Cursor: put mcp/cursor.mcp.json in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global); it reads ${env:ADONA_API_KEY}.

Claude Desktop and claude.ai: Customize, then Connectors, then Add custom connector, with the URL https://api.adona-robot.com/mcp and the authentication "No sign-in" (on Team and Enterprise, an owner adds it under Organization settings, then Connectors). The three keyless tools work as is. For get_candles, add the request header Authorization with the value Bearer YOUR_API_KEY, or X-API-Key with the value YOUR_API_KEY, where your account offers request headers (a beta, not yet open to every account).

Then ask, for example: "What would 40 simultaneous users cost on Adona Robot?"

Without a client, the server answers plain JSON-RPC: see curl/mcp.sh.

Support

[email protected], by email on business days. Security reports: adona-robot.com/en/security.

The code in this repository is under the MIT License. The data you read with it is governed by the terms of service.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Adona Robot Market Data?

Does Adona Robot Market Data need an API key?

What transport does Adona Robot Market Data use?

When was Adona Robot Market Data last checked?

Documentation

Adona Robot market data: examples and MCP server

1. Get a key

2. How a call works

3. Examples

Notebooks and the Python client

4. Symbols

5. Connect an AI agent (MCP)

Support