๐ซ CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
๐ก Airbnb Listings Search (Streamlit + CAMEL-AI + MCP)
A Streamlit app that leverages the CAMEL-AI OWL framework and MCP (Model Context Protocol) to automatically search Airbnb listings via a custom MCP server. The app displays search parameters and returns the top 5 listings in a clean, responsive card-grid UI.
โจ Features
- Interactive UI: Sidebar for entering city, check-in/out dates and number of adults.
- Session state: Remembers your last chosen dates.
- Agent-driven search: Uses a CAMEL-AI
ChatAgent+ MCPToolkit to query Airbnb via@openbnb/mcp-server-airbnb. - Responsive cards: Displays each listing in its own styled card.

๐ Prerequisites
- Python >=3.10,<3.13
- Node.js & npm (for the MCP server plugin)
- A valid OpenAI API key set in your environment:
export OPENAI_API_KEY="your_api_key_here"
๐ ๏ธ Setup
Clone the repo
git clone https://github.com/your-org/your-repo.git cd your-repo/owl/community_usecase/Airbnb-MCPCreate a virtual environment
python -m venv venv source venv/bin/activate # macOS/Linux venv\\Scripts\\activate # WindowsInstall Python dependencies
pip install -r requirements.txt
โ๏ธ Configuration
Environment variables Create a
.envfile in the project root with:OPENAI_API_KEY=your_openai_key_hereMCP Server config Ensure
mcp_servers_config.json(next toapp.py) contains:{ "mcpServers": { "airbnb": { "command": "npx", "args": ["-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt"] } } }
๐ Running the App
From the Airbnb-MCP folder, run:
streamlit run app.py
This will launch the Streamlit UI in your browser. Use the sidebar to choose your city, dates and number of guests, then click Search Listings.
๐ง Customization
- Prompt: Edit the search prompt inside
app.pyif you want to tweak wording or number of results. - Styling: Modify the CSS in the header section of
app.pyto change colors, fonts or card layout. - Logging: Change
set_log_level("DEBUG")toINFOin production.
๐ Project Structure
Airbnb-MCP/
โโโ assets/
โ โโโ logo_camel_ai.png
โ โโโ logo_airbnb_mcp.png
โโโ mcp_servers_config.json
โโโ app.py # Main Streamlit application
โโโ requirements.txt # Python deps
โโโ .env # Env file with OPENAI_API_KEY
๐ References
Happy listing searches!