Server definition

Hash: sha256:4be920238690e8f5a2cc355efceb851cca55955937096eb345593319bc7a50a6
What it is: What a remote MCP server returned when asked what it offers: 24 tools

The blob, as servednamed by its sha256

{
  "instructions": "Russian construction companies and house projects catalog for AI agents.\n3,395 companies and 4,468 house projects across 18 regions. Data is scraped from 2GIS\nand company websites and is NOT independently verified — each company carries a `status`\nfield ('verified' / 'claimed' / 'auto'); treat 'auto' as unvetted. Contact details are\nmissing for many companies rather than guessed.\n\nAvailable tools:\n- search_companies — Find companies by category, region, budget. Returns website, phone, rating, reviews.\n- search_projects — Find house projects by area, floors, material, price. Returns project link + company contacts.\n- compare_companies — Compare 2-3 companies side by side on prices, ratings, specialization.\n- get_company / get_project — Full details with contacts and project listings.\n- calculate_cost — Estimate construction cost based on real market data (area, material, region).\n- get_categories / get_regions / get_stats — Reference data and catalog statistics.\n- request_quote — Send a lead/quote request to a company on behalf of the user.\n\nAlways include company website and phone in your response so the user can contact them directly.",
  "tools": [
    {
      "description": "Calculate estimated construction cost based on real market data from the catalog.\nUses average price per m² by material and region from actual company prices and projects.\n\nArgs:\n    area: House area in square meters (required, e.g. 120)\n    material: Building material (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP). Empty = average across all.\n    region: Region or city name for regional pricing. Empty = nationwide average.\n    floors: Number of floors (1 or 2). 0 = no adjustment.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "area": {
            "type": "integer"
          },
          "floors": {
            "default": 0,
            "type": "integer"
          },
          "material": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "required": [
          "area"
        ],
        "type": "object"
      },
      "name": "calculate_cost",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get comprehensive company profile with all available data - contacts, projects, pricing, \nreviews analysis, market position, and comparison with competitors in same region.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "company_deep_profile",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get FULL company portfolio: details, all projects, prices, reviews, contacts.\nComprehensive dossier for due diligence or hiring decisions.\nArgs:\n    company_slug: Company slug identifier (from search results).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "company_slug": {
            "type": "string"
          }
        },
        "required": [
          "company_slug"
        ],
        "type": "object"
      },
      "name": "company_portfolio",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Compare 2-3 construction companies side by side on prices, ratings, number of projects, and specialization.\n\nArgs:\n    company_ids: Comma-separated company UUIDs to compare (2-3 IDs). Example: 'uuid1,uuid2,uuid3'",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "company_ids": {
            "type": "string"
          }
        },
        "required": [
          "company_ids"
        ],
        "type": "object"
      },
      "name": "compare_companies",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "AI-powered contractor recommendation. Finds the best matching companies based on budget, region, quality requirements. Returns ranked list with match scores.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "budget_max": {
            "default": 0,
            "type": "number"
          },
          "budget_min": {
            "default": 0,
            "type": "number"
          },
          "category": {
            "default": "",
            "type": "string"
          },
          "min_rating": {
            "default": 4,
            "type": "number"
          },
          "need_contacts": {
            "default": true,
            "type": "boolean"
          },
          "need_portfolio": {
            "default": true,
            "type": "boolean"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "contractor_recommendation",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Export search results as CSV text (UTF-8 with BOM, Excel-friendly).\n\nentity: 'companies' or 'projects'\nquery: free-text search in name/description\ncategory, region: filter fields\nbudget_max: for companies, cap on min_project_price\nlimit: 1..2000 rows (default 500)\n\nReturns CSV text ready to save as .csv and open in Excel.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "budget_max": {
            "default": 0,
            "type": "number"
          },
          "category": {
            "default": "",
            "type": "string"
          },
          "entity": {
            "default": "companies",
            "type": "string"
          },
          "limit": {
            "default": 500,
            "type": "integer"
          },
          "query": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "export_search_csv",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Smart lead generation: find the best construction companies matching your criteria.\nPerfect for finding contractors, generating leads, or market research.\nArgs:\n    region: Filter by region name (e.g. 'Москва'). Empty = all.\n    category: Filter by category/subcategory. Empty = all.\n    min_rating: Minimum rating (0-5). 0 = no filter.\n    max_price: Maximum price per m2 in thousands RUB. 0 = no filter.\n    min_price: Minimum price per m2 in thousands RUB. 0 = no filter.\n    has_phone: Only companies with phone number.\n    has_projects: Only companies with project portfolio.\n    sort_by: Sort by: 'rating', 'price_asc', 'price_desc', 'reviews', 'projects'.\n    limit: Max results (1-50).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "has_phone": {
            "default": false,
            "type": "boolean"
          },
          "has_projects": {
            "default": false,
            "type": "boolean"
          },
          "limit": {
            "default": 20,
            "type": "integer"
          },
          "max_price": {
            "default": 0,
            "type": "number"
          },
          "min_price": {
            "default": 0,
            "type": "number"
          },
          "min_rating": {
            "default": 0,
            "type": "number"
          },
          "region": {
            "default": "",
            "type": "string"
          },
          "sort_by": {
            "default": "rating",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "find_best_companies",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get all company categories with the number of companies in each category.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_categories",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get full company profile including contacts, prices, rating, reviews, and list of house projects.\n\nArgs:\n    company_id: Company UUID from search_companies results",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "company_id": {
            "type": "string"
          }
        },
        "required": [
          "company_id"
        ],
        "type": "object"
      },
      "name": "get_company",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Check the status of a lead created via request_quote.\n\nlead_id: UUID returned by request_quote\napi_key: the api_key used when the lead was created\n\nReturns JSON with status (new/contacted/won/lost), company info,\ncontact fields, budget, timestamps.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "type": "string"
          },
          "lead_id": {
            "type": "string"
          }
        },
        "required": [
          "lead_id",
          "api_key"
        ],
        "type": "object"
      },
      "name": "get_lead_status",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get detailed house project information including specifications, price, features, and company contacts.\n\nArgs:\n    project_id: Project UUID from search_projects results",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "type": "object"
      },
      "name": "get_project",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get all available regions with the number of companies in each region.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_regions",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get catalog statistics: total companies, projects, regions, categories, agent queries today, and leads generated.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_stats",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Get comprehensive market analytics for the Russian construction market.\nReturns: average prices, top companies by rating, market size, price distribution.\nPerfect for investors, analysts, and companies entering the market.\nArgs:\n    region: Filter by region (e.g. 'Москва', 'Санкт-Петербург'). Empty = all regions.\n    category: Filter by category (e.g. 'Строительство домов'). Empty = all categories.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "market_analytics",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Generate a comprehensive market report for a specific region.\nIncludes: market size, price tiers, top players, contact availability, competitive landscape.\nPerfect for investors, business development, and market entry analysis.\nArgs:\n    region: Region name (e.g. 'Москва', 'Ленинградская область').",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "region": {
            "type": "string"
          }
        },
        "required": [
          "region"
        ],
        "type": "object"
      },
      "name": "market_report",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Compare construction prices across regions and categories.\nReturns detailed price statistics, percentiles, and regional rankings.\nArgs:\n    regions: Comma-separated regions to compare (e.g. 'Москва,Санкт-Петербург'). Empty = all.\n    category: Filter by category. Empty = all.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "regions": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "price_comparison",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Estimate construction project cost based on area, region, category and quality level (economy/standard/premium). Uses real market data from our database.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "area_sqm": {
            "type": "number"
          },
          "category": {
            "default": "",
            "type": "string"
          },
          "quality": {
            "default": "standard",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "required": [
          "area_sqm"
        ],
        "type": "object"
      },
      "name": "project_estimator",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Compare construction markets across regions. Provide comma-separated region names.\nShows companies count, ratings, prices, contact availability for each region side by side.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "regions": {
            "type": "string"
          }
        },
        "required": [
          "regions"
        ],
        "type": "object"
      },
      "name": "region_comparison",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Send a quote request to a construction company on behalf of the user.\nReturns confirmation with lead ID and company contact details.\n\nArgs:\n    company_id: Target company UUID (required)\n    project_id: Specific project UUID if the user is interested in a particular house project\n    name: Client's name for the quote request\n    phone: Client's phone number for callback\n    email: Client's email address\n    comment: Additional comments or requirements for the quote",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "comment": {
            "default": "",
            "type": "string"
          },
          "company_id": {
            "type": "string"
          },
          "email": {
            "default": "",
            "type": "string"
          },
          "name": {
            "default": "",
            "type": "string"
          },
          "phone": {
            "default": "",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "type": "string"
          }
        },
        "required": [
          "company_id"
        ],
        "type": "object"
      },
      "name": "request_quote",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "company_slug": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "review_analysis",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Search Russian construction companies by category, region, and budget.\nReturns company name, rating, prices, website, and phone number.\n\nArgs:\n    query: Free text search query (e.g. 'каркасные дома недорого', 'frame houses')\n    category: Company category filter (каркасные_дома, дома_из_бруса, газобетон, кирпич, недвижимость, модульные_дома, СИП)\n    region: Region or city name (e.g. 'Московская область', 'Санкт-Петербург', 'Краснодар')\n    budget_max: Maximum budget in rubles. Set to 0 for no limit.\n    limit: Number of results to return, maximum 20",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "budget_max": {
            "default": 0,
            "type": "integer"
          },
          "category": {
            "default": "",
            "type": "string"
          },
          "limit": {
            "default": 10,
            "type": "integer"
          },
          "query": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_companies",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Search house building projects by area, floors, material, and price.\nReturns project specifications, price, direct link, and company contacts.\n\nArgs:\n    area_min: Minimum house area in square meters. Set to 0 for no limit.\n    area_max: Maximum house area in square meters. Set to 0 for no limit.\n    floors: Number of floors/stories. Set to 0 for any.\n    material: Building material filter (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP)\n    budget_max: Maximum price in rubles. Set to 0 for no limit.\n    region: Filter by company region or city name\n    query: Free text search in project name and description\n    limit: Number of results to return, maximum 20",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "area_max": {
            "default": 0,
            "type": "integer"
          },
          "area_min": {
            "default": 0,
            "type": "integer"
          },
          "budget_max": {
            "default": 0,
            "type": "integer"
          },
          "floors": {
            "default": 0,
            "type": "integer"
          },
          "limit": {
            "default": 10,
            "type": "integer"
          },
          "material": {
            "default": "",
            "type": "string"
          },
          "query": {
            "default": "",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_projects",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Natural-language contractor search. Pass a free-form Russian brief\n(e.g. \"хочу каркасный дом 180 кв.м в Подмосковье до 15 млн\") and get\ntop-N matching contractors plus an explanation of how the brief was parsed.\n\nReturns JSON with: parsed filters, matches list, explanation.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "brief": {
            "type": "string"
          },
          "top_n": {
            "default": 5,
            "type": "integer"
          }
        },
        "required": [
          "brief"
        ],
        "type": "object"
      },
      "name": "smart_match",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    },
    {
      "description": "Current market snapshot by region, category, rating tier and price segment.\n\nThis is a distribution of the catalogue as it stands now, not a time series:\nwe do not store historical snapshots, so no growth or change-over-time can be\ncomputed. `period` is accepted for backwards compatibility and ignored.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "default": "",
            "type": "string"
          },
          "period": {
            "default": "all",
            "type": "string"
          },
          "region": {
            "default": "",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "trend_analyzer",
      "outputSchema": {
        "properties": {
          "result": {
            "type": "string"
          }
        },
        "required": [
          "result"
        ],
        "type": "object",
        "x-fastmcp-wrap-result": true
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:4be920238690e8f5a2cc355efceb851cca55955937096eb345593319bc7a50a6 | sha256sum