MCP Market Russia

Official24 toolsLive

by devids77 · Python

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

io.github.devids77/mcp-market-ru — MCP Market Russia

MCP Market Russia is an MCP server for the Russian construction and real estate market. It provides search and analytics capabilities covering contractors and house projects, enabling lookups and quote requests via Model Context Protocol (MCP) or a REST API. Server stats include 3,395 contractors and 20,322 projects.

🛠️ Key Features

24 search/analytics tools (toolCount: 24)
Contractor search (3,395)
Project browsing (20,322)
Compare prices and request quotes

🚀 Use Cases

Lead generation for construction and real estate
Discovering construction companies and house projects
Requesting price quotes for projects

⚡ Developer Benefits

Access via MCP or REST API (as described in the readme excerpt)
Tagged topics include model-context-protocol, fastmcp, streamable-http, and claude

⚠️ Limitations

Scope is stated as the Russian construction and real estate market.

Topics

ai-agentsclaudefastmcplead-generationmcpmodel-context-protocolrussian-marketstreamable-httpconstruction-market

Captured live from the server via tools/list.

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

Parameters5

query	string	optional
category	string	optional
region	string	optional
budget_max	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "budget_max": {
      "default": 0,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

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

Parameters8

area_min	integer	optional
area_max	integer	optional
floors	integer	optional
material	string	optional
budget_max	integer	optional
region	string	optional
query	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "area_min": {
      "default": 0,
      "type": "integer"
    },
    "area_max": {
      "default": 0,
      "type": "integer"
    },
    "floors": {
      "default": 0,
      "type": "integer"
    },
    "material": {
      "default": "",
      "type": "string"
    },
    "budget_max": {
      "default": 0,
      "type": "integer"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "query": {
      "default": "",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

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'

Parameters1

company_ids

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "company_ids": {
      "type": "string"
    }
  },
  "required": [
    "company_ids"
  ],
  "additionalProperties": false
}

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.

Parameters4

area	integer	required
material	string	optional
region	string	optional
floors	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "area": {
      "type": "integer"
    },
    "material": {
      "default": "",
      "type": "string"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "floors": {
      "default": 0,
      "type": "integer"
    }
  },
  "required": [
    "area"
  ],
  "additionalProperties": false
}

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

Parameters1

company_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string"
    }
  },
  "required": [
    "company_id"
  ],
  "additionalProperties": false
}

get_project

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

Parameters1

project_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false
}

get_categories

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_regions

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_stats

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

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

Parameters6

company_id	string	required
project_id	string	optional
name	string	optional
phone	string	optional
email	string	optional
comment	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string"
    },
    "project_id": {
      "default": "",
      "type": "string"
    },
    "name": {
      "default": "",
      "type": "string"
    },
    "phone": {
      "default": "",
      "type": "string"
    },
    "email": {
      "default": "",
      "type": "string"
    },
    "comment": {
      "default": "",
      "type": "string"
    }
  },
  "required": [
    "company_id"
  ],
  "additionalProperties": false
}

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.

Parameters2

region	string	optional
category	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    }
  },
  "additionalProperties": false
}

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).

Parameters9

region	string	optional
category	string	optional
min_rating	number	optional
max_price	number	optional
min_price	number	optional
has_phone	boolean	optional
has_projects	boolean	optional
sort_by	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "min_rating": {
      "default": 0,
      "type": "number"
    },
    "max_price": {
      "default": 0,
      "type": "number"
    },
    "min_price": {
      "default": 0,
      "type": "number"
    },
    "has_phone": {
      "default": false,
      "type": "boolean"
    },
    "has_projects": {
      "default": false,
      "type": "boolean"
    },
    "sort_by": {
      "default": "rating",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

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.

Parameters2

regions	string	optional
category	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "regions": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    }
  },
  "additionalProperties": false
}

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).

Parameters1

company_slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "company_slug": {
      "type": "string"
    }
  },
  "required": [
    "company_slug"
  ],
  "additionalProperties": false
}

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. 'Москва', 'Ленинградская область').

Parameters1

region

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "additionalProperties": false
}

review_analysis

Analyze company reviews - sentiment breakdown, common themes, strengths and weaknesses. Provide company_slug for specific company or region/category for market overview.

Parameters3

company_slug	string	optional
region	string	optional
category	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_slug": {
      "default": "",
      "type": "string"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    }
  },
  "additionalProperties": false
}

contractor_recommendation

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

Parameters7

budget_min	number	optional
budget_max	number	optional
region	string	optional
category	string	optional
min_rating	number	optional
need_portfolio	boolean	optional
need_contacts	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "budget_min": {
      "default": 0,
      "type": "number"
    },
    "budget_max": {
      "default": 0,
      "type": "number"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "min_rating": {
      "default": 4,
      "type": "number"
    },
    "need_portfolio": {
      "default": true,
      "type": "boolean"
    },
    "need_contacts": {
      "default": true,
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

project_estimator

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

Parameters4

area_sqm	number	required
region	string	optional
category	string	optional
quality	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "area_sqm": {
      "type": "number"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "quality": {
      "default": "standard",
      "type": "string"
    }
  },
  "required": [
    "area_sqm"
  ],
  "additionalProperties": false
}

trend_analyzer

Analyze market trends - company growth, price dynamics, rating changes by region/category. Shows how the construction market is developing over time.

Parameters3

region	string	optional
category	string	optional
period	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "period": {
      "default": "all",
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

Parameters1

slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

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.

Parameters2

regions	string	required
category	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "regions": {
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    }
  },
  "required": [
    "regions"
  ],
  "additionalProperties": false
}

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.

Parameters6

entity	string	optional
query	string	optional
category	string	optional
region	string	optional
budget_max	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "entity": {
      "default": "companies",
      "type": "string"
    },
    "query": {
      "default": "",
      "type": "string"
    },
    "category": {
      "default": "",
      "type": "string"
    },
    "region": {
      "default": "",
      "type": "string"
    },
    "budget_max": {
      "default": 0,
      "type": "number"
    },
    "limit": {
      "default": 500,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

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.

Parameters2

brief	string	required
top_n	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string"
    },
    "top_n": {
      "default": 5,
      "type": "integer"
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false
}

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.

Parameters2

lead_id	string	required
api_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "string"
    },
    "api_key": {
      "type": "string"
    }
  },
  "required": [
    "lead_id",
    "api_key"
  ],
  "additionalProperties": false
}

README.md7 KBView on GitHub

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.

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 companies
curl "https://mcp-market.ru/api/v1/search/companies?q=каркасные+дома+в+спб"

# Get a specific company
curl "https://mcp-market.ru/api/v1/companies/<company_id>"

# Search projects by area and budget
curl "https://mcp-market.ru/api/v1/search/projects?q=брус+150&min_price=3000000"

# Catalog stats
curl "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

Tool	Tier	Description
`search_companies`	Free	Search construction companies by category, region, budget, tags
`search_projects`	Free	Search house projects by area, price, material
`get_company`	Free	Full company details with all projects
`get_project`	Free	Complete project card (specs, price, photos)
`get_categories`	Free	List all company categories with counts
`get_regions`	Free	List all regions with company counts
`get_stats`	Free	Catalog statistics
`smart_match`	Free	Match companies to budget + region + category
`request_quote`	Free	Send a lead/quote request to a company
`compare`	Free	Compare multiple companies side-by-side
`calculate`	Free	Project cost estimator
`analytics/market`	Starter	Regional market analytics
`analytics/best-companies`	Starter	Top companies with extended metrics
`analytics/price-comparison`	Starter	Price comparison across segments
`analytics/report`	Starter	Full analytical report
`ai/recommend`	Pro	AI recommendations for client criteria
`ai/estimate`	Pro	AI cost estimate from project description
`ai/reviews`	Pro	AI-summarized reviews per company
`ai/trends`	Pro	AI market trend analysis
`ai/deep-profile`	Pro	Deep company profile with insights
`ai/region-compare`	Pro	AI comparison of regions

Pricing

Plan	Price	Requests/day	Tools
Free	₽0	100	24 (all Free-tier tools)
Starter	₽2 990/mo	1 000	24 + Analytics
Pro	₽7 990/mo	5 000	24 + Analytics + AI Tools
Enterprise	₽24 990/mo	unlimited	24 + 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 info@mcp-market.ru 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)

Error codes

Code	Meaning
200	OK
400	Bad request parameters
401	API key required for this endpoint
403	Your plan doesn't cover this endpoint
404	Not found
429	Daily request limit exceeded
500	Server error — report to info@mcp-market.ru

License

MIT

Install

Tools (24)

search_companiessearch_projectscompare_companiescalculate_costget_companyget_projectget_categoriesget_regions

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-market.ru/mcp/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-market-ru": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-market.ru/mcp/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.devids77/mcp-market-ru — MCP Market Russia

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_companies

search_projects

compare_companies

calculate_cost

get_company

get_project

get_categories

get_regions

get_stats

request_quote

market_analytics

find_best_companies

price_comparison

company_portfolio

market_report

review_analysis

contractor_recommendation

project_estimator

trend_analyzer

company_deep_profile

region_comparison

export_search_csv

smart_match

get_lead_status

MCP Market Russia 🏗️

What this is

Quick start — Claude Desktop

Quick start — Cursor

Quick start — REST API

What you can ask

Available tools

Pricing

Data

For construction companies

Architecture

Links

Error codes

License

Install

Remote endpoint

Related servers