MCP server and API

Use the BrokerData data in your AI assistant or your own software. Every user of every plan gets a personal key.

In your AI assistant (MCP)

Add BrokerData to an AI tool that connects to a remote MCP server with your own header, such as Claude Code, Cursor, VS Code, or an agent you build on the OpenAI or Anthropic API. Then ask in plain language: "How busy is the German market this month?", "Who gains brand share in the UK?", "Which sites do AI answers cite for brokers in Spain?"

  1. Make a key on your account page.
  2. In your tool, add a remote MCP server with the address https://brokerdata.io/mcp.
  3. Send the key as the header Authorization: Bearer <your key>.

In your own software (API)

The same address and the same key work as an API. Your software sends a JSON-RPC call over HTTPS and gets JSON back: for example the market climate for your own dashboard, or the competitor table for a weekly report.

curl https://brokerdata.io/mcp \
  -H "Authorization: Bearer $BROKERDATA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_market",
                 "arguments":{"market":"Germany"}}}'
Reference

What you can ask for

ToolWhat it givesArguments
list_markets All markets, with the map and a short summary of each. None
get_market One market: the acquisition climate, market size, brand concentration and the outlook. market, period (optional)
list_brokers Find brokers by name or by market. market (optional), query (optional), limit (optional), offset (optional)
get_broker One broker, by domain, brand name or alias: its markets, reputation, an overview of its position and what changed, per market. domain, page (optional), market (optional)
get_broker_market One broker in one market: brand share, visibility, campaigns, competitors or AI sources. domain, market, page (optional), period (optional)
compare_brokers The competitor table and charts of a market, all brokers side by side, or only the brokers you name. market, brokers (optional)
get_ai_source_landscape The sites that AI answers cite for brokers in a market. market
get_campaigns The ads and creatives of a broker in a market. domain, market

What an answer holds

Name a broker by its domain, its brand name or an alias, for example comdirect.de, eToro or Interactive Brokers. When a name is unknown or shared by two brokers, the error lists the closest brokers with their domains.

Every chart has a unit: %, pt, index, searches, visits, rating, rank, channels, creatives or reviews. Every period has a frequency of day, week or month. Its bounds from and to are written yyyy-mm-dd for day and week data and yyyy-mm for month data.

A value that is null is never zero. It means one of three things: the value was not measured; it was measured but is published as a bound, given in the field of the same name ending in _limit (for example level_limit); or it is a change that counts as stable, with direction flat. A period's direction is always one of up, flat, down or unmeasured; direction_text holds the words the page shows, such as “Busy” or “Share broadly stable”.

Limits and keys

Each key may make at most 120 requests in each period of one minute; a key of an Enterprise account may make 600. The period moves with time; it is not a fixed clock minute. There is no separate burst limit and no limit on simultaneous connections. A request above the limit gets HTTP 429 with a Retry-After header that gives the seconds to wait.

A key works like your login: keep it secret. You can make more than one key and take a key back at any time on your account page; that key then stops working at once.

See the full picture for your markets

Every number, every broker and all of the history, from EUR 99 a month. Not sure yet? We show you around in a live demo.

Log in

Enter your email address. We send you a link that logs you straight in, no password needed.