ASHUMGulf news and Dubai stocks, live

Ashum in your AI assistant

Ashum’s MCP server gives an AI assistant the endpoints of the Ashum API as tools: Gulf news from 42 outlets, the companies of Dubai Financial Market (DFM) with their prices, disclosures and financials, the Central Bank of the UAE’s exchange rates, UAE fuel prices and oil spot prices. Each call is paid from your Ashum requests, at the API’s price.

The address

Server address
https://ashum.ai/mcp

It answers over Streamable HTTP. Your key goes in the Authorization header as Bearer YOUR_KEY, the same key as for the API. Sign in and create a key.

Price

A tool call costs what its endpoint costs: $0.005 a request, and a list of stories or disclosures 1 request for every 25 in it. Listing the tools is free, a call that ends in an error costs nothing, and get_ashum_balance is always free.

A new account starts with 200 trial requests, which reach the last 30 days. The keys, the balance and the limit of 300 requests a minute for each key are the same for the API and the MCP server. API pricing

Claude Code

Run this once, with your key in place of YOUR_KEY:

Command
claude mcp add --transport http ashum https://ashum.ai/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop

Claude Desktop reaches the server through mcp-remote, an open-source bridge it runs with Node.js, so Node.js must be installed.

  1. In Claude Desktop, open Settings, then Developer, and press Edit Config. That opens claude_desktop_config.json.
  2. Add Ashum under mcpServers, with your key in place of YOUR_KEY.
  3. Save the file, quit Claude Desktop completely and open it again.
Configuration
{
  "mcpServers": {
    "ashum": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://ashum.ai/mcp",
        "--header", "Authorization:${ASHUM_AUTH}"
      ],
      "env": { "ASHUM_AUTH": "Bearer YOUR_KEY" }
    }
  }
}

The key sits in env, not in args: on Windows, Claude Desktop does not keep a space inside args whole.

Cursor

Add Ashum to ~/.cursor/mcp.json, and put your key in the environment variable ASHUM_API_KEY:

Configuration
{
  "mcpServers": {
    "ashum": {
      "url": "https://ashum.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:ASHUM_API_KEY}" }
    }
  }
}

claude.ai and ChatGPT

Coming: signing in with your Ashum account, with no key to copy. That is what claude.ai (on the web, the desktop app and phones) and ChatGPT need to add the server as a connector. Until then, use Ashum from the apps above with a key.

Other apps

Any app that connects to MCP servers over Streamable HTTP and lets you set a request header: give it the address above and the header Authorization: Bearer YOUR_KEY.

Tools

One tool for each endpoint of the API. Each takes its endpoint’s parameters, described as in the API docs; the name opens the endpoint there.

ToolWhat it returnsA call costs
list_newsStories, newest first.1 request for every 25 stories
get_storyA single story, with the same story in other outlets and related coverage from the days around it.1 request
search_newsStories about a subject, best match first.1 request for every 25 stories
top_newsThe stories that two or more outlets carried in the last 24 hours, the most widely carried first.1 request for every 25 stories
list_news_outletsEvery outlet Ashum reads, when it was last checked, and whether that check worked.1 request
list_news_sectionsThe seven sections stories are sorted into, and what each one covers.1 request
list_dfm_companiesEverything listed on Dubai Financial Market (DFM) today, in order of symbol: shares, funds, ETFs and REITs, each with its latest price.1 request
get_dfm_companyOne DFM company as its page on ashum.ai shows it: the whole price line, its profile, the symbols it traded under before, the coming dates on DFM's calendar, and when it has filed its results in past years.1 request
list_dfm_disclosuresWhat DFM companies have filed with the exchange, newest first: results, board decisions, dividends, notices.1 request for every 25 disclosures
get_dfm_disclosureA single disclosure with the text of each attached document, a page at a time, and the address of the original file at DFM.1 request
get_dfm_pricesA share's daily prices as DFM gives them, oldest first, in UAE dirhams.1 request
get_dfm_financialsA DFM company's headline figures by period: revenue (or, for a bank, total income), profit, cash from operations, total assets and total equity.1 request
get_dfm_calendarThe dates on DFM's calendar: board meetings, general assemblies, earnings calls and the dates of a dividend.1 request
get_dfm_ownershipHow a DFM company's shares are held by the holder's nationality, by session, newest first, with the limit on foreign holders; and its largest shareholders as DFM lists them.1 request
get_dfm_investor_flowsWhat each kind of investor, and investors of each nationality, bought and sold on DFM in a session, newest session first, in UAE dirhams.1 request
get_dfm_block_tradesThe block trades DFM lists (it calls them direct deals), newest first, in UAE dirhams.1 request
get_dfm_margin_tradingA DFM share's margin trading by week, newest first, in UAE dirhams, as DFM's weekly report gives it: the shares available for margin trading, and what was bought and sold on margin in the week.1 request
get_dfm_sharia_listThe DFM companies on DFM's own list of Shari'a-compliant companies for a quarter: the newest list held, or the quarter asked for.1 request
get_dfm_broker_rankingDFM's ranking of its brokers for a month, first by the value they traded, in UAE dirhams, with each broker's share of the market's value, volume and trades.1 request
get_uae_figuresThe dated figures Ashum keeps, each with its latest value.1 request
get_uae_figure_historyOne dated figure day by day, newest first.1 request
get_ashum_balanceWhere the account stands: the requests it holds, what they are worth, and how many calls it made today.Free

Some tools ask for less than their endpoint. The lists of stories and disclosures (list_news, search_news, top_news and list_dfm_disclosures) come 25 at a time at most, one request’s worth. When the assistant does not say, get_dfm_disclosure gives 5 pages of a filing’s text at a time and get_dfm_financials the periods of the last 3 years, and the answer says how to ask for the rest.

Answers

A tool answers with its endpoint’s JSON, then one line: what the call cost, the requests left, the page of ashum.ai that shows the same data, and the source’s credit where it asks for one (© Central Bank of the UAE, on every exchange rate).

An answer longer than 40 KB is more than an assistant takes in at once. The tool then shows as much as fits, cut between two items, and says how to ask for the rest: the cursor, the date or the from_page to call again with. The call is charged as the API charged it: for a list of stories or disclosures, asked for 25 at a time, that is 1 request however it is cut.

Errors

A tool call with no key, or with a key that is not recognised or was revoked, is answered with HTTP 401 (missing_key, invalid_key). Many calls with wrong keys from one address are answered with HTTP 429 (too_many_attempts): wait a minute.

Any other error comes back inside the tool’s answer, marked as an error, with the API’s code and message, and costs nothing: an argument the tool does not take, no requests left (balance_required), a date further back than trial requests reach (funds_required), nothing with that id or symbol (not_found), or more calls in a minute than a key may make (rate_limited, with the seconds to wait). Every error code

Your key

Ashum reads a key only from the Authorization header, never from the address. Your keys are made and revoked on your account; a revoked key stops working at the next call. Something this page does not answer? Write to support@convertlyft.com.