Inmovilla

You can run an MCP server that connects to the Inmovilla API and exposes tools for managing properties, clients, owners, and enumerations. This server lets large language models perform real-world queries and actions against Inmovilla data in a structured, discoverable way.

How to use

You interact with the MCP server by pointing an MCP-compatible client at the running server URL. The server exposes tools to list, retrieve, create, update, and delete entities such as properties, clients, and owners. You can also fetch enumerations like property types and locations to Power natural language queries into concrete API calls. Start a chat with your MCP-enabled client to discover available tools and invoke them as needed. The server runs locally by default on port 1337, and you access its MCP endpoint at http://localhost:1337/mcp.

How to install

# 1. Clone the project repository
git clone <repository-url>
cd mcp-inmovilla

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Create environment configuration
# Create a .env file in the project root with the following values
# INMOVILLA_API_TOKEN=your_inmovilla_token_here
# OPENAI_API_KEY=your_openai_api_key_here

# 5. Start the MCP server
npm start

# The MCP server will start on port 1337 and be reachable at http://localhost:1337/mcp

Prerequisites you need to run the server locally include Node.js and npm. You should have access to an Inmovilla API token and an OpenAI API key to enable the MCP to connect to data sources and process natural language queries.

Additional configuration and notes

Environment variables required by the server are:

• INMOVILLA_API_TOKEN: your Inmovilla API token
• OPENAI_API_KEY: your OpenAI API key
• Tokens expire after three months of inactivity, so remember to rotate them as needed.

The server exposes an HTTP MCP endpoint at http://localhost:1337/mcp. You can also run the server locally via npm using npm start. When you start locally, ensure the .env file is present in the project root with the proper values.

Available tools

list_properties

List all properties and related metadata available in Inmovilla.

get_property

Fetch detailed information for a property by code or reference.

get_property_extra_info

Retrieve extra information about a property such as portal publication info and leads.

get_property_leads

Get leads associated with properties within a specified date range.

create_property

Create a new property or prospect entry in Inmovilla.

update_property

Update details for an existing property.

delete_property

Remove a property or prospect from Inmovilla.

create_client

Create a new client in Inmovilla.

get_client

Fetch client details by code.

search_clients

Search for clients matching given criteria.

update_client

Update an existing client in Inmovilla.

delete_client

Delete a client from Inmovilla.

create_owner

Create a new property owner in Inmovilla.

get_owner

Retrieve owner details by identifier.

update_owner

Update an existing owner.

delete_owner

Remove an owner from Inmovilla.

get_enum

Obtain enumeration values for categories like calidades, tipos, paises, ciudades, zonas.