mcp-market-ru
MCP server for the Russian construction market — 3,395 contractor companies and 13,436 house-building projects across 18 regions. 21 tools for search, comparison, cost analytics, contractor recommendations, and quote requests.
README
MCP Market Russia
Hosted Model Context Protocol (MCP) server providing AI agents with structured access to the Russian construction market: 3,395 contractor companies, 13,436 house-building projects, across 18 regions, exposed through 24 specialized tools.
- Live endpoint: https://mcp-market.ru/mcp/
- Interactive demo: https://mcp-market.ru/demo
- Dashboard: https://mcp-market.ru/dashboard
- Protocol: MCP v2024-11-05 (Streamable HTTP transport)
Why this server
Russia's construction market is fragmented across regional registries, vendor websites, and aggregators. AI assistants that try to answer "какие каркасные дома под ключ в Подмосковье до 3 млн руб?" end up hallucinating companies or linking to dead pages. mcp-market-ru exposes curated, structured data so agents can:
- recommend vetted contractors by category / region / budget / rating,
- estimate project cost from real market prices,
- send qualified quote requests straight to a vendor (Telegram + email notification),
- compare regions, prices, and companies analytically.
Quick start
Claude Desktop
Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mcp-market-ru": {
"command": "npx",
"args": ["mcp-remote", "https://mcp-market.ru/mcp/"]
}
}
}
Restart Claude Desktop. The 24 tools appear under the MCP icon.
Cursor, Windsurf, any Streamable-HTTP client
Point the client directly at https://mcp-market.ru/mcp/ — no wrapper required.
Python (mcp client)
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("https://mcp-market.ru/mcp/") as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("smart_match", {"brief": "каркасный дом 180 кв.м в Подмосковье до 15 млн"})
print(result)
Tools (24)
Search & catalog
| Tool | Purpose |
|---|---|
search_companies |
Search 3 395 contractors by category / region / budget / free-text query |
search_projects |
Search 13 436 house projects by area, floors, material, price |
get_company |
Full company profile: contacts, prices, rating, reviews, projects |
get_project |
Project specs, pricing, features, company contacts |
get_categories |
All categories + company count per category |
get_regions |
All 18 regions + company count per region |
get_stats |
Catalog totals + daily agent-query / lead counters |
export_search_csv |
Export companies/projects search results as CSV (UTF-8 with BOM, Excel-friendly) |
Analytics
| Tool | Purpose |
|---|---|
market_analytics |
Aggregate market view: segments, pricing bands, regional density |
market_report |
Narrative market report for a specified region |
trend_analyzer |
Company growth, price dynamics, rating changes over time |
price_comparison |
Prices across regions and categories side-by-side |
region_comparison |
Compare multiple regions on companies / projects / prices |
compare_companies |
Head-to-head comparison of 2–3 companies |
Recommendation & estimation
| Tool | Purpose |
|---|---|
find_best_companies |
Rank contractors matching budget, region, rating floor |
contractor_recommendation |
AI-weighted top picks with reasoning |
smart_match |
Natural-language Russian brief → parsed filters + top-N contractors |
calculate_cost |
Quick cost estimate from category + region + area |
project_estimator |
Detailed estimate with economy / standard / premium tiers |
Deep profiles
| Tool | Purpose |
|---|---|
company_portfolio |
Full portfolio: all projects, prices, reviews, contacts |
company_deep_profile |
Company profile plus reviews, categories, pricing history |
review_analysis |
Sentiment breakdown, themes, strengths & weaknesses |
Lead generation
| Tool | Purpose |
|---|---|
request_quote |
Submit a lead; vendor notified via Telegram + email |
get_lead_status |
Check status of a previously-submitted lead (new / contacted / won / lost) |
Pricing
| Tier | Limit | Tools |
|---|---|---|
| Free | 100 req/day | Search + catalog tools |
| Starter | 1 000 req/day | + Analytics |
| Pro | 10 000 req/day | + Recommendations + Deep profiles |
| Enterprise | custom | Everything + dedicated support |
Get an API key: https://mcp-market.ru/register
Data freshness
Data is refreshed weekly from public registries, vendor sites, and project portals. Coverage stats:
| Field | Fill rate |
|---|---|
| Description | 100 % |
| Rating | 94 % |
| Website | 62 % |
| Phone | 44 % |
| 30 % |
Last refresh: April 2026.
Architecture
- FastAPI + FastMCP over Streamable HTTP at
/mcp/ - PostgreSQL 16 for catalog & leads
- Content-negotiated landing at
/mcp/—text/htmlreturns docs,text/event-streamreturns the MCP transport - TLS via Let's Encrypt, hosted in Moscow datacenter
REST mirror available at /api/v1/... for non-MCP clients (see /api/endpoints).
License
MIT — see LICENSE.
Contact
- Site: https://mcp-market.ru/
- Issues: https://github.com/devids77/mcp-market-ru/issues
- Telegram: @Devavatar
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.