MCP.Market

Basalam MCP server

by sepehr071·io.github.sepehr071/basalam-mcp·v0.1.2
No reviews yet

Unofficial read-only Basalam marketplace: search products, cheapest offers, shops, reviews.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

0 stars372 downloads/wk

Reviews

Write one

Nobody has reviewed Basalam yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Basalam tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan8 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 1 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Basalam compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 93% of 2,174 E-commerce servers
Downloads a week
372
more than 86% of 411 E-commerce servers with a package

Install Basalam in Claude Code, Cursor or VS Code

claude mcp add basalam-mcp -- uvx basalam-mcp
Add to Cursor

What the publisher says

From the Basalam repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.sepehr071/basalam-mcp -->

basalam-mcp: Basalam MCP server for AI agents

Let your AI agent shop on Basalam (باسلام). An unofficial, read-only MCP server for Basalam, Iran's marketplace of independent shops: search products, find the cheapest in-stock offers, read shops, categories and customer reviews, all from Claude, Cursor or Copilot.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

  • What: unofficial MCP server (model context protocol) for Basalam (basalam.com), Iran's marketplace of small shops. Persian queries match best; prices in Toman.
  • Install: uvx basalam-mcp or claude mcp add basalam -- uvx basalam-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none, no API key or account. Optional BASALAMMCPPROXY (HTTP proxy URL, or a comma-separated list).
  • Access: read-only. No login, basket, order, chat or review posting, so no confirmation is needed before calling any tool.
  • Tools: 7, all prefixed bs. Start with bssearch or bsfindcheapest. Typical sequence: bsfindcheapest -> bsproduct -> bsreviews.
  • Use when: finding, comparing or judging products, prices, shops and reviews on Basalam.
  • Do not use when: the user wants to buy something or needs anything behind a login.
  • Output: compact JSON. Prices in Toman (the API reports Rial; converted), ratings 0-5, null and empty fields omitted. A product link is https://basalam.com/p/.
  • Machine-readable: server.json and the

Why

Basalam is a marketplace of thousands of small shops, so the same kind of item is listed many times at very different prices, and a plain "cheapest first" sort is full of filler listings priced at a few hundred Toman. Finding the real cheapest offer, then checking the product options, the shop and what buyers say, takes a lot of clicking. With basalam-mcp an agent does it in a few calls: bsfindcheapest (filler prices hidden by default), bsproduct, bsvendor and bs_reviews.

What it can do

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Basalam: common questions

Is Basalam MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Basalam safety report
How do I install Basalam?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Basalam need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is Basalam maintained?
The last commit was 12 days ago (2026-10-23). The latest release is v0.1.2.
What can I use instead of Basalam?
Servers from other publishers that do the same job: Apiguru Amazon Data MCP server, HasData Walmart MCP server and Shopware MCP server. Compare all Basalam alternatives.
How does Basalam compare with other E-commerce MCP servers?
safety score 92/100 (higher than 93% of 2,174 E-commerce servers); downloads a week 372 (more than 86% of 411 E-commerce servers with a package). Full comparison.

Alternatives to Basalam

Same job from other publishers: the closest match first, then the best rated.

All Basalam alternatives →
  • Apiguru Amazon Data
    Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
    A
  • HasData Walmart
    Walmart search, product pages and customer reviews on walmart.com and walmart.ca, as JSON.
    More from hasdata.com →
    A
  • Shopware
    Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
    B
  • MXIK codes (Uzbekistan)
    Search MXIK (IKPU) product codes of Uzbekistan on tasnif.soliq.uz. Unofficial.
    A
  • Shopee
    MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)
    More from codespar →
    B