Aqarsas MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 8, 2026

Search Saudi deals, get market stats, rank top sales and look up property histories in Aqarsas.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinance Data & Analytics

Server details

Identifier: io.usefulapi/aqarsas
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 8, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Faqarsas.svg)](https://sourceweft.com/mcp/io.usefulapi%2Faqarsas?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted Aqarsas server for searching Saudi real estate transactions, market statistics, top sales, property histories and nearby comparable deals.

What you can do: Search registered Saudi real estate transactions by date, region, city, district, plan, unit, category, property type, price and area
Aggregate deal counts, total value or total area by category and property type for a date range and area
Rank transactions by total price, price per m² or area, highest or lowest first
Look up a land plot or property with its full transaction history, or find recent deals near a reference property
Check monthly usage, request a missing feature, upgrade or cancel a subscription
When to use it: Useful when you need Saudi real estate market evidence: district-level deal values, most expensive or cheapest sales, a property's deal history, or comparable sales around a specific plot.
Requirements: Remote streamable HTTP endpoint; no local install. Connect with the URL only and sign in through OAuth with your Aqarsas credentials; on first connect you supply an Aqarsas API key issued by Aqarsas support, which the server stores per user. Free plan allows 50 tool calls per month.

Before you install

The server asks for your Aqarsas credentials and an Aqarsas API key, which it stores per user. Meta tools can start a paid subscription through a Stripe Checkout link, change Pro to Pro+, or cancel; upgrades charge the price difference immediately and cancellations give no refund for the current period. Feature requests are recorded on your behalf. Search results are capped at 5,000 rows and RER deal ids are masked.

Installation

In SourceWeft

Open Aqarsas MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Faqarsas/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "aqarsas-by-usefulapi": {
      "type": "http",
      "url": "https://aqarsas.usefulapi.io/mcp"
    }
  }
}

README

Aqarsas MCP by usefulapi

Use your Aqarsas account from Claude, Cursor, or any MCP client. It reads registered Saudi real estate deals, market statistics, top sales, property histories and nearby comparable sales. Hosted, no local install: connect with your own credentials.

Live endpoint: https://aqarsas.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://aqarsas.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http aqarsas https://aqarsas.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Aqarsas credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/aqarsas/

On first connect you provide an Aqarsas API key, which Aqarsas support issues. The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`aqarsas_search_transactions`	read	Search real estate transactions
`aqarsas_get_market_stats`	read	Get market statistics
`aqarsas_get_top_transactions`	read	Get top transactions
`aqarsas_get_property_details`	read	Get property details
`aqarsas_find_nearby_transactions`	read	Find nearby transactions
`aqarsas_usage_status`	meta	Usage status (free-tier meter)
`aqarsas_request_feature`	meta	Request a missing feature
`aqarsas_upgrade`	meta	Upgrade to Pro or Pro+
`aqarsas_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

Each paid plan covers this server only. Ask your AI to run aqarsas_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with aqarsas_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with aqarsas_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/aqarsas/README.md at commit 0be0869

Tools

aqarsas_search_transactions

Search real estate transactions

Search registered Saudi real estate transactions by date, region, city, district, plan, unit, category, property type, price and area. The API returns up to 5,000 matching rows (a random 5,000 when more match); this tool returns the first `limit` of them. Each row has the date, category, property kind, price per m², total price, area, location, plan and unit, and a non-standard flag such as mortgage or gift. Aqarsas API: POST /transactions/.

Parametershaicitym566unitdtypelimitstatecalendarcategoryend_datemax_areamin_area+8 more

aqarsas_get_market_stats

Get market statistics

Aggregate Saudi real estate deal statistics: the number of deals, the total deal value, or the total area, broken down by category and property type, for a date range and a region, city or district. If hai is given, city is required. Aqarsas API: POST /stats/.

Parametershaicitystatecalendarend_datestat_typestart_date

aqarsas_get_top_transactions

Get top transactions

Rank Saudi real estate transactions by total deal price, price per m², or area, highest or lowest first, for a date range and a region, city or district. Date sorting is not offered here. Aqarsas API: POST /toptransactions/.

Parametershaicitystatesort_bycalendarend_dateresults_nstart_datehai_exact_matchsort_by_ascending

aqarsas_get_property_details

Get property details

Look up a land plot or property and return up to 5 matching records, each with its full transaction history (up to 100 deals per record). Use rer_realestate_number when known; otherwise give state, city, m566 and unit, and area to rank close matches. Spatial fields (coordinates, elevation, zoning) appear only for accounts with spatial access. Aqarsas API: POST /propertydetails/.

Parametersareacitym566unitstaterer_realestate_number

aqarsas_find_nearby_transactions

Find nearby transactions

Find recent deals on properties near a reference property, for comparable-sales analysis. The reference is identified by rer_realestate_number, or by state, city, m566 and unit (exactly one match is required). RER deal ids are masked by the API. Aqarsas API: POST /nearbytransactions/.

Parameterscitym566unitstaterer_realestate_number

Version history

v1.0.0LatestNov 8, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Productivity & Workflow9 toolsNov 8, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	10,000 tool calls / month
Pro+ (per user)	$39/mo or $390/yr (2 months free)	100,000 tool calls / month