MCP Market Russia — Quickstart

Connect an AI agent to 3,395 Russian construction contractors and 20,322 projects in under a minute. No account required for the basic catalog.

companies projects 24 tools license MIT

1. Endpoint

Single streamable-HTTP endpoint:

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

No path tokens, no per-tenant URLs. Agents speak JSON-RPC 2.0 with the standard MCP protocol (revision 2024-11-05).

2. Connect your client

Edit your Claude Desktop config:

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

Restart Claude Desktop. Then ask: "Find me 3 top-rated panel-house contractors in St. Petersburg."

In Cursor settings, add an MCP server:

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

Cursor restarts the MCP daemon on save. Test with: "Use mcp-market to compare three modular-home builders."

Cline and Continue both accept the same streamable-HTTP config:

{
  "mcp-market": {
    "transport": "streamable-http",
    "url": "https://mcp-market.ru/mcp/"
  }
}

Direct JSON-RPC via curl (handshake + first tool call):

# 1. Initialize and capture session id
SID=$(curl -sf -D - https://mcp-market.ru/mcp/ \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",\
       "params":{"protocolVersion":"2024-11-05","capabilities":{},\
                 "clientInfo":{"name":"curl","version":"1"}}}' \
  | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r')

# 2. List tools
curl -sf https://mcp-market.ru/mcp/ \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -H "mcp-session-id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

3. Try a real query

Ask your agent

4. The 24 tools at a glance

Free (no API key) — 11 tools

search_companies, search_projects, compare_companies, calculate_cost, get_company, get_project, get_categories, get_regions, get_stats, smart_match, request_quote.

Pro (API key) — 13 more

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, get_lead_status.

See /pricing for tier details or hit tools/list for the live schema.

5. FAQ

Do I need an API key?

No, not for the 11 free tools. Anonymous agents are first-class citizens. Register at /pricing only if you want analytics, AI tools, or higher rate limits.

What is the rate limit?

Anonymous: ~120 requests/minute per IP (soft). Free key: 1,000/day. Pro: 50,000/day.

How fresh is the data?

3,395 companies and 20,322 projects aggregated from open public sources; 67% of companies have machine-classified category tags (Phase 3 classifier, April 2026).

Is the source open?

Yes — MIT licensed, code at github.com/devids77/mcp-market-ru. The server is also reachable as a remote MCP transport, so you do not need to self-host.

What about Russian queries?

Fully supported. The search layer uses a Russian suffix-strip stemmer and tag-priority OR clauses; queries like каркасные дома в СПб return correct hits.

6. Where to go next