# MCP Market Russia

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

- name: io.github.devids77/mcp-market-ru
- version: 3.2.0
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.devids77%2Fmcp-market-ru
- tools: https://api.protogrid.dev/v1/servers/io.github.devids77%2Fmcp-market-ru/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "mcp-market-ru": {
      "type": "http",
      "url": "https://mcp-market.ru/mcp/"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-99d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_categories (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_companies (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); market_analytics (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 3,008 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 24, about 3,008 tokens to load them all
- tool set hash: 499f80dd71bbb3db682bef8141293993
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.devids77/mcp-market-ru.svg)](https://protogrid.dev/servers/io.github.devids77/mcp-market-ru)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp-market.ru/mcp/ (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (24)

- `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.
- `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.
- `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).
- `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'
- `contractor_recommendation`: AI-powered contractor recommendation. Finds the best matching companies based on budget, region, quality requirements. Returns ranked list with match scores.
- `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.
- `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).
- `get_categories`: Get all company categories with the number of companies in each category.
- `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
- `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.
- `get_project`: Get detailed house project information including specifications, price, features, and company contacts.

Args:
    project_id: Project UUID from search_projects results
- `get_regions`: Get all available regions with the number of companies in each region.
- `get_stats`: Get catalog statistics: total companies, projects, regions, categories, agent queries today, and leads generated.
- `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.
- `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. 'Москва', 'Ленинградская область').
- `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.
- `project_estimator`: Estimate construction project cost based on area, region, category and quality level (economy/standard/premium). Uses real market data from our database.
- `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.
- `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
- `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.
- `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
- `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
- `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.
- `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.
