Get Agent Properties

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://apidocs.lwolf.com/doc/spacio-api/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Spacio API MCP server": {
    "url": "https://apidocs.lwolf.com/doc/spacio-api/mcp"
  }
}

POST /getProperties

Retrieve a list of properties associated with an agent. Returns paginated results of all properties the agent manages.

Headers

apikey string Required

API key for authentication

application/x-www-form-urlencoded

Body

Request parameters for retrieving agent properties

agent_key string Required

Unique identifier for the agent
page integer

Page number for pagination (default: 1)
limit integer

Number of results per page (default: 50, max: 100)

Responses

200 application/json

Successful response with agent properties
Hide response attributes Show response attributes object
- success boolean
- data array[object]
  
  Real estate property information
  
  Hide data attributes Show data attributes object
  
  Real estate property information
  
  property_id string
  
  Unique property identifier
  
  address string
  
  Street address
  
  city string
  
  state string
  
  Two-letter state code
  
  zip string
  
  price number(double)
  
  List price in USD
  
  bedrooms integer
  
  bathrooms number
  
  Full and half bathrooms
  
  sqft integer
  
  Square footage
  
  status string
  
  Current listing status
  
  Values are active, pending, sold, expired, or withdrawn.
  
  list_date string(date)
  
  Date property was listed
  
  mls_id string
  
  MLS number
  
  property_type string
  
  Type of property
  
  Values are single_family, condo, townhouse, multi_unit, land, or commercial.
  
  lot_size string
  
  Lot size (e.g., 0.25 acres)
  
  year_built integer
- pagination object
  
  Hide pagination attributes Show pagination attributes object
  
  current_page integer
  
  total_pages integer
  
  total_results integer
400 application/json

Bad request - invalid parameters
Hide response attributes Show response attributes object
- success boolean
- error string
  
  Error code identifier
- message string
  
  Human-readable error message
401 application/json

Unauthorized - invalid API key
Hide response attributes Show response attributes object
- success boolean
- error string
  
  Error code identifier
- message string
  
  Human-readable error message
429 application/json

Rate limit exceeded
Hide response attributes Show response attributes object
- success boolean
- error string
  
  Error code identifier
- message string
  
  Human-readable error message

POST /getProperties

curl -X POST 'https://ws.spac.io/api/v1/getProperties' \
  -H 'apikey: your-api-key' \
  -d 'agent_key=agent_12345&page=1&limit=50'

import requests

headers = {'apikey': 'your-api-key'}
data = {'agent_key': 'agent_12345', 'page': 1, 'limit': 50}
response = requests.post('https://ws.spac.io/api/v1/getProperties', headers=headers, data=data)
properties = response.json()

const formData = new FormData();
formData.append('agent_key', 'agent_12345');
formData.append('page', '1');
formData.append('limit', '50');

fetch('https://ws.spac.io/api/v1/getProperties', {
  method: 'POST',
  headers: {'apikey': 'your-api-key'},
  body: formData
}).then(r => r.json()).then(console.log)

Response examples (200)

{
  "success": true,
  "data": [
    {
      "property_id": "12345",
      "address": "123 Main St",
      "city": "Los Angeles",
      "state": "CA",
      "zip": "90001",
      "price": 750000,
      "bedrooms": 3,
      "bathrooms": 2,
      "sqft": 2500,
      "status": "active",
      "list_date": "2024-01-15",
      "mls_id": "ABC123456"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5,
    "total_results": 234
  }
}

Response examples (400)

{
  "success": false,
  "error": "string",
  "message": "string"
}

Response examples (401)

{
  "success": false,
  "error": "string",
  "message": "string"
}

Response examples (429)

{
  "success": false,
  "error": "string",
  "message": "string"
}