Somantic

endpoint

https://www.somantic.net/api/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is Somantic live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is Somantic free to use?

Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.

What tools does Somantic have?

3 tools: search_listings, estimate_value, get_listing.

Is Somantic safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• search_listings auth-required 1h ago

  Search current real-estate listings in Germany, newest first. Returns listings with facts, Somantic's valuation (somantic_valuation_eur, price_vs_valuation_pct: negative means priced below it) and source_url, the original listing on the portal that carries the offer. `last_seen` is when Somantic last confirmed the offer as online. Listings no longer confirmed are usually removed from results after 3 days. One offer is often advertised on several portals at once. Those copies are collapsed to the newest, so a page can hold fewer than `per_page` listings and `total` counts the copies rather than the offers.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276

  {
    "type": "object",
    "properties": {
      "q": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Where — a city (\"München\", \"Frankfurt am Main\") or a postcode (\"80331\")."
      },
      "page": {
        "type": "integer",
        "default": 1,
        "description": "Result page, starting at 1."
      },
      "vacant": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Only listings that are vacant (bezugsfrei)."
      },
      "roi_min": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Minimum gross rental yield in percent, e.g. 5 for 5 %. Purchases only."
      },
      "features": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "enum": [
                "balcony",
                "garden",
                "elevator",
                "parking",
                "kitchen",
                "new_building"
              ],
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Required amenities. \"new_building\" keeps only new builds\n(Neubau, Erstbezug, or built within the last 3 years)."
      },
      "per_page": {
        "type": "integer",
        "default": 20,
        "description": "Results per page, at most 50."
      },
      "property": {
        "enum": [
          "wohnung",
          "haus"
        ],
        "type": "string",
        "default": "wohnung",
        "description": "\"wohnung\" (apartment) or \"haus\" (house)."
      },
      "size_max": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Maximum living space in m²."
      },
      "size_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Minimum living space in m²."
      },
      "year_max": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Built before this year."
      },
      "year_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Built in or after this year."
      },
      "price_max": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Maximum price in EUR; monthly cold rent when transaction is \"mieten\"."
      },
      "price_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Minimum price in EUR; monthly cold rent when transaction is \"mieten\"."
      },
      "rooms_max": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Maximum number of rooms."
      },
      "rooms_min": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Minimum number of rooms (German count, e.g. 2.5)."
      },
      "transaction": {
        "enum": [
          "kaufen",
          "mieten"
        ],
        "type": "string",
        "default": "kaufen",
        "description": "\"kaufen\" to buy, \"mieten\" to rent."
      },
      "energy_class": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Energy efficiency classes, e.g. \"A+,A,B\"."
      },
      "price_change": {
        "anyOf": [
          {
            "enum": [
              "reduced",
              "increased",
              "any"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Only listings whose price changed while listed: \"reduced\",\n\"increased\" or \"any\"."
      },
      "price_per_sqm_max": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Maximum price per m² in EUR; cold rent per m² when\ntransaction is \"mieten\"."
      },
      "price_per_sqm_min": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Minimum price per m² in EUR; cold rent per m² when\ntransaction is \"mieten\"."
      },
      "renovation_needed": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Only listings that need renovation (renovierungsbedürftig)."
      },
      "price_below_market": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Only listings priced below Somantic's valuation."
      },
      "exclude_erbbaurecht": {
        "type": "boolean",
        "default": false,
        "description": "Leave out leasehold (Erbbaurecht) properties."
      },
      "exclude_foreclosures": {
        "type": "boolean",
        "default": false,
        "description": "Leave out foreclosure auctions (Zwangsversteigerungen)."
      }
    },
    "additionalProperties": false
  }

  arguments 276 lines copy
• estimate_value auth-required 1h ago

  Estimate what a German address is worth to buy and to rent. Works for any address, listed or not. The estimate comes from comparable listings around it, so `confidence` and `sample_size` say how much to trust it - a thin sample means a wide, weakly supported band. Returns `estimate` (point values, ranges and €/m² for price and rent) and `confidence`. A point estimate is absent when too few comparables back it; the €/m² band and `sample_size` still say what was found. This is a model output, not an appraisal, and no comparable listing is reproduced in it.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122

  {
    "type": "object",
    "required": [
      "street",
      "postcode",
      "city",
      "living_space_sqm"
    ],
    "properties": {
      "city": {
        "type": "string",
        "description": "City name, e.g. \"München\"."
      },
      "floor": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Floor the flat is on."
      },
      "rooms": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Number of rooms (German count, e.g. 2.5). Improves the estimate."
      },
      "rented": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "True values it as sold with a sitting tenant, False as sold\nbezugsfrei - in Germany the same flat is worth markedly less with\none. Leave it out unless you know which it is."
      },
      "street": {
        "type": "string",
        "description": "Street and house number, e.g. \"Marienplatz 1\". Required: without\nit the answer would silently describe the middle of the postcode."
      },
      "features": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "enum": [
                "balcony",
                "basement",
                "elevator",
                "garden",
                "kitchen",
                "parking",
                "terrace",
                "new_building"
              ],
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Equipment the property has. Only what it *has* - a feature\nleft out is treated as unknown, not as absent."
      },
      "postcode": {
        "type": "string",
        "description": "Five-digit German postcode, e.g. \"80331\"."
      },
      "property": {
        "enum": [
          "wohnung",
          "haus"
        ],
        "type": "string",
        "default": "wohnung",
        "description": "\"wohnung\" (apartment) or \"haus\" (house)."
      },
      "year_built": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Year of construction. Improves the estimate."
      },
      "property_type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "A narrower type such as \"reihenhaus\" or \"etagenwohnung\";\nan unknown value is refused with the list of accepted ones."
      },
      "living_space_sqm": {
        "type": "number",
        "description": "Living area in m²."
      }
    },
    "additionalProperties": false
  }

  arguments 122 lines copy
• get_listing auth-required 1h ago

  Details of one listing: facts, Somantic's valuation, and the link to the original. No description text: it is the advertiser's, at source_url. A withdrawn (inactive) listing is not returned: the call fails with "No listing", since the offer no longer exists. `image_urls` is always empty: Somantic passes on no photos. They are the advertiser's, at source_url.

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "The listing id from search_listings."
      },
      "property": {
        "anyOf": [
          {
            "enum": [
              "wohnung",
              "haus"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "\"wohnung\" or \"haus\" if known; both are tried otherwise."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.