MCP Market Russia

io.github.devids77Published by GitHub account devids77v3.2.0Updated Oct 24, 2026

Russian construction market: 3,395 contractors, 20,322 projects, 24 search/analytics tools.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for the Russian construction market, letting an assistant search contractors and house projects, compare prices and request quotes.

What you can do
Search and read companies and house projects by category, region, area, material and budget, with full profiles and portfolios. Compare companies and prices across regions and categories. Estimate construction costs and generate market reports and analytics. Match a free-form brief to ranked contractors and export search results as CSV. Send quote requests to companies and check the status of a lead.
When to use it
Useful when researching Russian home-building contractors or projects, comparing regional prices, estimating build costs, or generating leads and market reports for the Russian construction market.
Requirements
A remote MCP endpoint; no registration or API key for the free catalog tier. Paid Analytics and AI Tools tiers need an API key passed as the X-API-Key header or an api_key query parameter. Network access to the hosted service.
Before you install
request_quote sends a quote request to a company on the user's behalf, including the client's name and contact details, and creates a lead; get_lead_status requires the api_key used when the lead was created. Paid tiers cost money (monthly plans). Catalog data is aggregated from public sources such as 2GIS, Avito and Yandex.

Installation

In SourceWeft

  1. Open MCP Market Russia in the dashboard and add it to a workspace.
  2. 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.github.devids77%2Fmcp-market-ru/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": {
    "market-russia": {
      "type": "http",
      "url": "https://mcp-market.ru/mcp/"
    }
  }
}

README

MCP Market Russia 🏗️

MCP server for the Russian construction and real estate market. Search 3,395 construction companies, browse 4,468 house projects, compare prices, request quotes — all via the Model Context Protocol or REST API.

[Live] [Stats] [Projects] [License]

Listed in the official MCP Registry as io.github.devids77/mcp-market-ru.

What this is

A live, hosted MCP server that gives AI agents (Claude Desktop, Cursor, Cline, Continue, etc.) direct access to a curated catalog of Russian construction companies and home-building projects, complete with pricing, ratings, regions, photos and contact info aggregated from public sources.

No registration needed for the basic catalog — point your MCP client at https://mcp-market.ru/mcp and start asking questions.

Quick start — Claude Desktop

Open your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: `%APPDATA%\Claude\claude_desktop_config.json

Add:

json
{  "mcpServers": {    "mcp-market": {      "url": "https://mcp-market.ru/mcp"    }  }}

Restart Claude Desktop. The 24 tools are now available — Claude will call them automatically when you ask construction-related questions.

Quick start — Cursor

Settings → MCP → Add new MCP server. URL: https://mcp-market.ru/mcp

Quick start — REST API

Free tier works without an API key:

bash
# Search companiescurl "https://mcp-market.ru/api/v1/search/companies?q=каркасные+дома+в+спб"
# Get a specific companycurl "https://mcp-market.ru/api/v1/companies/<company_id>"
# Search projects by area and budgetcurl "https://mcp-market.ru/api/v1/search/projects?q=брус+150&min_price=3000000"
# Catalog statscurl "https://mcp-market.ru/api/dashboard/stats"

Paid tiers (Analytics, AI Tools) require an API key — pass it as X-API-Key header or ?api_key= query param.

What you can ask

Example prompts that work well with the MCP server:

  • "Find frame houses (каркасные дома) in Moscow region under 12 million rubles"
  • "Compare timber (брус) projects between 120-150 m²"
  • "Show top-10 companies in Krasnodar region by rating"
  • "Send a quote request to company X with my contact details"
  • "What's the average price per m² for monolith houses in St Petersburg?"

The server supports both Russian and English queries with proper synonym handling for Russian regions (спб → Saint Petersburg, мск → Moscow, etc.) and construction terminology.

Available tools

ToolTierDescription
search_companiesFreeSearch construction companies by category, region, budget, tags
search_projectsFreeSearch house projects by area, price, material
get_companyFreeFull company details with all projects
get_projectFreeComplete project card (specs, price, photos)
get_categoriesFreeList all company categories with counts
get_regionsFreeList all regions with company counts
get_statsFreeCatalog statistics
smart_matchFreeMatch companies to budget + region + category
request_quoteFreeSend a lead/quote request to a company
compareFreeCompare multiple companies side-by-side
calculateFreeProject cost estimator
analytics/marketStarterRegional market analytics
analytics/best-companiesStarterTop companies with extended metrics
analytics/price-comparisonStarterPrice comparison across segments
analytics/reportStarterFull analytical report
ai/recommendProAI recommendations for client criteria
ai/estimateProAI cost estimate from project description
ai/reviewsProAI-summarized reviews per company
ai/trendsProAI market trend analysis
ai/deep-profileProDeep company profile with insights
ai/region-compareProAI comparison of regions

Pricing

PlanPriceRequests/dayTools
Free₽010024 (all Free-tier tools)
Starter₽2 990/mo1 00024 + Analytics
Pro₽7 990/mo5 00024 + Analytics + AI Tools
Enterprise₽24 990/mounlimited24 + custom, SLA, white-label

Get a key at https://mcp-market.ru/pricing.

Data

  • 3,395 companies aggregated from public sources (2GIS, Avito, construction catalogs, Yandex)
  • 4,468 projects with specs, materials, area, price, photos
  • 18 regions covered (Moscow, St Petersburg, Krasnodar, Yekaterinburg, …)
  • 67% tagged via regex + GLM-4.6 classifier — search by tag works for queries like "bath house in Krasnodar"
  • Live data: companies and projects refreshed periodically; check /dashboard for current counts

For construction companies

Your company is already in the catalog? Claim your profile to:

  • Edit your description, photos, and contact info
  • Add detailed project portfolios
  • Receive leads from AI agents directly to your inbox + Telegram
  • Get analytics on which AI queries reached your card

Email [email protected] to claim.

Architecture

  • FastAPI + FastMCP for HTTP + MCP transport layered on the same /mcp/ endpoint
  • PostgreSQL 16 with full-text + GIN-indexed tag array
  • Docker Compose deployment
  • Nginx + Let's Encrypt for HTTPS termination
  • Single-flight cache on heavy endpoints (dashboard/overview is 30s)

Links

Error codes

CodeMeaning
200OK
400Bad request parameters
401API key required for this endpoint
403Your plan doesn't cover this endpoint
404Not found
429Daily request limit exceeded
500Server error — report to [email protected]

License

MIT

Source: README.md at commit dca8f54

Tools

24

search_companies

Search Russian construction companies by category, region, and budget. Returns company name, rating, prices, website, and phone number. Args: query: Free text search query (e.g. 'каркасные дома недорого', 'frame houses') category: Company category filter (каркасные_дома, дома_из_бруса, газобетон, кирпич, недвижимость, модульные_дома, СИП) region: Region or city name (e.g. 'Московская область', 'Санкт-Петербург', 'Краснодар') budget_max: Maximum budget in rubles. Set to 0 for no limit. limit: Number of results to return, maximum 20

Parameterslimitqueryregioncategorybudget_max

search_projects

Search house building projects by area, floors, material, and price. Returns project specifications, price, direct link, and company contacts. Args: area_min: Minimum house area in square meters. Set to 0 for no limit. area_max: Maximum house area in square meters. Set to 0 for no limit. floors: Number of floors/stories. Set to 0 for any. material: Building material filter (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP) budget_max: Maximum price in rubles. Set to 0 for no limit. region: Filter by company region or city name query: Free text search in project name and description limit: Number of results to return, maximum 20

Parameterslimitqueryfloorsregionarea_maxarea_minmaterialbudget_max

compare_companies

Compare 2-3 construction companies side by side on prices, ratings, number of projects, and specialization. Args: company_ids: Comma-separated company UUIDs to compare (2-3 IDs). Example: 'uuid1,uuid2,uuid3'

Parameterscompany_idsrequired

calculate_cost

Calculate estimated construction cost based on real market data from the catalog. Uses average price per m² by material and region from actual company prices and projects. Args: area: House area in square meters (required, e.g. 120) material: Building material (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP). Empty = average across all. region: Region or city name for regional pricing. Empty = nationwide average. floors: Number of floors (1 or 2). 0 = no adjustment.

Parametersarearequiredfloorsregionmaterial

get_company

Get full company profile including contacts, prices, rating, reviews, and list of house projects. Args: company_id: Company UUID from search_companies results

Parameterscompany_idrequired

get_project

Get detailed house project information including specifications, price, features, and company contacts. Args: project_id: Project UUID from search_projects results

Parametersproject_idrequired

get_categories

Get all company categories with the number of companies in each category.

Takes no parameters.

get_regions

Get all available regions with the number of companies in each region.

Takes no parameters.

get_stats

Get catalog statistics: total companies, projects, regions, categories, agent queries today, and leads generated.

Takes no parameters.

request_quote

Send a quote request to a construction company on behalf of the user. Returns confirmation with lead ID and company contact details. Args: company_id: Target company UUID (required) project_id: Specific project UUID if the user is interested in a particular house project name: Client's name for the quote request phone: Client's phone number for callback email: Client's email address comment: Additional comments or requirements for the quote

Parametersnameemailphonecommentcompany_idrequiredproject_id

market_analytics

Get comprehensive market analytics for the Russian construction market. Returns: average prices, top companies by rating, market size, price distribution. Perfect for investors, analysts, and companies entering the market. Args: region: Filter by region (e.g. 'Москва', 'Санкт-Петербург'). Empty = all regions. category: Filter by category (e.g. 'Строительство домов'). Empty = all categories.

Parametersregioncategory

find_best_companies

Smart lead generation: find the best construction companies matching your criteria. Perfect for finding contractors, generating leads, or market research. Args: region: Filter by region name (e.g. 'Москва'). Empty = all. category: Filter by category/subcategory. Empty = all. min_rating: Minimum rating (0-5). 0 = no filter. max_price: Maximum price per m2 in thousands RUB. 0 = no filter. min_price: Minimum price per m2 in thousands RUB. 0 = no filter. has_phone: Only companies with phone number. has_projects: Only companies with project portfolio. sort_by: Sort by: 'rating', 'price_asc', 'price_desc', 'reviews', 'projects'. limit: Max results (1-50).

Parameterslimitregionsort_bycategoryhas_phonemax_pricemin_pricemin_ratinghas_projects

price_comparison

Compare construction prices across regions and categories. Returns detailed price statistics, percentiles, and regional rankings. Args: regions: Comma-separated regions to compare (e.g. 'Москва,Санкт-Петербург'). Empty = all. category: Filter by category. Empty = all.

Parametersregionscategory

company_portfolio

Get FULL company portfolio: details, all projects, prices, reviews, contacts. Comprehensive dossier for due diligence or hiring decisions. Args: company_slug: Company slug identifier (from search results).

Parameterscompany_slugrequired

market_report

Generate a comprehensive market report for a specific region. Includes: market size, price tiers, top players, contact availability, competitive landscape. Perfect for investors, business development, and market entry analysis. Args: region: Region name (e.g. 'Москва', 'Ленинградская область').

Parametersregionrequired

review_analysis

Reputation summary from the aggregate star rating and review count, benchmarked against the region average. Provide company_slug for one company, or region/category for a market overview. Review texts are not stored, so no per-review sentiment or themes are returned.

Parametersregioncategorycompany_slug

contractor_recommendation

AI-powered contractor recommendation. Finds the best matching companies based on budget, region, quality requirements. Returns ranked list with match scores.

Parametersregioncategorybudget_maxbudget_minmin_ratingneed_contactsneed_portfolio

project_estimator

Estimate construction project cost based on area, region, category and quality level (economy/standard/premium). Uses real market data from our database.

Parametersregionqualityarea_sqmrequiredcategory

trend_analyzer

Current market snapshot by region, category, rating tier and price segment. This is a distribution of the catalogue as it stands now, not a time series: we do not store historical snapshots, so no growth or change-over-time can be computed. `period` is accepted for backwards compatibility and ignored.

Parametersperiodregioncategory

company_deep_profile

Get comprehensive company profile with all available data - contacts, projects, pricing, reviews analysis, market position, and comparison with competitors in same region.

Parametersslugrequired

region_comparison

Compare construction markets across regions. Provide comma-separated region names. Shows companies count, ratings, prices, contact availability for each region side by side.

Parametersregionsrequiredcategory

export_search_csv

Export search results as CSV text (UTF-8 with BOM, Excel-friendly). entity: 'companies' or 'projects' query: free-text search in name/description category, region: filter fields budget_max: for companies, cap on min_project_price limit: 1..2000 rows (default 500) Returns CSV text ready to save as .csv and open in Excel.

Parameterslimitqueryentityregioncategorybudget_max

smart_match

Natural-language contractor search. Pass a free-form Russian brief (e.g. "хочу каркасный дом 180 кв.м в Подмосковье до 15 млн") and get top-N matching contractors plus an explanation of how the brief was parsed. Returns JSON with: parsed filters, matches list, explanation.

Parametersbriefrequiredtop_n

get_lead_status

Check the status of a lead created via request_quote. lead_id: UUID returned by request_quote api_key: the api_key used when the lead was created Returns JSON with status (new/contacted/won/lost), company info, contact fields, budget, timestamps.

Parametersapi_keyrequiredlead_idrequired

Version history

1
  1. v3.2.0LatestSep 16, 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