Skip to content
deveras.

MCP server

The Model Context Protocol lets an assistant use external tools. With our server, Claude or another assistant searches homes for rent or for sale on Deveras, compares them and links each listing to its page.

Server URL

URL
https://www.deveras.app/api/mcp

Streamable HTTP transport, stateless and read-only. No account or key required.

With Claude

  1. In Claude (web or desktop), open Settings and go to Connectors.

  2. Choose “Add custom connector” and paste the server URL.

  3. In a conversation, turn the connector on and ask for what you need.

With Claude Code

Terminal
claude mcp add --transport http deveras-listings https://www.deveras.app/api/mcp

With other assistants

Any client that supports MCP over HTTP works. Most accept a configuration like this one:

JSON
{
  "mcpServers": {
    "deveras-listings": {
      "url": "https://www.deveras.app/api/mcp"
    }
  }
}

If your client only supports local servers, use a bridge:

Terminal
npx -y mcp-remote https://www.deveras.app/api/mcp

With a key

The limit is the same as the API’s: 60 calls per minute without a key, 600 with one. Each tool call counts as one request. To use your key, add the Authorization header:

Terminal
claude mcp add --transport http deveras-listings https://www.deveras.app/api/mcp \
  --header "Authorization: Bearer $API_KEY"
JSON
{
  "mcpServers": {
    "deveras-listings": {
      "url": "https://www.deveras.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tools

search_listings
Searches listings with the same filters as the API: place, price, size, amenities, term.
get_listing
Returns a full listing from its id or from the address of its page.
list_places
Lists the available cities and zones, with the number of listings.
get_profile
Returns the public profile of an owner or agent.

Things to try

  • Find furnished 2-bedroom apartments in Playa del Carmen under 25,000 pesos a month.
  • Which zones have the most listings that accept pets?
  • Compare these three listings and tell me which ones have a verified property.

Attribution and privacy

The tools ask the assistant to show the “Listings from Deveras” mention and each listing’s link. As in the API, there are no contact details and no exact addresses: to get in touch, the assistant sends people to the listing page.