sheypoor-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHEYPOOR_LOG_LEVEL | No | Pino log level. | info |
| SHEYPOOR_TIMEOUT_MS | No | HTTP timeout in milliseconds. | 20000 |
| SHEYPOOR_COOKIE_FILE | No | Cookie jar path. Defaults to the OS config directory. | OS config dir |
| SHEYPOOR_MAX_DELAY_MS | No | Maximum throttle delay in milliseconds. | 1500 |
| SHEYPOOR_MIN_DELAY_MS | No | Minimum throttle delay in milliseconds. | 500 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_listingsA | Search Sheypoor listings. Returns one page of results (default 24). Supports free-text query, city, category, region, price range, and sorting. |
| search_listings_allA | Search Sheypoor listings and auto-paginate. Returns a merged list of up to N pages. Use this when the user wants 'all' or 'many' results. |
| get_search_suggestionsA | Get autocomplete suggestions for a search prefix in a given city. |
| get_popular_searchesB | Get trending search terms on Sheypoor. |
| get_listingA | Fetch full details of a Sheypoor listing by numeric ID. Returns title, price, seller, images, description, breadcrumbs, phone, actions. |
| get_listing_from_urlB | Fetch full details of a Sheypoor listing from its canonical URL. |
| get_listing_imagesB | Return only the full-size image URLs for a listing. |
| list_categoriesA | List top-level Sheypoor categories with their IDs and slugs. |
| get_category_treeA | Return the full category tree (or a subtree if parentId is given). |
| search_categoriesA | Fuzzy-search categories by name (Persian or English substring). |
| list_provincesA | List all Iranian provinces with their IDs and slugs. |
| list_citiesA | List cities within a province (by province slug or name fragment). |
| login_startA | Start Sheypoor login. Sends an SMS code to the given Iranian mobile number. Returns a sessionId you must pass to login_complete along with the code the user receives. |
| login_completeA | Complete Sheypoor login with the SMS code. Persists cookies for future sessions. |
| logoutA | Log out of Sheypoor: clear cookies and tokens. |
| whoamiA | Return the authenticated user's profile. |
| get_my_listingsA | List the authenticated user's listings. Requires login. |
| get_my_bookmarksB | List the authenticated user's saved/bookmarked listings. |
| get_my_walletsA | List the authenticated user's payment wallets. |
| get_chat_roomsA | List the authenticated user's chat rooms (in-app messaging). |
| get_chat_unreadA | Return the number of unread chat messages. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| find_cheapest | Find the cheapest listings for a product in a city. |
| analyze_listing | Analyze a Sheypoor listing in detail: price, seller, condition, red flags. |
| market_snapshot | Compute price statistics for a category in a city. |
| compare_listings | Compare several Sheypoor listings side by side. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| categories | The full Sheypoor category tree (2 levels). |
| locations | Province → city → district hierarchy for filtering. |
| versions | Data version timestamps for cache invalidation. |
TDQS
Scored across 21 tools
Most tools target clearly distinct resources or actions, and descriptions do a good job separating close variants like search_listings vs search_listings_all and get_listing vs get_listing_from_url. A few category-related tools overlap conceptually, but their scope is explained well enough to avoid serious misselection.
The set consistently uses lowercase snake_case and mostly follows list_/search_/get_/get_my_ patterns. Minor irregularities like login_start/login_complete, logout, and whoami break the strict verb_noun convention but are still predictable.
At 21 tools, the server sits in the heavy range and includes several closely related variants such as search_listings/search_listings_all and multiple category browsing tools. Each tool has a plausible purpose, but the surface could likely be consolidated without losing capability.
The tool set covers browsing, searching, authentication, and read-only account data well, but it lacks core marketplace lifecycle operations: no create/update/delete listing, no bookmark management, and no chat messaging beyond unread counts. These are significant gaps that will block common seller and buyer workflows on Sheypoor.