# Fixatia MCP Server Documentation

> Fixatia provides an MCP (Model Context Protocol) server for searching European real estate auction properties.

## Server URL

https://mcp.fixatia.com/api/mcp

## Claude Desktop Configuration

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

```json
{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}
```

## Available Tools

### search_properties

Search for real estate auction properties across Europe. Filter by country, city, price, property type, ROI potential, and more.

Parameters:
- query (string, optional): Text search for property title, city, or region
- country (string, optional): Country code (es=Spain, pt=Portugal, it=Italy, fr=France, de=Germany, hr=Croatia)
- region (string, optional): Region name within the country
- city (string, optional): City name
- propertyType (string, optional): APARTMENT, HOUSE, VILLA, LAND, or COMMERCIAL
- minPrice (number, optional): Minimum auction price in EUR
- maxPrice (number, optional): Maximum auction price in EUR
- minRoi (number, optional): Minimum ROI percentage (e.g., 20 for 20%)
- bedrooms (number, optional): Minimum number of bedrooms
- maxResults (number, optional): Maximum results to return (default: 10, max: 50)
- sortBy (string, optional): newest, price-low, price-high, roi-high, or auction-soonest
- locale (string, optional): Language for titles/descriptions (default: en)

Returns: List of matching properties with basic details (id, title, fixatiaUrl, country, city, propertyType, auctionPrice, marketValue, potentialRoi, bedrooms, squareMeters, primaryImage). Use get_property for full description.

### get_property

Get full details of a specific property by its ID.

Parameters:
- id (string, required): The property ID
- locale (string, optional): Language for title/description (default: en)

Returns: Complete property details including description, images, location coordinates, renovation estimates, and auction details

### get_filter_options

Get available filter options for searches.

Parameters: None

Returns: List of countries, property types, price ranges, ROI ranges, and bedroom options

### send_property_inquiry

Send an inquiry about a property to express interest. **Requires OAuth 2.1 authentication with PKCE.**

Parameters:
- propertyId (string, required): The property ID to inquire about
- message (string, required): Inquiry message (minimum 10 characters)

Authentication: Bearer token in Authorization header (required).

Returns: Success message confirming the inquiry was sent.

## Authentication (OAuth 2.1)

This MCP server uses OAuth 2.1 with PKCE for secure authentication. The `send_property_inquiry` tool requires authentication.

### OAuth Flow

1. **Authorization Request**
   ```
   GET /api/oauth/authorize
     ?response_type=code
     &client_id=mcp-tester
     &redirect_uri=YOUR_CALLBACK_URL
     &code_challenge=SHA256_HASH
     &code_challenge_method=S256
     &scope=mcp:inquiry
   ```

2. **User logs in** via browser (redirects to login if not authenticated)

3. **Token Exchange**
   ```
   POST /api/oauth/token
   Content-Type: application/json

   {
     "grant_type": "authorization_code",
     "code": "AUTHORIZATION_CODE",
     "redirect_uri": "YOUR_CALLBACK_URL",
     "client_id": "mcp-tester",
     "code_verifier": "ORIGINAL_VERIFIER"
   }
   ```

4. **Use Token** in requests:
   ```
   Authorization: Bearer ACCESS_TOKEN
   ```

### Claude Desktop Configuration (with auth)

```json
{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

You can also generate API tokens directly at: https://fixatia.com/account (requires login)

## Protocol

JSON-RPC 2.0 over HTTP POST

## Supported Languages

en, de, fr, es, it, pt, nl, pl, el, ro, cs, hu, zh, ar, ru, ja, ko, hr

## Website

https://fixatia.com

## Contact

https://fixatia.com/contact