sepehr071

Basalam MCP — AI skill for Claude Code

AI community

Unofficial read-only MCP server for Basalam (basalam.com): lets AI agents search products, find the cheapest in-stock offers, and read shops, categories and customer reviews with prices in Toman.

How to install Basalam MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sepehr071/basalam-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Basalam MCP does

Unofficial read-only MCP server for Basalam (basalam.com): lets AI agents search products, find the cheapest in-stock offers, and read shops, categories and customer reviews with prices in Toman. باسلام، خرید آنلاین، مقایسه قیمت، ارزان‌ترین

Alternatives in AI

Anthropic Quickstarts — by Anthropic - Offers comprehensive development guides for three distinct AI-powered demo projects with standa 15.4k ★
Ooda Subagents — OODA Loop AI Agents - Observe, Orient, Decide, Act framework for systematic problem-solving 170 ★
Manus — Delegate complex tasks to Manus AI agent for deep research, market analysis, product comparisons, stock analys 159 ★

README

basalam-mcp: Basalam MCP server for AI agents

**Let your AI agent shop on Basalam (باسلام).**
An unofficial, read-only MCP server for [Basalam](https://basalam.com), 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.

[![PyPI](https://img.shields.io/pypi/v/basalam-mcp?color=2563eb)](https://pypi.org/project/basalam-mcp/) [![Python](https://img.shields.io/pypi/pyversions/basalam-mcp)](https://pypi.org/project/basalam-mcp/) [![CI](https://github.com/sepehr071/basalam-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sepehr071/basalam-mcp/actions/workflows/ci.yml) [![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.sepehr071%2Fbasalam--mcp-7c3aed)](https://registry.modelcontextprotocol.io/?q=basalam-mcp) [![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/basalam-mcp/blob/main/LICENSE)

[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_basalam--mcp-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=basalam&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22basalam-mcp%22%5D%7D)

[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [What it can do](#what-it-can-do) · [Tools](#tools) · [FAQ](#faq) · [فارسی](#فارسی)

For AI agents

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 BASALAM_MCP_PROXY (HTTP proxy URL, or a comma-separated list).