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
https://ashum.ai/mcpIt 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:
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.
- In Claude Desktop, open Settings, then Developer, and press Edit Config. That opens
claude_desktop_config.json. - Add Ashum under
mcpServers, with your key in place of YOUR_KEY. - Save the file, quit Claude Desktop completely and open it again.
{
"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:
{
"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.
| Tool | What it returns | A call costs |
|---|---|---|
list_news | Stories, newest first. | 1 request for every 25 stories |
get_story | A single story, with the same story in other outlets and related coverage from the days around it. | 1 request |
search_news | Stories about a subject, best match first. | 1 request for every 25 stories |
top_news | The 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_outlets | Every outlet Ashum reads, when it was last checked, and whether that check worked. | 1 request |
list_news_sections | The seven sections stories are sorted into, and what each one covers. | 1 request |
list_dfm_companies | Everything 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_company | One 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_disclosures | What DFM companies have filed with the exchange, newest first: results, board decisions, dividends, notices. | 1 request for every 25 disclosures |
get_dfm_disclosure | A 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_prices | A share's daily prices as DFM gives them, oldest first, in UAE dirhams. | 1 request |
get_dfm_financials | A 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_calendar | The dates on DFM's calendar: board meetings, general assemblies, earnings calls and the dates of a dividend. | 1 request |
get_dfm_ownership | How 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_flows | What 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_trades | The block trades DFM lists (it calls them direct deals), newest first, in UAE dirhams. | 1 request |
get_dfm_margin_trading | A 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_list | The 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_ranking | DFM'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_figures | The dated figures Ashum keeps, each with its latest value. | 1 request |
get_uae_figure_history | One dated figure day by day, newest first. | 1 request |
get_ashum_balance | Where 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.