MCP-Server

SPACEXPLORATION

com.spacexploration/listings
Immobilien Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Searches and manages commercial real-estate listings, saved searches, property attributes, media, geocoding, and custom-domain listing content.

attach_listing_photo
Attach Listing Photo Tool
Attach a photo to a listing you own directly from its public URL — one call, no separate sign/upload/confirm. The server fetches the image and ingests it with auto-generated thumbnail/hero/full variants. Only https image URLs whose host is publicly routable are accepted. The photo is content-moderated (must be real-estate related and safe) before it can appear publicly — the returned snapshot includes the moderation_status (approved / rejected / escalated) and moderation_reason. A rejected or escalated photo will not be publicly visible and will block publishing until removed or replaced.
Eingabeschema
{'type': 'object', 'required': ['hashid', 'source_url'], 'properties': {'hashid': {'type': 'string', 'description': 'Hashid of the listing to attach the photo to.'}, 'source_url': {'type': 'string', 'description': 'Public https URL of the image to fetch and attach. Must point directly at an image (jpeg, png, webp, gif, avif, heic/heif) on a publicly-routable host.'}}}
confirm_attachment_upload
Confirm Attachment Upload Tool
Finalize an out-of-band upload after the file bytes have been PUT to the presigned URL. Verifies the stored object matches what was signed (size and content-type) and marks the attachment ready. Returns the attachment snapshot with its public variant URLs. Idempotent: confirming an already-confirmed upload returns the same snapshot.
Eingabeschema
{'type': 'object', 'required': ['attachment_id'], 'properties': {'attachment_id': {'type': 'string', 'description': 'The attachment_id (ULID) returned by sign_attachment_upload. Confirm only after the file bytes have been successfully PUT to the presigned URL.'}}}
create_listing
Create Listing Tool
Create a new draft listing. Returns the full created listing exactly as stored, including its hashid and status. Pass an idempotency_key (any client-generated string, e.g. a UUID) to make the call safe to retry — re-sending the same key returns the original listing instead of creating a duplicate.
Eingabeschema
{'type': 'object', 'required': ['street_address', 'city', 'county', 'state', 'postal_code', 'latitude', 'longitude', 'property_type', 'listing_type'], 'properties': {'city': {'type': 'string', 'description': 'City.'}, 'unit': {'type': ['string', 'null'], 'description': 'Unit or suite number, if applicable.'}, 'state': {'type': 'string', 'description': 'State (2-letter abbreviation).'}, 'county': {'type': 'string', 'description': 'County.'}, 'latitude': {'type': 'number', 'description': 'Latitude coordinate.'}, 'place_id': {'type': ['string', 'null'], 'description': 'Place ID from geocoder.'}, 'longitude': {'type': 'number', 'description': 'Longitude coordinate.'}, 'postal_code': {'type': 'string', 'description': 'ZIP/postal code.'}, 'listing_type': {'enum': ['sale', 'lease'], 'type': 'string', 'description': 'Listing type: sale or lease.'}, 'property_type': {'type': 'string', 'description': 'Property type. Allowed values are listed under the property_type attribute returned by get_registry (e.g. industrial, office, retail, land).'}, 'street_address': {'type': 'string', 'description': 'Street address of the property.'}, 'idempotency_key': {'type': ['string', 'null'], 'description': 'Optional client-generated key (e.g. a UUID) making this create safe to retry: re-sending the same key within 24 hours returns the originally created listing instead of a duplicate.'}, 'formatted_address': {'type': ['string', 'null'], 'description': 'Full formatted address string from geocoder.'}}}
delete_saved_search
Delete Saved Search Tool
Delete a saved search by its ID. Only the owner may delete their own searches. Requires authentication.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'The numeric ID of the saved search to delete (from list_my_saved_searches).'}}}
geocode_address
Geocode Address Tool
Geocode a free-form US address into coordinates and structured components (street_address, city, county, state, postal_code) plus a formatted address and place_id — exactly the identity fields create_listing requires. Use this first, then pass the result straight into create_listing instead of supplying your own coordinates.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Free-form address to geocode, e.g. "3763 Imperial St, Frederick, CO 80516".'}}}
get_listing
Get Listing Tool
Retrieve the full details of a single listing by its hashid. Returns the complete ListingResource projection including parcel data, all attribute details, and attachments. Broker contact is included only when the requesting user is authorised.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['hashid'], 'properties': {'hashid': {'type': 'string', 'description': 'The short hashid of the listing (e.g. "a1b2c3d4"). Found in listing URLs and search hits.'}}}
get_registry
Get Registry Tool
Returns the full attribute registry — every searchable and filterable field, its type, allowed values, and display label. Read this first to understand the schema before calling search_listings with attribute filters.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {}}
interpret_search
Interpret Search Tool
Translate a natural-language property-search sentence into a structured filter payload compatible with search_listings. Use this as a transparent intermediate step: pass the user's raw query here, then forward the returned filters — and the returned bounds, when present (they carry the "near <place>" intent) — to search_listings.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'description': 'A natural-language property search sentence from the end user. Example: "industrial with rail access in Denver under $5m".'}}}
list_my_listings
List My Listings Tool
List all listings owned or brokered by the authenticated user. Optionally filter by status. Requires authentication.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'status': {'type': ['string', 'null'], 'description': 'Filter by listing status. One of: draft, pending_payment, active, suspended, sold, leased, withdrawn. Omit to return all statuses.'}}}
list_my_saved_searches
List My Saved Searches Tool
List the authenticated user's saved searches, including their filters and alert schedule. Requires authentication.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {}}
save_search
Save Search Tool
Save the current search as a named alert. The user will receive email digests when new matching listings appear. Requires authentication.
Eingabeschema
{'type': 'object', 'properties': {'name': {'type': ['string', 'null'], 'description': 'A human-readable name for the saved search. If omitted, a name is derived from the filters.'}, 'query': {'type': ['string', 'null'], 'description': 'The free-text query string, if any.'}, 'filters': {'type': ['object', 'null'], 'description': 'The structured filter map to persist (same shape as search_listings filters).'}}}
search_listings
Search Listings Tool
Search commercial real estate listings. Returns paginated hits with facet counts. For AI-driven search, call interpret_search first to convert a natural-language query into structured filters, then pass those filters — and its bounds, when present — here.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': ['integer', 'null'], 'description': 'Page number (1-based). Defaults to 1.'}, 'sort': {'type': ['string', 'null'], 'description': 'Sort key. Valid values from get_registry sort_options (e.g. "listed_at:desc", "price:asc").'}, 'query': {'type': ['string', 'null'], 'description': 'Free-text search query (street address, city, or keyword). Omit or pass null for no text filter.'}, 'bounds': {'type': ['object', 'null'], 'properties': {'ne_lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'ne_lng': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'sw_lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'sw_lng': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'description': 'Geographic bounding box (degrees) limiting hits to an area. Forward the bounds returned by interpret_search verbatim to honour "near <place>" intent; omit for a nationwide search.'}, 'filters': {'type': ['object', 'null'], 'description': 'Structured filter map keyed by Typesense field name. Ranges as {min?, max?}, multi-select as string[], booleans as true/false. Call get_registry to see valid field names and allowed values.'}}}
set_listing_attributes
Set Listing Attributes Tool
Set broker-authored attributes on a listing you own. Pass `attributes` as a map of registry field name to value (the field names get_registry returns, e.g. {"attr_parking_spaces": 40, "attr_office_class": "Class A"}). Only fields get_registry marks "writable":true can be set; publish-time computed fields and hot columns (use update_listing for those) are rejected with guidance. Enum fields take the allowed value (or an array for multiselect); send null to clear a field. Returns the full updated listing.
Idempotent
Eingabeschema
{'type': 'object', 'required': ['hashid', 'attributes'], 'properties': {'hashid': {'type': 'string', 'description': 'Hashid of the listing to update.'}, 'attributes': {'type': 'object', 'description': 'Map of registry field name to value, e.g. {"attr_parking_spaces": 40, "attr_office_class": "Class A", "attr_industrial_rail_access": true}. Only fields get_registry marks "writable":true are accepted. Multiselect enum fields take an array of allowed values. Send null to clear a field.'}}}
sign_attachment_upload
Sign Attachment Upload Tool
Begin an out-of-band file upload. Returns a presigned R2 PUT URL and the headers to use; the file bytes are uploaded directly to storage, never through this channel. After PUTting the file, call confirm_attachment_upload with the returned attachment_id. Supports listings (photos, documents), users (avatar), teams (logo), and pages (cover, photos). Avatars and logos pass an automated content check before they appear publicly.
Eingabeschema
{'type': 'object', 'required': ['attachable_type', 'attachable_id', 'filename', 'content_type', 'size'], 'properties': {'size': {'type': 'integer', 'description': 'Exact byte size of the file. Verified against the uploaded object at confirm time, so it must be accurate.'}, 'filename': {'type': 'string', 'description': 'Original filename including extension, e.g. "front-elevation.jpg". Used to derive the storage key and extension.'}, 'collection': {'type': ['string', 'null'], 'description': 'Optional explicit collection: "photos", "documents", "avatar", "logo", or "cover". Omit to auto-route by MIME (images→photos, docs→documents). Singleton slots (avatar/cover/logo) must be set explicitly.'}, 'content_type': {'type': 'string', 'description': 'MIME type of the file, e.g. "image/jpeg" or "application/pdf". Must match the collection whitelist.'}, 'attachable_id': {'type': 'string', 'description': 'Identifier of the attachable resource. For "listing" pass the listing hashid (e.g. "d5yqqgoa") — the same id every read tool returns. For "user" pass "me" to attach to yourself. For "page" pass its numeric id.'}, 'attachable_type': {'type': 'string', 'description': 'Morph alias of the resource to attach to: "listing", "user", or "page".'}}}
update_listing
Update Listing Tool
Update a listing's parcel, pricing, or marketing data. Pass at least one group (parcel, pricing, marketing); send each group whole, not just the changed field. Returns the full updated listing exactly as stored.
Idempotent
Eingabeschema
{'type': 'object', 'required': ['hashid'], 'properties': {'hashid': {'type': 'string', 'description': 'Hashid of the listing to update.'}, 'parcel': {'type': ['object', 'null'], 'description': 'Parcel/address fields to update: street_address, city, county, state, postal_code, latitude, longitude, and optionally unit, lot_size (INTEGER SQUARE FEET — convert acres × 43,560), lot_size_unit (the unit the size was stated in: sqft | acres | sqm | hectares; display-only), year_built, property_type.'}, 'pricing': {'type': ['object', 'null'], 'description': 'Pricing fields to update: listing_type (sale|lease); for a sale set sale_price (dollars), for a lease set lease_rate (per the lease_rate_period basis, default per_sqft_year) and optionally lease_rate_period (per_sqft_year|per_sqft_month|per_month|per_year). Omit the price and set price_on_request=true for "price upon request". Optionally expires_at (ISO date).'}, 'marketing': {'type': ['object', 'null'], 'description': 'Marketing copy to update: headline, summary, title_override, highlights (string[]).'}}}
Geändert
sign_attachment_upload
1. October 2026 02:54
Hinzugefügt
confirm_attachment_upload
17. September 2026 12:37
Hinzugefügt
sign_attachment_upload
17. September 2026 12:37
Hinzugefügt
attach_listing_photo
17. September 2026 12:37
Hinzugefügt
set_listing_attributes
17. September 2026 12:37
Hinzugefügt
update_listing
17. September 2026 12:37
Hinzugefügt
create_listing
17. September 2026 12:37
Hinzugefügt
geocode_address
17. September 2026 12:37
Hinzugefügt
list_my_listings
17. September 2026 12:37
Hinzugefügt
delete_saved_search
17. September 2026 12:37
Hinzugefügt
list_my_saved_searches
17. September 2026 12:37
Hinzugefügt
save_search
17. September 2026 12:37
Hinzugefügt
interpret_search
17. September 2026 12:37
Hinzugefügt
get_listing
17. September 2026 12:37
Hinzugefügt
search_listings
17. September 2026 12:37
Hinzugefügt
get_registry
17. September 2026 12:37