Coliving.com MCP Server
Search published monthly coliving listings, locations, availability, prices, and trust signals — plus personal bookings with lazy OAuth — using the Model Context Protocol.
Connection Details
| MCP Server URL | https://mcp.coliving.com/mcp |
| Transport Type | Streamable HTTP / Server-Sent Events (SSE) |
| Authentication | Hybrid: public discovery tools (no token) + lazy OAuth for get_booking / list_bookings |
| Version | 1.0.0 |
| Health | https://mcp.coliving.com/health |
| Connector Manifest | https://mcp.coliving.com/connector.json |
| Status | Production Active |
Primary Tools
Public discovery (no auth)
Search published listings with filters for location, price, room type, amenities, and community. Chain to get_listing using unique_id or slug.
Fetch enriched listing details by unique_id, slug, listing URL, or natural-language query. Internal database IDs are not exposed in responses.
Resolve natural city, country, or neighborhood queries to canonical location IDs for use in search_listings.
Retrieve supported room types, amenities, communities, and price currencies.
Get host information and trust signals for a listing or host identifier.
Compare multiple listings head-to-head on price, amenities, location, and trust signals.
Rank and recommend listings based on user preferences and constraints.
Search and view guest reviews for listings.
Check room availability for a listing over a date range.
View property-wide and room-type-level amenities.
OAuth tools (scopes mcp:use, bookings:read)
Retrieve detailed status, payments, and summary of a personal booking. Returns HTTP 401 + WWW-Authenticate when called without a Bearer token.
List, search, and filter personal stays or hosted bookings by status and timeframe. Same lazy OAuth flow as get_booking.
Input Schema Example
Example payload for search_listings:
{
"query": "quiet private room near coworking",
"location": "Lisbon, Portugal",
"location_id": 123,
"date_from": "2026-09-01",
"date_to": "2026-12-01",
"price_min": 800,
"price_max": 1800,
"price_currency": "EUR",
"room_type": "private",
"bathroom": "private",
"amenities": ["wifi", "coworking", "gym"],
"community": ["digital_nomads", "students"],
"no_security_deposit": true,
"free_cancellation": true,
"rating_min": 4,
"sort_by": "best_match",
"page": 1,
"limit": 10
}
Output Contract
search_listings
Compact search results with chain-friendly identifiers:
{
"items": [
{
"id": 12345,
"unique_id": "listing-007847",
"slug": "lisbon-coliving-home",
"title": "Private room in Lisbon coliving home",
"url": "https://coliving.com/spaces/lisbon-coliving-home",
"location": "Lisbon, Portugal",
"monthly_price_from": 950,
"currency": "EUR",
"room_types": ["private"],
"available_from": "2026-09-01",
"minimum_stay_months": 1,
"rating": 4.7,
"review_count": 28,
"trust_signals": ["verified_host", "free_cancellation"],
"summary": "Good fit for quiet remote workers..."
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 84
},
"applied_filters": {
"location_id": 123,
"location_name": "Lisbon, Portugal",
"community": ["digital_nomads"],
"community_ids": "5"
}
}
get_listing
Enriched listing payload (no internal database id):
{
"unique_id": "listing-007847",
"slug": "lisbon-coliving-home",
"title": "Private room in Lisbon coliving home",
"url": "https://coliving.com/spaces/listing-007847",
"location": "Lisbon, Portugal",
"description": "Bright private room in a calm shared home...",
"description_community": "Residents are mostly remote workers...",
"description_neighborhood": "Walking distance to cafes and transit...",
"monthly_price_from": 950,
"currency": "EUR",
"security_deposit": {
"required": false,
"amount": 0,
"type": null,
"apply_after": 0
},
"room_types": ["private"],
"room_summaries": [
{
"room_type": "private",
"available_from": "2026-09-01",
"min_price": 950,
"max_occupancy": 1
}
],
"amenities": ["High-speed WiFi", "Workspace"],
"available_from": "2026-09-01",
"minimum_stay_months": 1,
"rating": 4.7,
"review_count": 28,
"trust_signals": ["verified_host", "free_cancellation"],
"summary": "Great fit for quiet remote workers...",
"booking_rules": null,
"contract_type": "monthly",
"host": {
"is_elite_host": true,
"instant_booking": false,
"pay_at_property": false
}
}
Changelog
- Expanded public discovery tools: get_host, compare_listings, recommend_listings, search_reviews, check_availability, search_amenities.
- Hybrid OAuth for personal bookings: get_booking, list_bookings (scopes mcp:use, bookings:read).
- Public listing tools remain anonymous; OAuth is lazy (only when calling protected tools).
- Initial public read-only MCP server for listing discovery.
- Tools: search_listings, get_listing, search_locations, get_filter_options.
- Human-friendly amenity and community filter normalization.
Safety and Policy
- Listing discovery tools are read-only and anonymous. No resource mutation or booking execution is allowed.
- Personal booking tools (
get_booking,list_bookings) use lazy OAuth with scopesmcp:useandbookings:read. - Only published and active listings are indexed and searchable.
- Prices, discounts, and real-time availability may vary; agents must direct users to canonical listing URLs for final booking.
- Rate limit: 120 requests per minute per IP address.
- Request metadata (tool name, latency, IP, user-agent) is logged for reliability and security auditing. No personal data is retained.
- Security contact: security@coliving.com