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
Use the same MCP URL for public searches, personal bookings, host tools, and authorized admin analytics. For admin access, ask “Connect my Coliving admin account” and authorize the requested access. Admin permissions and the admin:database-query OAuth scope are both required. If admin tools are missing after authorization, refresh the connector or start a new conversation. Existing connections to the root admin endpoint continue to work.
| 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.1.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.
Search public Coliving.com help articles for residents (coliving.com/help) and hosts (coliving.com/help/hosts). Omit audience when the user’s role is ambiguous; then chain to get_help_article.
Fetch one public help article by slug. Answer in natural language with complete faithful meaning from the article body, and end with a View full article link. Admin/internal articles are not available.
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
- Public helpcenter tools: search_helpcenter, get_help_article for FAQ at coliving.com/help and coliving.com/help/hosts.
- Help tools stay anonymous (no OAuth); omit audience when role is ambiguous so both residents and hosts are searchable.
- Answers use natural language with complete faithful meaning from the published article, plus View full article.
- 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